14 Commits
Author SHA1 Message Date
Bill Mills c5389ea380 ReadTheDocs: eliminate the files no longer needed.
We now use the "git checkout command" in the RTDs project settings.
This means we will use the .readthedocs.yaml and conf.py from the
openamp-docs repo and no longer need these files in the sub-modules.

See openamp-docs/.readthedocs.yaml for details.

Signed-off-by: Bill Mills <bill.mills@linaro.org>
2026-06-02 14:07:52 +02:00
Sipke Vriend c65f40afd6 doxygen: remove obsolete options
PERL_PATH and MSCGEN_PATH are no longer used, so remove from Doxyfile.in
to avoid warning
warning Tag 'PERL_PATH' ... has become obsolete.
warning: Tag 'MSCGEN_PATH' ... has become obsolete.

Signed-off-by: Sipke Vriend <sipke@direktembedded.com>
2026-03-31 09:00:50 +02:00
Sipke Vriend 3d29e3b0fc doc: add maintainers file to doxygen document generation
to provide access to maintainers information for this repository add it
to the input source files.

Signed-off-by: Sipke Vriend <sipke@direktembedded.com>
2026-03-31 09:00:50 +02:00
Sipke Vriend c86f48f19a doxygen: tell doxygen to generate xml
in order to use the sphinx breathe plugin in the OpenAMP/openamp-docs
repository we need to enable xml generation

Signed-off-by: Sipke Vriend <sipke@direktembedded.com>
2025-05-19 09:24:50 +02:00
Sipke Vriend f2990d20da doxygen: tell doxygen to generate tag file for external linking
To allow for external links to doxygen generated content, tell doxygen
to build tags, so the tag file can be used for cross referencing
doxygen generated data.

Signed-off-by: Sipke Vriend <sipke@direktembedded.com>
2025-05-19 09:24:50 +02:00
Bill Mills 51719ef1da docs: update the readthedocs integration for PRs in this repo
Upstream Read The Docs has tightened up the schema checking and this broke
what we were doing for PRs.

A good number of things were tried but the best compromise is to:
* supply a dummy sphinx config file in this repo
* override the default build command to use the openamp-docs dir

Also:
* add more documentation about what is going on
* lock to html only format.  PRs only do html anyway but make sure

Signed-off-by: Bill Mills <bill.mills@linaro.org>
2025-02-14 16:43:20 +01:00
Arnaud Pouliquen 9fe00e0582 Remove vim editor configuration in files
Remove all remaining instances of "# vim: ..." in files.
This vim settings were part of the initial commit. But no reason
to keep them.

Signed-off-by: Arnaud Pouliquen <arnaud.pouliquen@foss.st.com>
2023-10-17 09:02:59 +02:00
Bill Mills d7c605c272 Docs: style doxygen when built as part of OpenAMP docs
Detect when we are a submodule of OpenAMP-docs.
If so use the top level's Doxyfile overrides on top of our Doxyfile.
If not, no change.

Signed-off-by: Bill Mills <bill.mills@linaro.org>
2023-10-10 19:05:49 +02:00
Wendy Liang d79624bfad doc: also generate latex files
Besides generating the html files, also generate the latex files.

Signed-off-by: Wendy Liang <jliang@xilinx.com>
2016-04-25 11:05:22 -07:00
Wendy Liang 09afa441c7 doc: strip the project path in the file names
Use STRIP_FROM_PATH to strip the project path in the file names.

Signed-off-by: Wendy Liang <jliang@xilinx.com>
2016-04-25 10:59:09 -07:00
Wendy Liang b19a69cab5 Doxygen: use libmetal as project name
Hardcoded the project name in libmetal doxygen to libmetal

Signed-off-by: Wendy Liang <jliang@xilinx.com>
2016-04-22 17:57:54 -07:00
Wendy Liang 2651b267ce doxygen: Expand list of modules
Add the following to the modules list in doxygen:
* device
* io
* list
* mutex
* shmem
* sys

Signed-off-by: Wendy Liang <jliang@xilinx.com>
2016-04-19 15:41:54 -07:00
Wendy Liang 7df7956553 doxygen: Use README as mainpage
Signed-off-by: Wendy Liang <jliang@xilinx.com>
2016-04-19 15:41:54 -07:00
Cyril Chemparathy 7bda1db4a9 Initial commit
This commit sets up the basic infrastructure necessary for the project:

  - Documentation generation and installation using Doxygen.

  - Configuration options and template headers with option substitution.

  - Self-tests using cmake add_test() commands.

  - Configurable selection, build, and install of static and shared
    libraries, as well as handling for dependencies (libsysfs,
    libhugetlbfs) for linux builds.

  - Cross compilation for bare-metal and Linux target platforms.

  - Basic infrastructure for initialization, logging, etc. and
    separation between common, and system specific code.
2016-01-06 09:09:40 -08:00