[PATCH 0/5] Rework glossary of terms

2020-02-27 Thread Sebastian Huber
This patch set reworks the glossary of terms so that it can be automatically generated from specification items. Sebastian Huber (5): c-user: Use four spaces per indent level c-user: Clarify return code related terms c-user: Sort glossary terms c-user: Merge parition term definitions c

Re: Glossary of Terms

2020-01-08 Thread Joel Sherrill
On Wed, Jan 8, 2020 at 12:36 PM Gedare Bloom wrote: > On Tue, Jan 7, 2020 at 11:34 PM Sebastian Huber > wrote: > > > > > > > > On 07/01/2020 17:21, Gedare Bloom wrote: > > > On Tue, Jan 7, 2020 at 2:09 AM Sebastian Huber > > > wrote: > > >> On 03/01/2020 18:16, Joel Sherrill wrote: > > >>> > >

Re: Glossary of Terms

2020-01-08 Thread Gedare Bloom
On Tue, Jan 7, 2020 at 11:34 PM Sebastian Huber wrote: > > > > On 07/01/2020 17:21, Gedare Bloom wrote: > > On Tue, Jan 7, 2020 at 2:09 AM Sebastian Huber > > wrote: > >> On 03/01/2020 18:16, Joel Sherrill wrote: > >>> > >>> On Fri, Jan 3, 2020, 10:22 AM Gedare Bloom >>>

Re: Glossary of Terms

2020-01-07 Thread Sebastian Huber
On 07/01/2020 17:21, Gedare Bloom wrote: On Tue, Jan 7, 2020 at 2:09 AM Sebastian Huber wrote: On 03/01/2020 18:16, Joel Sherrill wrote: On Fri, Jan 3, 2020, 10:22 AM Gedare Bloom mailto:ged...@rtems.org>> wrote: [...] I prefer we use a centralized glossary/document to generate indi

Re: Glossary of Terms

2020-01-07 Thread Gedare Bloom
On Tue, Jan 7, 2020 at 2:09 AM Sebastian Huber wrote: > > On 03/01/2020 18:16, Joel Sherrill wrote: > > > > > > On Fri, Jan 3, 2020, 10:22 AM Gedare Bloom > > wrote: > [...] > > I prefer we use a centralized glossary/document to generate individual > > glossaries

Re: Glossary of Terms

2020-01-07 Thread Sebastian Huber
On 03/01/2020 18:16, Joel Sherrill wrote: On Fri, Jan 3, 2020, 10:22 AM Gedare Bloom > wrote: [...] I prefer we use a centralized glossary/document to generate individual glossaries (via scripting or improving Sphinx). This will be a lot easier to maintain

Re: Glossary of Terms

2020-01-03 Thread Joel Sherrill
On Fri, Jan 3, 2020, 10:22 AM Gedare Bloom wrote: > On Fri, Jan 3, 2020 at 3:25 AM Sebastian Huber > wrote: > > > > On 03/01/2020 10:42, andrew.butterfi...@cs.tcd.ie wrote: > > > Hello all, and Happy New Year! > > > > > >> On 3 Jan 2020, at 08:10, Sebastian Huber < > sebastian.hu...@embedded-bra

Re: Glossary of Terms

2020-01-03 Thread Gedare Bloom
On Fri, Jan 3, 2020 at 3:25 AM Sebastian Huber wrote: > > On 03/01/2020 10:42, andrew.butterfi...@cs.tcd.ie wrote: > > Hello all, and Happy New Year! > > > >> On 3 Jan 2020, at 08:10, Sebastian Huber > >> wrote: > >> > >> > >> 1. Should we use one shared glossary which is included in all documen

Re: Glossary of Terms

2020-01-03 Thread Sebastian Huber
On 03/01/2020 10:42, andrew.butterfi...@cs.tcd.ie wrote: Hello all, and Happy New Year! On 3 Jan 2020, at 08:10, Sebastian Huber wrote: 1. Should we use one shared glossary which is included in all documents? 2. Do we want to use document-specific glossaries and maintain copy-and-paste en

Glossary of Terms

2020-01-03 Thread Sebastian Huber
Hello, we have currently only two glossary of terms in the RTEMS documentation set: https://docs.rtems.org/branches/master/user/glossary/index.html https://docs.rtems.org/branches/master/c-user/glossary.html We also need one in the RTEMS Software Engineering manual. Sphinx has currently some