X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsrc%2Flibrary%2FREADME;fp=doc%2Fsrc%2Flibrary%2FREADME;h=a14eacfc4ee5a619a83c97db8dc203525d422690;hb=06e85b7015b6804e641424a022d0a9ceb282e280;hp=0000000000000000000000000000000000000000;hpb=f68c2ced7de2bdfc475a9282cde91a67d83325de;p=ric-plt%2Flib%2Frmr.git

diff --git a/doc/src/library/README b/doc/src/library/README
new file mode 100644
index 0000000..a14eacf
--- /dev/null
+++ b/doc/src/library/README
@@ -0,0 +1,32 @@
+
+This directory contains the main RMR library documentation 
+such as the user guide and any internal doc; all of which will
+likely share a common set of figures, glossary, and index 
+lists.  The "main" for each doc is the single .xfm file and
+all modules are contained in .im files to allow sharing between
+documents as makes sense (e.g. glossary).
+
+Illustrations are all located in the ./figures directory and
+are created as .fig files [1] which describe drawings using an 
+open ASCII format (rather than as a binary and/or propriatory
+descritption). ASCII descriptions are easily maintained as
+source code to track changes and revert when necessary.
+A Dockerfile in the tools directory can be used to build a 
+"development image" with all of the tools needed to render
+the PNG and encapsulated postscript derivations from the ASCII
+descriptions.  Use of this image is not required, but might be
+needed if a development environment doesn't provide Xfig and 
+the related tools.
+
+[1] 
+	Defacto standard tools for creating and managing .fig files:
+
+	Install Xfig on a Linux system with:
+		apt-get install xfig	(ubuntu-ish)
+		zypper install xfig		(OpenSuse)
+
+	The fig2dev tool is used to "batch" process .fig files in 
+	order to generate desired output (.eps, .png, etc.). These
+	can be installed with commands such as:
+		apt-get install fig2dev
+		zypper install transfig