<div dir="ltr"><div dir="ltr"><div dir="ltr">Hi,<div><br></div><div>Thanks for your quick response. I am getting the following error:</div><div><br></div><div>richi@YouAreAmazing:~/rtems-qual$ git pull</div><div>Already up to date.</div><div>richi@YouAreAmazing:~/rtems-qual$ ./spec2doc.py </div><div>  File "./spec2doc.py", line 31</div><div>    def main() -> None:</div><div>               ^</div><div>SyntaxError: invalid syntax</div><div><br></div><div>Is it because I am running Python 2.7.17?</div><div> </div></div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Jun 10, 2020 at 9:07 PM 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 10/06/2020 16:41, Richi Dubey wrote:<br>
<br>
> Hi,<br>
><br>
> Please mark the following required changes:<br>
><br>
> 1) Add: cd rtems-qual/<br>
> After git clone and before git submodule init.<br>
><br>
> 2) I am getting the following error on running git submodule update:<br>
><br>
> richi@YouAreAmazing:~/rtems-qual$ git submodule update<br>
> Cloning into '/home/richi/rtems-qual/external/rsb'...<br>
> Cloning into '/home/richi/rtems-qual/external/rtems'...<br>
> Cloning into '/home/richi/rtems-qual/external/rtems-docs'...<br>
> Submodule path 'external/rsb': checked out<br>
> '9482a1b33b4c8552f6affa582664b4ac25f9cdf4'<br>
> error: Server does not allow request for unadvertised object<br>
> aaa638b1550e94b37df382474fe4785a6cc7d350<br>
> Fetched in submodule path 'external/rtems', but it did not contain<br>
> aaa638b1550e94b37df382474fe4785a6cc7d350. Direct fetching of that<br>
> commit failed.<br>
><br>
> I don't understand this error.<br>
<br>
Sorry, I fixed this issue. Please do a:<br>
<br>
git pull<br>
<br>
git submodule init<br>
<br>
git submodule update<br>
<br>
make env<br>
<br>
><br>
> 3) Is the space in ". env/bin/activate" intentional?<br>
<br>
Yes:<br>
<br>
<a href="https://unix.stackexchange.com/questions/114300/whats-the-meaning-of-a-dot-before-a-command-in-shell" rel="noreferrer" target="_blank">https://unix.stackexchange.com/questions/114300/whats-the-meaning-of-a-dot-before-a-command-in-shell</a><br>
<br>
><br>
> 4) I do not know how to use cite, Can i use it directly in the text field?<br>
Yes, just use :cite:`XYZ` in the text field.<br>
><br>
> 5) When I run ./spec2doc.py, I get the following error:<br>
><br>
> (env) richi@YouAreAmazing:~/rtems-qual$ ./spec2doc.py<br>
> Traceback (most recent call last):<br>
>    File "./spec2doc.py", line 41, in <module><br>
>      main()<br>
>    File "./spec2doc.py", line 34, in main<br>
>      item_cache = rtemsqual.items.ItemCache(config["spec"])<br>
>    File "/home/richi/rtems-qual/rtemsqual/items.py", line 331, in __init__<br>
>      self._load_items(config)<br>
>    File "/home/richi/rtems-qual/rtemsqual/items.py", line 403, in _load_items<br>
>      self._load_items_recursive(path, path, cache_dir)<br>
>    File "/home/richi/rtems-qual/rtemsqual/items.py", line 381, in<br>
> _load_items_recursive<br>
>      for name in os.listdir(path):<br>
> FileNotFoundError: [Errno 2] No such file or directory: 'external/rtems/spec'<br>
><br>
> Is it because I messed something up in the strongapa.yml ?<br>
><br>
> My /spec/glossary/strongapa.yml is :<br>
><br>
> SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause<br>
> copyrights:<br>
> - Copyright (C) 2020 embedded brains GmbH (<a href="http://www.embedded-brains.de" rel="noreferrer" target="_blank">http://www.embedded-brains.de</a>)<br>
> enabled-by: true<br>
> glossary-type: term<br>
> links:<br>
> - role: glossary-member<br>
>    uid: ../glossary-general<br>
> term: Strong APA<br>
> text:<br>
<br>
Maybe start with:<br>
<br>
Strong APA is a specialization of ${apa:/term}.<br>
<br>
>    In this model, on the arrival of a task, every task reachable<br>
<br>
task -> thread<br>
<br>
For the first use of thread use: ${thread:/term}<br>
<br>
>    from the newly arrived task is checked to see if an existing<br>
>    task can be shifted(or deallocated its processor) and newly<br>
space before (<br>
>    arrived task can take its place if the newly arrived task has<br>
>    a higher priority. Similar analysis is done when a task<br>
>    finishes its execution (Here task and thread have interchangeable<br>
>    defintions).<br>
>    :cite:`Cerqueira:2014:LPA`.<br>
> type: glossary<br>
><br>
><br>
><br>
> Please tell me how to resolve this error.<br>
><br>
> Thanks,<br>
> Richi.<br>
><br>
> On Mon, Jun 8, 2020 at 1:13 PM Sebastian Huber<br>
> <<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a>> wrote:<br>
>> On 07/06/2020 15:36, Sebastian Huber wrote:<br>
>><br>
>>> On 06/06/2020 15:09, Richi Dubey wrote:<br>
>>><br>
>>>> Hii,<br>
>>>><br>
>>>> Thanks for your review.<br>
>>>><br>
>>>>> The glossary is generated from specification items:<br>
>>>>><br>
>>>>> <a href="https://git.rtems.org/sebh/rtems-qual.git/tree/spec/glos/term" rel="noreferrer" target="_blank">https://git.rtems.org/sebh/rtems-qual.git/tree/spec/glos/term</a><br>
>>>>><br>
>>>>> I will work on a documentation how this works in the next days.<br>
>>>> Have you already submitted one? If yes, could you please send me the<br>
>>>> link to it. If no, Do I need to wait and learn that before sending in<br>
>>>> the new patch?<br>
>>> Yes, I sent a patch for the RTEMS Software Engineering manual:<br>
>>><br>
>>> <a href="https://lists.rtems.org/pipermail/devel/2020-June/060036.html" rel="noreferrer" target="_blank">https://lists.rtems.org/pipermail/devel/2020-June/060036.html</a><br>
>>><br>
>>> I will probably check it in tomorrow.<br>
>> I updated the documentation:<br>
>><br>
>> <a href="https://docs.rtems.org/branches/master/eng/req/howto.html#getting-started" rel="noreferrer" target="_blank">https://docs.rtems.org/branches/master/eng/req/howto.html#getting-started</a><br>
>><br>
>> Could you please try to add the new glossary terms using the method<br>
>> described in this how-to. You are some sort of a beta tester for this.<br>
>> If anything is unclear, then please complain immediately.<br>
>><br>
</blockquote></div>