On 10/12/2020 03:24, Chris Johns wrote:
On 9/12/20 7:20 pm, Sebastian Huber wrote:
Module: rtems-docs
Branch: master
Commit: d716c79070901195912526c6e49d43defad00bdd
Changeset:
http://git.rtems.org/rtems-docs/commit/?id=d716c79070901195912526c6e49d43defad00bdd
Author: Sebastian Huber <sebastian.hu...@embedded-brains.de>
Date: Wed Dec 2 08:17:12 2020 +0100
c-user: Generate Timer Manager documentation
The documentation is a consolidation of the comments in Doxygen markup
and the documentation sources in Sphinx markup. The documentation was
transfered to interface specification items. The documentation source
files were generated from the items by a script.
Update #3993.
---
c-user/timer/directives.rst | 992 ++++++++++++++++++++++++++----------------
c-user/timer/introduction.rst | 57 ++-
2 files changed, 674 insertions(+), 375 deletions(-)
diff --git a/c-user/timer/directives.rst b/c-user/timer/directives.rst
index d9b9877..d65f263 100644
--- a/c-user/timer/directives.rst
+++ b/c-user/timer/directives.rst
@@ -1,463 +1,729 @@
.. SPDX-License-Identifier: CC-BY-SA-4.0
+.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
.. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+.. This file is part of the RTEMS quality process and was automatically
+.. generated. If you find something that needs to be fixed or
+.. 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
+..
+.. For information on updating and regenerating please refer to:
+..
+.. https://docs.rtems.org/branches/master/eng/req/howto.html
+
We need a solution. I would prefer we resolve this before we add any more
instances of these links.
I understand that cross-document links are a problem, however, these two
links are in comments and thus don't show up in the generated documents.
A link to the bug reporting should always point to the latest
information since there is only one bug reporting procedure in the
project at a time. The link to the howto could be branch-specific.
Suggestions?
We could add a script which performs some post processing after creation
the of the release branches.
--
embedded brains GmbH
Herr Sebastian HUBER
Dornierstr. 4
82178 Puchheim
Germany
email: sebastian.hu...@embedded-brains.de
phone: +49-89-18 94 741 - 16
fax: +49-89-18 94 741 - 08
Registergericht: Amtsgericht München
Registernummer: HRB 157899
Vertretungsberechtigte Geschäftsführer: Peter Rasmussen, Thomas Dörfler
Unsere Datenschutzerklärung finden Sie hier:
https://embedded-brains.de/datenschutzerklaerung/
_______________________________________________
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel
