129 Commits

Author SHA1 Message Date
Sebastian Huber
78889043eb refs: Update EARS references 2019-07-24 10:50:18 +02:00
Sebastian Huber
d4670fee81 refs: Add ECSS standard references
Add the ECSS standards in a separate block.  Use a custom label scheme
to make citations easier.
2019-07-23 09:40:43 +02:00
Sebastian Huber
e8592425b5 refs: Replace non-ASCII character 2019-07-23 09:40:03 +02:00
Sebastian Huber
a1d63745d9 common: Add references 2019-07-11 09:02:44 +02:00
Sebastian Huber
5a51c73130 c-user: Add RTEID and ORKID references 2019-06-21 07:44:50 +02:00
Chris Johns
1393ba0c97 waf: Fix argument bug getting extra source. 2019-03-01 13:06:11 +11:00
Chris Johns
1a051fcd7c waf: Add support for extra and excluded sources. 2019-02-28 10:22:54 +11:00
Chris Johns
62efd4c041 waf: Change --sphinx-verbose to --sphinx-options, add --sphinx-nit-pick
Provide options to manage sphinx. Make using the nit-picky mode simpler
to access.
2019-02-28 10:22:54 +11:00
Chris Johns
fb72a002a3 Add unicode support for commonly used characters like copyright.
- This change makes the copyright character easier to see on editors
  lacking good unicode rendering support, ie terminals.
2019-02-28 10:22:54 +11:00
Chris Johns
4407039110 waf: Fix building the images in the src path. 2019-02-28 10:22:54 +11:00
Chris Johns
f7384cc2e2 Use pathto() on the genindex URL to make it relative. 2019-02-15 09:40:50 +11:00
Joel Sherrill
603731cda8 common/latex.py: Remove hack for CentOS. Use Texlive per instructions. 2019-02-13 16:16:38 -06:00
Chris Johns
7b36a6b60d waf: Use the release date in the coverpage 2019-02-14 07:47:30 +11:00
Chris Johns
d721375610 waf: Fix version.py to support older versions of git. 2019-02-13 10:56:19 +11:00
Chris Johns
ec95748f03 Remove minted from the PDF builds.
This is feedback from the Sphinx project. See:

https://github.com/sphinx-doc/sphinx/issues/6021#issuecomment-460951653
2019-02-13 08:52:01 +11:00
Chris Johns
6f18d69633 Fix the version logic to make it more robust. 2019-02-07 08:46:53 +11:00
Chris Johns
a3b0a40880 Fix building with Sphinx 1.8 and later.
- Provide the pytnon.ist file for makeindex.

- Add support for xelatex building so we can switch if we want too.

Closes #3669
2019-02-06 17:02:18 +11:00
Chris Johns
2a68e9d425 Support VERSION file for releasing and deployment
- Shorten the GIT hash.
2019-02-06 17:01:48 +11:00
Sebastian Huber
d9eb36b097 Change first copyright year to 1988
The OAR copyright goes back to 1988.
2019-01-18 09:54:36 +01:00
Sebastian Huber
b5014fe0c8 Reformat and update copyright and license notices
For everything before 2015 an OAR copyright is assumed.  Later copyright
notices are based on Git commits on a best effort basis.

The copyright notices of the "RTEMS Software Engineering Handbook" and
the "RTEMS CPU Architecture Supplement" are incomplete.
2019-01-14 07:15:27 +01:00
Sebastian Huber
dec664b982 common/header: Add missing copyright notice 2019-01-11 10:39:51 +01:00
Sebastian Huber
65f54a95f1 Update header.rst
Remove trailing slashes in URLs.  Fix bug reporting URL.
2019-01-09 09:24:02 +01:00
Sebastian Huber
50fbe0d9b4 Add common header.rst to reduce copy and paste 2019-01-09 09:24:02 +01:00
Sebastian Huber
5631d58271 Remove superfluous word "Copyright"
The © symbol is sufficient.
2019-01-09 09:24:02 +01:00
Sebastian Huber
cd408b5a8b Update general copyright notice
Update year and add "and contributors".
2019-01-09 09:24:02 +01:00
Sebastian Huber
3202e319a1 Replace build date with Git hash and commit date
The usage of a build date prevents reproducible builds.
2019-01-09 09:23:58 +01:00
Christian Mauderer
a7dc08331a common/waf.py: Fix indentation.
Python 3 produces an error if indentation is mixed tabs and spaces.
2018-12-18 18:45:00 +01:00
Amar Takhar
a46b0250e5 Fix error messages when Sphinx version cannot be checked.
This is kind of a dual-check since it checks for the version while simultaneously
checking to see if Sphinx exists on the system.

