Re: Why is it _still_ so freaking hard to get info with images?

[Jan Nieuwenhuizen]

Op maandag 09-03-2009 om 13:18 uur [tijdzone +0100], schreef David
Kastrup:

Hi David,

> For images in the INFO docs to work, do
> 
>     make out=www install-info 
> 
> and read the extra instructions.

...because you're missing this info:

> make[2]: Leaving directory `/lisa/lilypond/Documentation/user'


So the command would be

   make -C Documentation/user out=www install-info prefix=...

the prefix option is not necessary if you're installing where
you told configure you'd be installing.

> And sure enough: the installed tree contains no info files with images.

Similarly, to get images with info, do

   make -C Documentation/user out=www info

> What point is there in complaining that Linux distributions tend to omit
> the images when there is no working Makefile target that would get them
> there, and when the instructions that the Makefile gives out don't even
> work?

Good points, everything should be fixed.  Improvements could be

  * add toplevel info and install-info targets that redirect to 
    Documentation/user
  * make info with images automagically (using these targets)
    when doing a toplevel make web [there is really no point
    in *not* making info docs without images when the images
    are already built for the web docs.  the only reason for
    supporting info without images, is for 'install-info' to
    work when web-doc tools are not installed/available]
  [better not:* fix the documentation command to suggest -C Doc../user]

Any takers?  Next thing is that I wrote patches[1,2] for yelp to display
images in info docs, but yelp seems to be dead[3] (or at least not very
eager to take them).

Jan.

[1] http://lilypond.org/blog/janneke/software/info-image/yelp-info-image.diff
[2] 
http://lilypond.org/blog/janneke/software/info-image/yelp-info-image-and-notes.diff
[3] https://bugzilla.gnome.org/show_bug.cgi?id=568209

-- 
Jan Nieuwenhuizen <address@hidden> | GNU LilyPond - The music typesetter
http://www.xs4all.nl/~jantien       | http://www.lilypond.org