[gst-devel] online api docs

[Stefan Kost]

Jan Schmidt schrieb:
> On Thu, 2009-01-29 at 17:57 +0200, Stefan Kost wrote:
>
>   
>>>   
>>>       
>> They are uploaded wrongly. It needs a gtkdoc-rebase --online and then
>> uploading.
>>
>> Stefan
>>
>>     
>
> Hmmm. How does that look in terms of actual commands to execute? Can we
> make the gtkdoc-rebase execution part of the upload make target?
>
> J.
>   
Uploading is done in common/upload.mak

What it needs is:

cd gstreamer/docs/gst
gtkdoc-rebase --online --html-dir=html
cd gstreamer/docs/libs
gtkdoc-rebase --online --html-dir=html

...

Need to think a bit how to integrate this, as upload.mak is used for
normal docs too. The online rebasing against glib/gtk is broken on e.g.
ubuntu (bug filed) and on most systems you would need to patch
/usr/share/gtk-doc/html/glib/index.sgml
like this (I just committed the online url stuff for glib/gtk docs).
+ <ONLINE href="http://library.gnome.org/devel/glib/unstable/">
  <ANCHOR id="glib-building" href="glib/glib-building.html">

Should I for now go thru all the docs and do one manual round (rebase +
call make upload)?

Stefan