Sebastian Huber sebastian.huber at
Thu Mar 13 11:44:18 UTC 2014


I tried to find a good place for the user-level profiling documentation and I 
struggled again with the Doxygen vs. Texinfo duplication.  I raised this issue 
several times over the last years, but we cannot carry on with this parallel 
structure forever.  I think it is quite hard to navigate through the HTML 
version of the user guide

and the visual appearance is not state of the art.  So we should convert the 
user guide in the long run to a modern documentation system.  I don't care if 
this is Doxygen or something else, but it must support API documentation 
generation from the sources.  You have for example

and on another page

also in Doxygen

A lot of copy and paste is involved here and writing stuff for the Texinfo is 
always a pleasure.

My proposal is still to use Doxygen simply because we already spent a huge 
amount of work for it and it has from my point of view all features we require 
(in source documentation, book style parts, graphs, formulas, message diagrams, 
HTML and PDF output), e.g.

I am open for alternatives, but we should really stop using two systems for the 

Sebastian Huber, embedded brains GmbH

Address : Dornierstr. 4, D-82178 Puchheim, Germany
Phone   : +49 89 189 47 41-16
Fax     : +49 89 189 47 41-09
E-Mail  : sebastian.huber at
PGP     : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.

More information about the devel mailing list