<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Nov 6, 2017 at 6:56 PM, Chris Johns <span dir="ltr"><<a href="mailto:chrisj@rtems.org" target="_blank">chrisj@rtems.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 06/11/2017 22:56, Sebastian Huber wrote:<br>
> This makes it easier to find the documentation for a given configuration<br>
> option.<br>
<br>
</span>Can you please generate the HTML and PDF so we can review what this looks like?<br>
<br>
I have figured out indexes and I will sweep over the docs adding them soon. The<br>
CONFIGURE_.... then can be added as indexes which puts them a few of clicks away<br>
from the top level so I am not sure about this change. I tend to like the<br>
English and not the exact constants.<br>
<br>
The current labels could do with a clean up. There is way more info in the<br>
headings than needs to be there. The docs clearly show the levels in the HTML<br>
format and while not as clear in the PDF is it OK. This means for example:<br>
<br>
Instantiate Classic API Initialization Task Table =><br>
Instantiate Classic Initialization Task Table<br>
<br>
Specifying Classic API Initialization Task Entry Point =><br>
  Classic Initialization Task Entry Point<br>
<br>
Specify Maximum POSIX API Threads => Maximum POSIX Threads<br>
<span class=""><br>
Classic API Initialization Tasks Table Configuration =><br>
</span>Classic Initialization Tasks Table Configuration<br></blockquote><div><br></div><div>+1 </div><div><br></div><div>Another option -- if it fits -- is to do something like the directives</div><div>and UNIX man pages. "cmd - English phrase". The risk here</div><div>is that this may be too long. </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
etc.<br>
<span class="HOEnZb"><font color="#888888"><br>
Chris<br>
</font></span><div class="HOEnZb"><div class="h5">______________________________<wbr>_________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/<wbr>mailman/listinfo/devel</a><br>
</div></div></blockquote></div><br></div></div>