<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Oct 1, 2020 at 10:53 AM Sebastian Huber <<a href="mailto:sebastian.huber@embedded-brains.de">sebastian.huber@embedded-brains.de</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 29/09/2020 16:59, Sebastian Huber wrote:<br>
<br>
> This is the first generated documentation of a manager. For the PDF<br>
> output please have a look at:<br>
><br>
> <a href="https://ftp.rtems.org/pub/rtems/people/sebh/c-user.pdf" rel="noreferrer" target="_blank">https://ftp.rtems.org/pub/rtems/people/sebh/c-user.pdf</a><br>
><br>
> Please review the layout.  I changed the layout to use definition lists<br>
> instead of tables.  The benefit of definition lists is that the layout<br>
> of longer text paragraphs is much nicer compared to tables (at least for<br>
> the PDF output).<br></blockquote><div><br></div><div>I'm not opposed to changing the all caps shorthand name to the real name.</div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
Two new layout variants are available. This one has the description <br>
after the calling sequence:<br>
<br>
<a href="https://ftp.rtems.org/pub/rtems/people/sebh/c-user-3.pdf" rel="noreferrer" target="_blank">https://ftp.rtems.org/pub/rtems/people/sebh/c-user-3.pdf</a><br>
<br>
This one has calling sequence, parameters, description:<br>
<br>
<a href="https://ftp.rtems.org/pub/rtems/people/sebh/c-user-4.pdf" rel="noreferrer" target="_blank">https://ftp.rtems.org/pub/rtems/people/sebh/c-user-4.pdf</a></blockquote><div><br></div><div>This is preferable. We should try to follow the POSIX ordering.</div><div><br></div><div>It looks like the ordering of the methods has changed. It was generally</div><div>very carefully chosen. Why would close be the first service listed?</div><div><br></div><div>The order generally reflects the usage -- open before close, create</div><div>before delete. etc. </div><div><br></div><div>The order shouldn't change.</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
<br>
Here is the HTML output:<br>
<br>
<a href="https://ftp.rtems.org/pub/rtems/people/sebh/c-user/html/index.html" rel="noreferrer" target="_blank">https://ftp.rtems.org/pub/rtems/people/sebh/c-user/html/index.html</a><br>
<br>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div></div>