Changed the error messages to be clear on the error and removed a reference to
version which cannot be set due to the check failure.

Reported by: Shashvat Jain
2018-12-05 14:31:53 -05:00
Chris Johns
21c1a4492a waf: Add support to build PlantUML and Ditaa images. 2018-11-03 16:36:32 +11:00
Amar Takhar
ab839408f9 Add a README file containing the colours used in the RTEMS logo. 2018-10-24 13:41:04 -04:00
Chris Johns
969e60e596 Update the copyright year. 2018-10-19 14:42:12 +11:00
Chris Johns
859096bd78 waf: Fix type in single html build. 2018-08-21 14:54:41 +10:00
Chris Johns
471c5e380f pdf: Revert the changes to the Latex index formatting.
I removed the '_' splitting of long labels from the index when testing
and this puts it back.
2018-08-21 13:55:03 +10:00
Chris Johns
5ce8e43506 build: Fix indexing so it works on HTML and PDF.
- Remove all genindex.rst files, these are generated and should not
  exist in our source.
- Fix the HTML templates so the local specialisation works.
- Add a index link to the sidebar for HTML.

Note, there is no TOC entry for the index in the PDF output and I
cannot figure out how to add one.

Closes #3503
2018-08-21 13:47:40 +10:00
Richard Campbell
2a0664402b RTEMS Docs: Check sphinx version
Sphinx.util.compat module was removed at Sphinx version 1.7.
Imported module was not being used.

Closes #3311.
2018-03-09 13:28:45 -06:00
Chris Johns
8e8094abc8 build: Add extra source to the sphinx build.
Updates #3177.
2017-10-12 20:25:20 -05:00
Chris Johns
5c3683e900 Improve the line spaces for directives and notes. 2017-09-14 21:50:35 +10:00
Sebastian Huber
5fc9f8bc42 common: Remove obsolete latex_use_parts
This configuration is obsolete and no longer documented:

http://www.sphinx-doc.org/en/stable/config.html#options-for-latex-output

The use of parts at the top-level results in ugly documents.
2017-08-25 14:28:27 +02:00
Chris Johns
feb68323b7 coverpage: Fix repeated entries.
Closes #2865.
2017-08-11 13:45:57 +10:00
Chris Johns
efc29ff31b Update copyright notices. 2017-08-11 13:45:52 +10:00
Chris Johns
c68461134e pdf: Update the RTEMS style to work recent Sphinx versions. 2017-08-11 13:45:47 +10:00
Chris Johns
7464b71b59 common/conf: Clean up. 2017-08-11 13:45:41 +10:00
Chris Johns
58de62d8be Revert "Add the sphinxcontrib.bibtex extension to the repo."
This reverts commit aa4f8e2e436d6c49e1524a4a3fb164b28632d894.

The contrib has too many dependencies to add into the repo.
2017-08-09 20:19:22 +10:00
Chris Johns
aa4f8e2e43 Add the sphinxcontrib.bibtex extension to the repo. 2017-08-07 21:58:52 +10:00
Chris Johns
33989b6bf6 Add Windows build details.
Actually include the quoting fix for Windows.
2017-03-27 10:31:13 +11:00
Chris Johns
02635812f6 waf: Fix linkcheck and spell commands.
Clean up and remove code that is not needed.

Fix sphinx-build quoting to work on Windows.
2017-03-27 10:27:29 +11:00
Chris Johns
e7f009e549 conf: Update the copyright year. 2017-03-21 08:41:55 +11:00
Chris Johns
228560fdf2 waf: Create the sphinx rule in one place. 2017-03-21 08:41:41 +11:00
Chris Johns
f97be09daf Use a single top level version number. 2017-03-20 12:18:53 +11:00
Chris Johns
1accbe31a5 user: Add tool commands to the user manual. 2017-03-15 15:03:41 +11:00