[zypp-devel] Re: [zypp-commit] r11712 - in /trunk/sat-solver: ./ doc/ doc/autodoc/ doc/autoinclude/
On Wed, Nov 19, 2008 at 08:55:08AM -0000, dmacvicar@svn.opensuse.org wrote:
Author: dmacvicar Date: Wed Nov 19 09:55:07 2008 New Revision: 11712
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. I prefer standard nroff man pages. Cheers, Michael. -- Michael Schroeder mls@suse.de SUSE LINUX Products GmbH, GF Markus Rex, HRB 16746 AG Nuernberg main(_){while(_=~getchar())putchar(~_-1/(~(_|32)/13*2-11)*13);} -- To unsubscribe, e-mail: zypp-devel+unsubscribe@opensuse.org For additional commands, e-mail: zypp-devel+help@opensuse.org
Michael Schroeder wrote:
Eeek, doxygen in the satsolver? I'm not sure if I really like that. This is not libzypp, after all.
I prefer standard nroff man pages.
Cheers, Michael They can also be generated:
http://www.stack.nl/~dimitri/doxygen/output.html -- To unsubscribe, e-mail: zypp-devel+unsubscribe@opensuse.org For additional commands, e-mail: zypp-devel+help@opensuse.org
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@opensuse.org For additional commands, e-mail: zypp-devel+help@opensuse.org
participants (3)
-
Duncan Mac-Vicar Prett -
Michael Matz -
Michael Schroeder