11 Commits

Author SHA1 Message Date
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