Reference section of documentation improved

This commit is contained in:
Mateusz Pusz
2020-05-13 15:36:33 +02:00
parent e58c8054bc
commit e7ac6bd563
14 changed files with 123 additions and 55 deletions

View File

@@ -98,9 +98,19 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
"${CMAKE_CURRENT_SOURCE_DIR}/introduction.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/quick_start.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/concepts.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/customization_points.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/functions.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/metafunctions.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/systems.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/dimensions.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/prefixes.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/quantity.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/units.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/utilities.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/utilities/basic_fixed_string.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/utilities/basic_symbol_text.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/reference/types/utilities/ratio.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/use_cases.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/use_cases/custom_representation_types.rst"
"${CMAKE_CURRENT_SOURCE_DIR}/use_cases/extensions.rst"

View File

@@ -38,6 +38,8 @@ with a permissive `MIT license <https://github.com/mpusz/units/blob/master/LICEN
reference/concepts
reference/types
reference/functions
reference/metafunctions
reference/customization_points
reference/systems
.. toctree::

View File

@@ -0,0 +1,7 @@
Customization Points
====================
.. doxygenvariable:: units::treat_as_floating_point
.. doxygenstruct:: units::quantity_values
:members:

View File

@@ -1,15 +1,19 @@
.. note::
All names defined in this chapter reside in the :any:`units` namespace unless specified otherwise.
Functions
=========
.. doxygenfunction:: quantity_cast
Casting and Converions
----------------------
.. doxygenfunction:: units::quantity_cast
Math
----
Metafunctions
=============
.. doxygenfunction:: units::pow
.. doxygentypedef:: dimension_unit
.. doxygenfunction:: units::sqrt
.. doxygenfunction:: units::abs
.. doxygenfunction:: units::epsilon

View File

@@ -0,0 +1,4 @@
Metafunctions
=============
.. doxygentypedef:: dimension_unit

View File

@@ -1,51 +1,11 @@
.. note::
All names defined in this chapter reside in the :any:`units` namespace unless specified otherwise.
Types
=====
Quantity
--------
.. toctree::
:maxdepth: 1
.. doxygenclass:: units::quantity
:members:
..
:undoc-members:
Dimension
---------
.. doxygenstruct:: units::base_dimension
:members:
.. doxygenstruct:: units::derived_dimension
:members:
Unit
----
.. doxygenstruct:: units::scaled_unit
:members:
.. doxygenstruct:: units::unit
:members:
.. doxygenstruct:: units::named_unit
:members:
.. doxygenstruct:: units::named_scaled_unit
:members:
.. doxygenstruct:: units::prefixed_unit
:members:
.. doxygenstruct:: units::deduced_unit
:members:
Ratio
-----
.. doxygenstruct:: units::ratio
:members:
types/quantity
types/dimensions
types/units
types/prefixes
types/utilities

View File

@@ -0,0 +1,11 @@
Dimensions
==========
.. doxygenstruct:: units::base_dimension
:members:
.. doxygenstruct:: units::exp
:members:
.. doxygenstruct:: units::derived_dimension
:members:

View File

@@ -0,0 +1,11 @@
Prefixes
========
.. doxygenstruct:: units::prefix_family
:members:
.. doxygenstruct:: units::no_prefix
:members:
.. doxygenstruct:: units::prefix
:members:

View File

@@ -0,0 +1,6 @@
Quantity
========
.. doxygenclass:: units::quantity
:members:
:undoc-members:

View File

@@ -0,0 +1,26 @@
Units
=====
.. doxygenstruct:: units::scaled_unit
:members:
.. doxygenstruct:: units::unit
:members:
.. doxygenstruct:: units::named_unit
:members:
.. doxygenstruct:: units::named_scaled_unit
:members:
.. doxygenstruct:: units::prefixed_unit
:members:
.. doxygenstruct:: units::deduced_unit
:members:
.. doxygenstruct:: units::alias_unit
:members:
.. doxygenstruct:: units::prefixed_alias_unit
:members:

View File

@@ -0,0 +1,9 @@
Utilities
=========
.. toctree::
:maxdepth: 1
utilities/ratio
utilities/basic_symbol_text
utilities/basic_fixed_string

View File

@@ -0,0 +1,6 @@
basic_fixed_string
==================
.. doxygenstruct:: units::basic_fixed_string
:members:
:undoc-members:

View File

@@ -0,0 +1,6 @@
basic_symbol_text
=================
.. doxygenstruct:: units::basic_symbol_text
:members:
:undoc-members:

View File

@@ -0,0 +1,6 @@
ratio
=====
.. doxygenstruct:: units::ratio
:members:
:undoc-members: