Talk:Task:Publishing API docs

(gtk-doc, doxygen...: new section)
 
Line 8: Line 8:
* Possibly manual compiler switches for compiling and linking
* Possibly manual compiler switches for compiling and linking
* Various gotchas, initialization order, other funky stuff
* Various gotchas, initialization order, other funky stuff
 +
 +
== gtk-doc, doxygen... ==
 +
 +
One problem is that some packages use gtk-doc while others use doxygen. --[[User:qgil|qgil]] 07:38, 21 July 2008 (UTC)

Latest revision as of 07:38, 21 July 2008

[edit] High level library docs

Moved from Documentation wishlist

The current documents are mostly API-oriented. It would be useful to have an overview of all the basic libraries one can (and should) link against (gtk, hildon, osso, gstreamer etc). The doc should explain every library in a few paragraphs:

  • What the library is, what it does, why do you need it
  • What Autoconf/Automake magic is needed to use it
  • Possibly manual compiler switches for compiling and linking
  • Various gotchas, initialization order, other funky stuff

[edit] gtk-doc, doxygen...

One problem is that some packages use gtk-doc while others use doxygen. --qgil 07:38, 21 July 2008 (UTC)