[PATCH] Improve file header comment in generated files

[Chris Johns]

On 21/1/21 10:23 am, Joel Sherrill wrote:
> On Wed, Jan 20, 2021 at 5:01 PM Chris Johns <chrisj at rtems.org
> <mailto:chrisj at rtems.org>> wrote:
> 
>     On 19/1/21 5:01 pm, Sebastian Huber wrote:
>     > diff --git a/c-user/config/bdbuf.rst b/c-user/config/bdbuf.rst
>     > index 06399e0..5a3360f 100644
>     > --- a/c-user/config/bdbuf.rst
>     > +++ b/c-user/config/bdbuf.rst
>     > @@ -8,11 +8,15 @@
>     >  .. worded better please post a report or patch to an RTEMS mailing list
>     >  .. or raise a bug report:
>     >  ..
>     > -.. https://docs.rtems.org/branches/master/user/support/bugs.html
>     <https://docs.rtems.org/branches/master/user/support/bugs.html>
>     > +.. https://www.rtems.org/support/bugs.html
>     <https://www.rtems.org/support/bugs.html>
>     >  ..
>     > -.. For information on updating and regenerating please refer to:
>     > +.. For information on updating and regenerating please refer to the How-To
>     > +.. section in the Software Requirements Engineering chapter of the
>     > +.. RTEMS Software Engineering manual.  The manual is provided as a part of
>     > +.. a release.  For development sources please refer to the online
>     > +.. documentation at:
>     >  ..
>     > -.. https://docs.rtems.org/branches/master/eng/req/howto.html
>     <https://docs.rtems.org/branches/master/eng/req/howto.html>
>     > +.. https://docs.rtems.org <https://docs.rtems.org>
>     > 
>     >  .. Generated from spec:/acfg/if/group-bdbuf
>     > 
> 
>     This looks good. We need the bugs.html page working.
> 
>     Joel, what is the status of that page? 
> 
> I answered on another thread. This would need to be an Apache redirect to
> where we want. It is an Amar issue AFAIK. I can't do anything about it.

Amar does not track the devel email so I suggest you raise a ticket and then
directly ping him.

> Even if we want to change the URL going forward (which would be good),
> this would still need to work.

Yes so does the change go in and then the link gets left hanging until Amar or I
clean it up or does the change become dependent on the server side of things
getting sorted and so there is some focus placed on this area of the project?

> FWIW I have no recollection of what was on this page.actually had on it
> or where it directed to on the old setup. I can't find it on the Wayback Machine.

I cannot find a historical support path in the old web site. There is this page
from 2003 ...

https://web.archive.org/web/20030618104931/http://www.rtems.org/bugs.html

Maybe the link is changed to ...

https://www.rtems.org/bugs.html

Chris