<div dir="auto"><div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Aug 30, 2020, 11:02 AM Joel Sherrill <<a href="mailto:joel.sherrill@gmail.com">joel.sherrill@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="auto"><div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Aug 30, 2020, 10:22 AM Gedare Bloom <<a href="mailto:gedare@rtems.org" target="_blank" rel="noreferrer">gedare@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">this is fairly mechanical. My only question is whether it is better to<br>
keep the longer names for the directory. like... timer_manager/<br>
instead of timer/ or to avoid abbreviations like rate_monotonic/<br>
instead of ratemon/<br></blockquote></div></div><div dir="auto"><br></div><div dir="auto"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"></blockquote></div></div><div dir="auto">Longer names and subdirectories please. It has worked in the Users Guide. </div><div dir="auto"><br></div><div dir="auto">We are long past 8.3 and 13 character name limits. Just avoid spaces and special characters in names and stick to all lower case.</div><div dir="auto"><br></div><div dir="auto"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
There are two decisions here: whether or not to say manager in a<br>
directory, and whether or not to abbreviate the subdirectory. There's<br>
not really a right answer, and it doesn't matter greatly, so you can<br>
just push it how it is if you prefer.<br>
<br>
-Gedare<br>
On Thu, Aug 20, 2020 at 4:19 AM Sebastian Huber<br>
<<a href="mailto:sebastian.huber@embedded-brains.de" rel="noreferrer noreferrer" target="_blank">sebastian.huber@embedded-brains.de</a>> wrote:<br>
><br>
> This patch set is a preparation to automatically generate parts of the<br>
> documentation (introduction.rst and directives.rst) in the future from<br>
> specification items.<br>
><br>
> Sebastian Huber (16):<br>
> c-user: Split up semaphore manager<br>
> c-user: Split up event manager<br>
> c-user: Split up barrier manager<br>
> c-user: Split up clock manager<br>
> c-user: Split up dual-ported memory manager<br>
> c-user: Split up interrupt manager<br>
> c-user: Split up IO manager<br>
> c-user: Split up message manager<br>
> c-user: Split up partition manager<br>
> c-user: Split up rate-monotonic manager<br>
> c-user: Split up region manager<br>
> c-user: Split up signal manager<br>
> c-user: Split up task manager<br>
> c-user: Split up timer manager<br>
> c-user: Split up user extensions manager<br>
> c-user: Split up scheduling concepts<br>
><br>
> c-user/barrier/background.rst | 68 +<br>
> .../directives.rst} | 169 +--<br>
> c-user/barrier/index.rst | 14 +<br>
> c-user/barrier/introduction.rst | 20 +<br>
> c-user/barrier/operations.rst | 60 +<br>
> c-user/clock/background.rst | 96 ++<br>
> .../directives.rst} | 238 +---<br>
> c-user/clock/index.rst | 15 +<br>
> c-user/clock/introduction.rst | 36 +<br>
> c-user/clock/operations.rst | 78 ++<br>
> c-user/dpmem/background.rst | 23 +<br>
> .../directives.rst} | 84 --<br>
> c-user/dpmem/index.rst | 16 +<br>
> c-user/dpmem/introduction.rst | 20 +<br>
> c-user/dpmem/operations.rst | 44 +<br>
> c-user/event/background.rst | 96 ++<br>
> c-user/event/directives.rst | 142 +++<br>
> c-user/event/index.rst | 15 +<br>
> c-user/event/introduction.rst | 13 +<br>
> c-user/event/operations.rst | 63 +<br>
> c-user/event_manager.rst | 309 -----<br>
> c-user/index.rst | 32 +-<br>
> c-user/intr/background.rst | 106 ++<br>
> .../directives.rst} | 251 ----<br>
> c-user/intr/index.rst | 15 +<br>
> c-user/intr/introduction.rst | 37 +<br>
> c-user/intr/operations.rst | 112 ++<br>
> c-user/io/background.rst | 162 +++<br>
> c-user/{io_manager.rst => io/directives.rst} | 215 ----<br>
> c-user/io/index.rst | 16 +<br>
> c-user/io/introduction.rst | 30 +<br>
> c-user/io/operations.rst | 26 +<br>
> c-user/message/background.rst | 91 ++<br>
> .../directives.rst} | 205 ----<br>
> c-user/message/index.rst | 16 +<br>
> c-user/message/introduction.rst | 28 +<br>
> c-user/message/operations.rst | 89 ++<br>
> c-user/part/background.rst | 50 +<br>
> .../directives.rst} | 120 --<br>
> c-user/part/index.rst | 15 +<br>
> c-user/part/introduction.rst | 19 +<br>
> c-user/part/operations.rst | 55 +<br>
> c-user/rate_monotonic_manager.rst | 1091 -----------------<br>
> c-user/ratemon/background.rst | 390 ++++++<br>
> c-user/ratemon/directives.rst | 474 +++++++<br>
> c-user/ratemon/index.rst | 16 +<br>
> c-user/ratemon/introduction.rst | 33 +<br>
> c-user/ratemon/operations.rst | 200 +++<br>
> c-user/region/background.rst | 87 ++<br>
> .../directives.rst} | 213 ----<br>
> c-user/region/index.rst | 15 +<br>
> c-user/region/introduction.rst | 29 +<br>
> c-user/region/operations.rst | 101 ++<br>
> c-user/sched/background.rst | 327 +++++<br>
> c-user/sched/directives.rst | 424 +++++++<br>
> c-user/sched/index.rst | 19 +<br>
> c-user/sched/introduction.rst | 42 +<br>
> c-user/sched/smp-schedulers.rst | 69 ++<br>
> c-user/sched/uniprocessor-schedulers.rst | 113 ++<br>
> c-user/scheduling_concepts.rst | 968 ---------------<br>
> c-user/sem/background.rst | 180 +++<br>
> .../directives.rst} | 309 -----<br>
> c-user/sem/index.rst | 18 +<br>
> c-user/sem/introduction.rst | 25 +<br>
> c-user/sem/operations.rst | 105 ++<br>
> c-user/signal/background.rst | 112 ++<br>
> c-user/signal/directives.rst | 126 ++<br>
> c-user/signal/index.rst | 15 +<br>
> c-user/signal/introduction.rst | 13 +<br>
> c-user/signal/operations.rst | 75 ++<br>
> c-user/signal_manager.rst | 322 -----<br>
> c-user/tasks/background.rst | 390 ++++++<br>
> .../directives.rst} | 625 ----------<br>
> c-user/tasks/index.rst | 15 +<br>
> c-user/tasks/introduction.rst | 50 +<br>
> c-user/tasks/operations.rst | 192 +++<br>
> c-user/timer/background.rst | 71 ++<br>
> .../directives.rst} | 180 ---<br>
> c-user/timer/index.rst | 15 +<br>
> c-user/timer/introduction.rst | 29 +<br>
> c-user/timer/operations.rst | 84 ++<br>
> .../background.rst} | 161 ---<br>
> c-user/userext/directives.rst | 143 +++<br>
> c-user/userext/index.rst | 16 +<br>
> c-user/userext/introduction.rst | 17 +<br>
> 85 files changed, 5759 insertions(+), 5449 deletions(-)<br>
> create mode 100644 c-user/barrier/background.rst<br>
> rename c-user/{barrier_manager.rst => barrier/directives.rst} (55%)<br>
> create mode 100644 c-user/barrier/index.rst<br>
> create mode 100644 c-user/barrier/introduction.rst<br>
> create mode 100644 c-user/barrier/operations.rst<br>
> create mode 100644 c-user/clock/background.rst<br>
> rename c-user/{clock_manager.rst => clock/directives.rst} (65%)<br>
> create mode 100644 c-user/clock/index.rst<br>
> create mode 100644 c-user/clock/introduction.rst<br>
> create mode 100644 c-user/clock/operations.rst<br>
> create mode 100644 c-user/dpmem/background.rst<br>
> rename c-user/{dual_ports_memory_manager.rst => dpmem/directives.rst} (64%)<br>
> create mode 100644 c-user/dpmem/index.rst<br>
> create mode 100644 c-user/dpmem/introduction.rst<br>
> create mode 100644 c-user/dpmem/operations.rst<br>
> create mode 100644 c-user/event/background.rst<br>
> create mode 100644 c-user/event/directives.rst<br>
> create mode 100644 c-user/event/index.rst<br>
> create mode 100644 c-user/event/introduction.rst<br>
> create mode 100644 c-user/event/operations.rst<br>
> delete mode 100644 c-user/event_manager.rst<br>
> create mode 100644 c-user/intr/background.rst<br>
> rename c-user/{interrupt_manager.rst => intr/directives.rst} (61%)<br>
> create mode 100644 c-user/intr/index.rst<br>
> create mode 100644 c-user/intr/introduction.rst<br>
> create mode 100644 c-user/intr/operations.rst<br>
> create mode 100644 c-user/io/background.rst<br>
> rename c-user/{io_manager.rst => io/directives.rst} (61%)<br>
> create mode 100644 c-user/io/index.rst<br>
> create mode 100644 c-user/io/introduction.rst<br>
> create mode 100644 c-user/io/operations.rst<br>
> create mode 100644 c-user/message/background.rst<br>
> rename c-user/{message_manager.rst => message/directives.rst} (69%)<br>
> create mode 100644 c-user/message/index.rst<br>
> create mode 100644 c-user/message/introduction.rst<br>
> create mode 100644 c-user/message/operations.rst<br>
> create mode 100644 c-user/part/background.rst<br>
> rename c-user/{partition_manager.rst => part/directives.rst} (70%)<br>
> create mode 100644 c-user/part/index.rst<br>
> create mode 100644 c-user/part/introduction.rst<br>
> create mode 100644 c-user/part/operations.rst<br>
> delete mode 100644 c-user/rate_monotonic_manager.rst<br>
> create mode 100644 c-user/ratemon/background.rst<br>
> create mode 100644 c-user/ratemon/directives.rst<br>
> create mode 100644 c-user/ratemon/index.rst<br>
> create mode 100644 c-user/ratemon/introduction.rst<br>
> create mode 100644 c-user/ratemon/operations.rst<br>
> create mode 100644 c-user/region/background.rst<br>
> rename c-user/{region_manager.rst => region/directives.rst} (66%)<br>
> create mode 100644 c-user/region/index.rst<br>
> create mode 100644 c-user/region/introduction.rst<br>
> create mode 100644 c-user/region/operations.rst<br>
> create mode 100644 c-user/sched/background.rst<br>
> create mode 100644 c-user/sched/directives.rst<br>
> create mode 100644 c-user/sched/index.rst<br>
> create mode 100644 c-user/sched/introduction.rst<br>
> create mode 100644 c-user/sched/smp-schedulers.rst<br>
> create mode 100644 c-user/sched/uniprocessor-schedulers.rst<br>
> delete mode 100644 c-user/scheduling_concepts.rst<br>
> create mode 100644 c-user/sem/background.rst<br>
> rename c-user/{semaphore_manager.rst => sem/directives.rst} (64%)<br>
> create mode 100644 c-user/sem/index.rst<br>
> create mode 100644 c-user/sem/introduction.rst<br>
> create mode 100644 c-user/sem/operations.rst<br>
> create mode 100644 c-user/signal/background.rst<br>
> create mode 100644 c-user/signal/directives.rst<br>
> create mode 100644 c-user/signal/index.rst<br>
> create mode 100644 c-user/signal/introduction.rst<br>
> create mode 100644 c-user/signal/operations.rst<br>
> delete mode 100644 c-user/signal_manager.rst<br>
> create mode 100644 c-user/tasks/background.rst<br>
> rename c-user/{task_manager.rst => tasks/directives.rst} (63%)<br>
> create mode 100644 c-user/tasks/index.rst<br>
> create mode 100644 c-user/tasks/introduction.rst<br>
> create mode 100644 c-user/tasks/operations.rst<br>
> create mode 100644 c-user/timer/background.rst<br>
> rename c-user/{timer_manager.rst => timer/directives.rst} (64%)<br>
> create mode 100644 c-user/timer/index.rst<br>
> create mode 100644 c-user/timer/introduction.rst<br>
> create mode 100644 c-user/timer/operations.rst<br>
> rename c-user/{user_extensions.rst => userext/background.rst} (77%)<br>
> create mode 100644 c-user/userext/directives.rst<br>
> create mode 100644 c-user/userext/index.rst<br>
> create mode 100644 c-user/userext/introduction.rst<br>
><br>
> --<br>
> 2.26.2<br>
><br>
> _______________________________________________<br>
> devel mailing list<br>
> <a href="mailto:devel@rtems.org" rel="noreferrer noreferrer" target="_blank">devel@rtems.org</a><br>
> <a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer noreferrer noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" rel="noreferrer noreferrer" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer noreferrer noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div></div></div>
</blockquote></div></div></div>