X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=doc%2Fsrc%2Frtd%2FREADME;h=b1941fa492dcdbe13c301dfe23b6c89d2a222ee9;hb=fe6a856df463a0d7e06b28aac8590ac9c0f08dd6;hp=0adb444f48139c4ec24eaf60db15ca76a4f51ccb;hpb=d961525e9eb23e3dee4a16960a1772782c3b8b36;p=ric-plt%2Flib%2Frmr.git diff --git a/doc/src/rtd/README b/doc/src/rtd/README index 0adb444..b1941fa 100644 --- a/doc/src/rtd/README +++ b/doc/src/rtd/README @@ -1,9 +1,10 @@ -This directory contains source for the project mandated "read the docs" -.rst documentation. The Makefile will both build the doc from the source -here and "install" it into the docs directory at the repo root. While -it is not good practice, the generated .rst files must be checked into -the repo and committed with changes to the source. +This directory contains source for the project mandated "read the +docs" .rst documentation. If the "tfm" tool is available, the +Makefile will both build the doc from the source here and "install" it +into the docs directory at the repo root. Then the generated .rst +files must be checked into the repo and committed with changes to the +source (maybe not the best practice). The command 'make all' should be all that is needed to build the rtd documentation. Follow that with 'make publish' to actually move @@ -11,14 +12,14 @@ the .rst files into the docs directory at the root; only the changed files are moved. Adding A New Man Page -WHen a new manual page is added to the source (../man), it must be +When a new manual page is added to the source (../man), it must be added to the list in the user's guide source in this directory. Rationale Documentation is just code, and by maintaining the documentation as source is is possible to generate various forms of output with a single make. While it is possible to convert X to Y, a true document -composition language is far better at geneating readable Postscript +composition language is far better at generating readable Postscript output with embedded figures as well as text and tables. CAUTION: