LUMIERA.clone/src/lib/time
Ichthyostega acb674a9d2 Project: update and clean-up Doxygen configuration
...in an attempt to clarify why numerous cross links are not generated.
In the end, this attempt was not very successful, yet I could find some breadcrumbs...

- file comments generally seem to have a problem with auto link generation;
  only fully qualified names seem to work reliably

- cross links to entities within a namespace do not work,
  if the corresponding namespace is not documented in Doxygen

- documentation for entities within anonymous namespaces
  must be explicitly enabled. Of course this makes only sense
  for detailed documentation (but we do generate detailed
  documentation here, including implementation notes)

- and the notorious problem: each file needs a valid @file comment

- the hierarchy of Markdown headings must be consistent within each
  documentation section. This entails also to individual documented
  entities. Basically, there must be a level-one heading (prefix "#"),
  otherwise all headings will just disappear...

- sometimes the doc/devel/doxygen-warnings.txt gives further clues
2021-01-24 19:35:45 +01:00
..
control-impl.hpp Switch from TR1 preveiw to the new standard headers 2014-04-03 22:42:48 +02:00
control-policy.hpp Project: update and clean-up Doxygen configuration 2021-01-24 19:35:45 +01:00
control.hpp fix typo in header include guard 2015-06-03 01:18:58 +02:00
diagnostics.hpp Doxygen Fixes (#1062) 2017-04-02 04:22:51 +02:00
digxel.hpp Global-Layer-Renaming: fix remaining textual usages and IDs in the code 2018-12-10 00:09:56 +01:00
formats.hpp Global-Layer-Renaming: adapt lots of documentation 2018-11-15 21:13:52 +01:00
grid.hpp Timehandling: choose safer representation for fractional seconds (closes #939) 2020-02-17 03:13:36 +01:00
mutation.cpp clean-up and finalise time::Mutation 2012-12-02 01:54:02 +01:00
mutation.hpp Library: replace boost::noncopyable by our own library solution 2018-03-24 05:35:13 +01:00
quantiser.cpp Doxygen: fill in missing file level headlines for the Library (timecode handling) 2016-11-07 16:22:04 +01:00
quantiser.hpp Global-Layer-Renaming: fix remaining textual usages and IDs in the code 2018-12-10 00:09:56 +01:00
time.cpp Timehandling: choose safer representation for fractional seconds (closes #939) 2020-02-17 03:13:36 +01:00
timecode.cpp Timehandling: choose safer representation for fractional seconds (closes #939) 2020-02-17 03:13:36 +01:00
timecode.hpp Doxygen: fill in missing file level headlines for the Library (timecode handling) 2016-11-07 16:22:04 +01:00
timequant.hpp Doxygen: fill in missing file level headlines for the Library (timecode handling) 2016-11-07 16:22:04 +01:00
timevalue.hpp Timehandling: choose safer representation for fractional seconds (closes #939) 2020-02-17 03:13:36 +01:00