<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Jan 13, 2021 at 6:21 PM Chris Johns <<a href="mailto:chrisj@rtems.org">chrisj@rtems.org</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 13/1/21 9:45 pm, Sebastian Huber wrote:<br>
> On 11/12/2020 01:35, Chris Johns wrote:<br>
> <br>
>> On 10/12/20 4:41 pm, Sebastian Huber wrote:<br>
>>> On 10/12/2020 03:24, Chris Johns wrote:<br>
>>><br>
>>>> On 9/12/20 7:20 pm, Sebastian Huber wrote:<br>
>>>>> Module:    rtems-docs<br>
>>>>> Branch:    master<br>
>>>>> Commit:    d716c79070901195912526c6e49d43defad00bdd<br>
>>>>> Changeset:<br>
>>>>> <a href="http://git.rtems.org/rtems-docs/commit/?id=d716c79070901195912526c6e49d43defad00bdd" rel="noreferrer" target="_blank">http://git.rtems.org/rtems-docs/commit/?id=d716c79070901195912526c6e49d43defad00bdd</a><br>
>>>>><br>
>>>>><br>
>>>>><br>
>>>>> Author:    Sebastian Huber<<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a>><br>
>>>>> Date:      Wed Dec  2 08:17:12 2020 +0100<br>
>>>>><br>
>>>>> c-user: Generate Timer Manager documentation<br>
>>>>><br>
>>>>> The documentation is a consolidation of the comments in Doxygen markup<br>
>>>>> and the documentation sources in Sphinx markup.  The documentation was<br>
>>>>> transfered to interface specification items.  The documentation source<br>
>>>>> files were generated from the items by a script.<br>
>>>>><br>
>>>>> Update #3993.<br>
>>>>><br>
>>>>> ---<br>
>>>>><br>
>>>>>    c-user/timer/directives.rst   | 992<br>
>>>>> ++++++++++++++++++++++++++----------------<br>
>>>>>    c-user/timer/introduction.rst |  57 ++-<br>
>>>>>    2 files changed, 674 insertions(+), 375 deletions(-)<br>
>>>>><br>
>>>>> diff --git a/c-user/timer/directives.rst b/c-user/timer/directives.rst<br>
>>>>> index d9b9877..d65f263 100644<br>
>>>>> --- a/c-user/timer/directives.rst<br>
>>>>> +++ b/c-user/timer/directives.rst<br>
>>>>> @@ -1,463 +1,729 @@<br>
>>>>>    .. SPDX-License-Identifier: CC-BY-SA-4.0<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>
>>>>>    .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)<br>
>>>>>    +.. This file is part of the RTEMS quality process and was automatically<br>
>>>>> +.. generated.  If you find something that needs to be fixed or<br>
>>>>> +.. worded better please post a report or patch to an RTEMS mailing list<br>
>>>>> +.. or raise a bug report:<br>
>>>>> +..<br>
>>>>> +..<a href="https://docs.rtems.org/branches/master/user/support/bugs.html" rel="noreferrer" target="_blank">https://docs.rtems.org/branches/master/user/support/bugs.html</a><br>
>>>>> +..<br>
>>>>> +.. For information on updating and regenerating please refer to:<br>
>>>>> +..<br>
>>>>> +..<a href="https://docs.rtems.org/branches/master/eng/req/howto.html" rel="noreferrer" target="_blank">https://docs.rtems.org/branches/master/eng/req/howto.html</a><br>
>>>>> +<br>
>>>> We need a solution. I would prefer we resolve this before we add any more<br>
>>>> instances of these links.<br>
>>> I understand that cross-document links are a problem, however, these two links<br>
>>> are in comments and thus don't show up in the generated documents. A link to the<br>
>>> bug reporting should always point to the latest information since there is only<br>
>>> one bug reporting procedure in the project at a time. The link to the howto<br>
>>> could be branch-specific.<br>
>> Yes I agree. My concern is a change in how master is hosted breaks the links.<br>
>><br>
>>>> Suggestions?<br>
>>> We could add a script which performs some post processing after creation the of<br>
>>> the release branches.<br>
>> What about ....<br>
>><br>
>> <a href="https://www.rtems.org/support/bugs.html" rel="noreferrer" target="_blank">https://www.rtems.org/support/bugs.html</a><br>
>><br>
>> If a redirect can be set up we could insulate these links from the location they<br>
>> are.<br>
> <br>
> I would like to fix the header. What should I do now with the link<br>
> <br>
> <a href="https://docs.rtems.org/branches/master/user/support/bugs.html" rel="noreferrer" target="_blank">https://docs.rtems.org/branches/master/user/support/bugs.html</a><br>
> <br>
> ?<br>
> <br>
> From an RTEMS Project point of view it would be good to have a permanent link to<br>
> the bug reporting page.<br>
<br>
Yes. Joel is one for this as he knows Drupal.<br>
<br></blockquote><div><br></div><div>It would be nice to set up something indirect, like mentioned above, or maybe <a href="https://bugs.rtems.org">https://bugs.rtems.org</a></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Chris<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></blockquote></div></div>