Mailinglist Archive: zypp-devel (59 mails)

[Michael Matz <matz@xxxxxxx>]

Hi,

On Wed, 19 Nov 2008, Michael Schroeder wrote:

> > URL: http://svn.opensuse.org/viewcvs/zypp?rev=11712&view=rev
> > Log:
> > lets try to make this a documented project
> >
> > Added:
> >     trunk/sat-solver/doc/CMakeLists.txt
> >     trunk/sat-solver/doc/autodoc/
> >     trunk/sat-solver/doc/autodoc/CMakeLists.txt
> >     trunk/sat-solver/doc/autodoc/Doxyfile.cmake
> >     trunk/sat-solver/doc/autoinclude/
> >     trunk/sat-solver/doc/autoinclude/History.doc
> >     trunk/sat-solver/doc/autoinclude/Mainpage.doc
> > Modified:
> >     trunk/sat-solver/CMakeLists.txt
>
> Eeek, doxygen in the satsolver? I'm not sure if I really like that. This 
> is not libzypp, after all.

As long as no sources are annotated with those terrible doxygen comments I 
have only mild reservations about this.  I.e. using doxygen to write prosa 
text and easily generate html docu is fine by me, I guess, though I don't 
love it.

> I prefer standard nroff man pages.

Indeed.  Or well, for editability I actually prefer .pod files generated 
into nroff.  That would mean two means to generate docu (doxygen and 
this), though, which also is less than ideal.

Anyway, important for my health is only that the sources are not annotated 
by doxygen comments.


Ciao,
Michael.
-- 
To unsubscribe, e-mail: zypp-devel+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: zypp-devel+help@xxxxxxxxxxxx