<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:26 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 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>
>>>> 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>
>>>>    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></blockquote><div><br></div><div>I can add a page in Drupal with a forced name but am not sure about the support/ part</div><div>and it looks like Drupal redirect pages are an optional feature which is not installed and</div><div>the module may be unsupported. </div><div><br></div><div>When we did this type of thing before, it was always with Apache itself. That's how we</div><div>had <a href="http://rtems.org/PRnnnn">rtems.org/PRnnnn</a> redirect to a specific ticket like GCC has. AFAIK This feature </div><div>was not deemed worthy of inclusion back when the hosting was moved.</div><div><br></div><div>Anyway URL rewriting in Apache is simple with a regular expression in a configuraton</div><div>file. </div><div> </div><div><a href="https://httpd.apache.org/docs/2.4/rewrite/remapping.html">https://httpd.apache.org/docs/2.4/rewrite/remapping.html</a><br></div><div><br></div><div>All you need to do is convince the admin to add a rule.</div><div><br></div><div>Something like <a href="http://rtems.org/bugs/[567]">rtems.org/bugs/[567]</a> might also be nice and shorter. Let bugs with</div><div>no number go to <a href="https://devel.rtems.org/wiki/NewTicket">https://devel.rtems.org/wiki/NewTicket</a> which is where "Report a Bug"</div><div>is directed on the right hand side of <a href="http://rtems.org">rtems.org</a>.</div><div><br></div><div>Personally I like using the Apache rewrite engine to make shorter easier to </div><div>remember URLs.</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><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 the bug reporting page.<br>
<br>
-- <br>
embedded brains GmbH<br>
Herr Sebastian HUBER<br>
Dornierstr. 4<br>
82178 Puchheim<br>
Germany<br>
email: <a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a><br>
phone: +49-89-18 94 741 - 16<br>
fax:   +49-89-18 94 741 - 08<br>
<br>
Registergericht: Amtsgericht München<br>
Registernummer: HRB 157899<br>
Vertretungsberechtigte Geschäftsführer: Peter Rasmussen, Thomas Dörfler<br>
Unsere Datenschutzerklärung finden Sie hier:<br>
<a href="https://embedded-brains.de/datenschutzerklaerung/" rel="noreferrer" target="_blank">https://embedded-brains.de/datenschutzerklaerung/</a><br>
<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>