Re: Issues with gendocs and images

[John Darrington]

On Fri, Oct 19, 2012 at 09:54:28PM +0000, Karl Berry wrote:
     Hi Akim,
     
         A few images have been added to the Bison documentation
     
     Sorry to hear it.  I doubt you can reasonably use gendocs in such
     circumstances, for all the reasons you have discovered.  Anyway, I have
     no good answers and cannot even begin to contemplate the long-standing
     issue of distributing manuals images for some time.
     
         That seems to come from makeinfo that treats as a warning missing
         sources!
     
     The idea was that an Info file can very likely still be useful without
     the image.  The further idea was that most people would not bother to
     make a .txt version.  Indeed, you are the first person to do so that I
     have ever heard of.  I am not especially opposed to making it an error,
     though.  Patrice, wdyt?  Maybe it's already an error with tp?


I feel I must therefore mention this:

In PSPP we have a volunteer who has in recent months been keenly adding a 
manual section documenting the GUI aspects of the program.  Obviously, 
GUI documentation depends heavily on screenshots.  And we have also been
encountering similar problems to Akim.   Many of them we have been able
to workaround, by post processing what makeinfo generates, and by placing
multiple copies of the images into the directories makeinfo expects, 
before it is run.  Such workarounds, of course, will become cumbersome and
unmaintainable if left to proliferate.


So if I can help in any way to improve the way texinfo handles images - 
especially in it's docbook output - I'd be happy to cooperate.

J'

signature.asc
Description: Digital signature