> > As other solution, I propose: > - use autoreconf (directly related to other autotools) > - directly call gtkdocize from our autogen.sh (single line) > - concert help from DocBook to Mallard: Mallard is simple and > non-linear, modern approach to user documentation. > I'm thinking about the last item of my list since long time now. This > can be the good occasion. The most notable lost of feature is that I do > not know how to generate a single PDF from a collection of mallard > files.
The only reason for PDF generation in my opinion as it's the only current help delivered on Windows builds. > http://projectmallard.org/ Using Mallard for the XML will not of course magically make the documentation any better. Some one still has to write it. Considering no-one else is volunteering to update any Wiki material, I doubt whether changing to Mallard will make much difference. Presumably Yelp can cope with documentation in both DocBook and Mallard at the same time? > Furthermore, I feel that gnome-autogen.sh is going to be deprecated, > like DocBook is. > https://wiki.gnome.org/GnomeDocUtilsMigrationHowTo > https://wiki.gnome.org/GnomeGoals/NewDocumentationInfrastructure I note it says "IMPORTANT: Do not port to the new system if the application still needs to run under GNOME 2. Yelp 2 does not recognize the new help system." Is this important for us? I guess it means help wouldn't work on a MATE desktop. > What should we do? If you want to lead the change then do it. I can not find a pre built version of Yelp to use under Windows. However I can fairly easily switch the Windows build to use Compiled HTML (using HTML Help Workshop). MacOS - not worried about the help system - would like the latest main program to be consistently available first! (MacPorts has version 1.4). NB MacPorts only has Yelp2. ------------------------------------------------------------------------------ November Webinars for C, C++, Fortran Developers Accelerate application performance with scalable programming models. Explore techniques for threading, error checking, porting, and tuning. Get the most from the latest Intel processors and coprocessors. See abstracts and register http://pubads.g.doubleclick.net/gampad/clk?id=60136231&iu=/4140/ostg.clktrk _______________________________________________ Viking-devel mailing list Viking-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/viking-devel Viking home page: http://viking.sf.net/
