xo-numeric/xo-unit/docs
Roland Conybeare 6fbfd065a2 xo-tokenizer: docs + error-handling improvement
drop exceptions for return-value error object
2025-06-23 23:08:12 -05:00
..
_static Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
basis-unit-class.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
basis-unit-constants.rst xo-unit: dep fixes needed for submodule builds (in examples) 2025-06-22 16:15:12 -05:00
basis-unit-reference.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
bpu-class.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
bu-store-class.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
CMakeLists.txt Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
conf.py xo-unit: dep fixes needed for submodule builds (in examples) 2025-06-22 16:15:12 -05:00
development.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
dimension-enum.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
examples.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
glossary.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
implementation.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
index.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
install.rst xo-unit: dep fixes needed for submodule builds (in examples) 2025-06-22 16:15:12 -05:00
natural-unit-class.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
quantity-class.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
quantity-factoryfunctions.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
quantity-reference.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
quantity-source-code.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
quantity-unitvars.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
README Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
scaled-unit-class.rst xo-tokenizer: docs + error-handling improvement 2025-06-23 23:08:12 -05:00
scaled-unit-constants.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
scaled-unit-reference.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
ubuntu-github-workflow.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
xquantity-class.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
xquantity-reference.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00
xquantity-source-code.rst Add 'xo-unit/' from commit 'b531e382c2' 2025-05-10 21:29:43 -05:00

build

        +-----------------------------------------------+
        | cmake                                         |
        |   CMakeLists.txt                              |
        |   $PREFIX/share/cmake/xo_macros/xo_cxx.cmake  |
        +-----------------------------------------------+
           |
           |                                                  +----------------------+
           +------------------------------------------------->| .build/docs/Doxyfile |
           |                                                  +----------------------+
           |                                                     |
           |                                        /------------/
           |                                        |
           |                                        v
           |     +---------------------------------------+    +-----------------+
           +---->| doxygen                               |--->| .build/docs/dox |
           |     |   $PREFIX/share/xo-macros/Doxyfile.in |    |   +- html/      |
           |     +---------------------------------------+    |   +- xml/       |
           |                                                  +-----------------+
           |                                                     |
           |                                        /------------/
           |                                        |
           |                                        v
           |     +---------------------------------------+    +--------------------+
           \---->| sphinx                                |--->| .build/docs/sphinx |
                 |   +- conf.py                          |    |   +- html/         |
                 |   +- _static/                         |    +--------------------+
                 |   +- *.rst                            |
                 +---------------------------------------+

files

   README            this file
   CMakeLists.txt    build entry point
   conf.py           sphinx config
   _static           static files for sphinx

map

   index.rst
   +- install.rst
   +- examples.rst
   +- unit-quantities.rst
   +- classes.rst
   +- glossary.rst
   ...

examples

.. doxygenclass:: ${c++ class name}
   :project:
   :path:
   :members:
   :protected-members:
   :private-members:
   :undoc-members:
   :member-groups:
   :members-only:
   :outline:
   :no-link:
   :allow-dot-graphs:

.. doxygendefine:: ${c preprocessor define}

.. doxygenconcept:: ${c++ concept definition}

.. doxygenenum:: ${c++ enum definition}

.. doxygenfunction:: ${c++ function name}