blob: d8f0a8bd58d3d85be6afc7a8ee9938e7131fed2a [file] [log] [blame]
Ashwin Sridharanfd9cc7a2019-04-03 16:47:02 -04001
E. Scott Daniels392168d2019-11-06 15:12:38 -05002Documentation for RMR.
Ashwin Sridharanfd9cc7a2019-04-03 16:47:02 -04003
E. Scott Daniels392168d2019-11-06 15:12:38 -05004Most (all?) documentation for RMR is built from source ({X)fm, or other text
5formatter source, not the RMR code) rather than hand editing the output
Ashwin Sridharanfd9cc7a2019-04-03 16:47:02 -04006(markdown/rst) files. This allows for more control over the output, a wider
7variety of output types, and (most importantly) the generation of multiple
8output from the same source (e.g. man pages can be rendered in troff which
9the man command required, and also rendered as .rst or .md files which some
10wikis prefer, and as PDF which can be easily distributed).
11
12Thus, there is a source file below this directory which has the document
E. Scott Daniels392168d2019-11-06 15:12:38 -050013source. Directories are as follows:
14
15 man Manual pages included with the development package
16
17 rtd Source to generate the .rst files for the "read the docs"
18 repo scraper.