[gst-devel] Re: [gst-cvs] ensonic gstreamer: gstreamer/ gstreamer/docs/manual/

[Stefan Kost]

Hi Thomnas,

I just didn't manage to get it right, so I back out. My plan was to have some 
shared sections:

shared/
   intro.xml
manual/
   manual.xml
pwg/
   pwg.xml

and beeing able to reference intro.xml from both documents.

Reagarding gtk-doc. I am all for getting this fixed. Can you point me to the 
problem and how you would do it instead?

Stefan

Thomas Vander Stichele wrote:
> Hi Stefan,
> 
> 
>>Log message:
>>* docs/manual/README:
>>uncover a nasty detail of the docs build
>>+Ensonic's comments on the doc build system :
>>+--------------------------------------------
>>+In case you like to share files between the manual and the pwg - its not trivial.
>>+Before anything is done, the build-system copies all xml files into the build
>>+subdir and this breaks including shared docs via entities.
> 
> 
> This is a very obtuse comment that doesn't say anything useful.  Could
> you explain what the problem is exactly ?
> 
> For the record, the root of the problem are the doc build tools, which
> need a lot of workarounds to build when srcdir != builddir.  As you may
> have noticed, autotools projects try to maintain a clean separation
> between the two, and historically doctools authors have been too lazy to
> get this right.  gtk-doc is a prime example - last I checked the
> gtk-doc.make snippet *overrides* autotools' read-only setting on the
> build tree so that the tools can do their dirty job.
> 
> So maybe you want to share your actual problem, because I see no reason
> to claim that this breaks including shared docs via entitities.  The
> docs and the website build both use shared entitities among lots of xml
> files.
> 
> Thomas
> 
> 
> Dave/Dina : future TV today ! - http://www.davedina.org/
> <-*- thomas (dot) apestaart (dot) org -*->
> To all the clumsy lovers who never seem to get it right
> <-*- thomas (at) apestaart (dot) org -*->
> URGent, best radio on the net - 24/7 ! - http://urgent.fm/
> 
> 
> 
> 
> 
> -------------------------------------------------------
> This SF.Net email is sponsored by xPML, a groundbreaking scripting language
> that extends applications into web and mobile media. Attend the live webcast
> and join the prime developer group breaking into this new coding territory!
> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
> _______________________________________________
> gstreamer-devel mailing list
> gstreamer-devel at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gstreamer-devel