Re: Issues with gendocs and images

[Patrice Dumas]

On Fri, Oct 19, 2012 at 02:04:05PM +0200, Akim Demaille wrote:
> Hi all!
> 
> There is unfortunately no simple way to pass the corresponding
> directories to the various tools.  texi2dvi (DVI and PDF) can
> be taught easily via TEXINPUTS.  Yet for info, text, html,
> there are several options to use (--info etc.).  Unfortunately
> also, these flags do not accumulate, so '--info -Ifoo --info -Ibar'
> will no do what one might expect.

Is it about gendocs or makeinfo/tp?  Because in both makeinfo and tp -I
accumulates.

> Besides, if the picture is not found by makeinfo, gendocs
> exits with success.  That seems to come from makeinfo that treats
> as a warning missing sources!

tp too treats a case of missing file and missing alt as a warning too.
Not as an error, and I think that treating it as an error will break a
lot of manuals. 

> gendocs should probably check for this failure, and fail
> at this point, instead of proceeding with a broken documentation.

I can't see a way to do that.  One possibility would be to add a 
command line option to turn all warnings into errors.  Another 
would be to have a handler in init files (perl files) and have 
an identifier for warning messages and be able to turn them into 
errors by putting them in a structure or calling a function, but 
it would be some perl code then.

> Finally, but since the process ends before that point I
> couldn't check by experience, I was wondering what needs
> to be done to make sure that the HTML images will be part
> of the html tarballs.


Basically you'll have to copy them such that they have the same relative
location in the result as they have to the the texinfo manual or
to the incuided directories

For example if calling

./texi2any.pl --html -Ibar --split node -o dir foo.texi

then you'll have to do

cp -a *.jpg bar/*.jpg dir/


But you can also use IMAGE_LINK_PREFIX:

./texi2any.pl --html -Ibar --split node -o dir foo.texi --set 
IMAGE_LINK_PREFIX=bar
cp -a *.jpg bar/ dir/

-- 
Pat