On 29/09/2020 16:59, Sebastian Huber wrote:

This is the first generated documentation of a manager. For the PDF
output please have a look at:

https://ftp.rtems.org/pub/rtems/people/sebh/c-user.pdf

Please review the layout.  I changed the layout to use definition lists
instead of tables.  The benefit of definition lists is that the layout
of longer text paragraphs is much nicer compared to tables (at least for
the PDF output).

Sebastian Huber (1):
   c-user: Generate I/O Manager documentation

  c-user/io/directives.rst   | 550 ++++++++++++++++++-------------------
  c-user/io/introduction.rst |  37 ++-
  2 files changed, 295 insertions(+), 292 deletions(-)

The vertical spacing of the definition lists was a bit odd. In the Latex enumitem package documentation there is a note that nested definition lists with the "nextline" style are not supported.

I changed the formatting to use the .. rubric directive. Please have a look at this PDF:

https://ftp.rtems.org/pub/rtems/people/sebh/c-user-2.pdf

Only the IO Manager and Event Manager chapters use the new formatting.

_______________________________________________
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel

Reply via email to