bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: @setfilename: for info only?


From: Karl Berry
Subject: Re: @setfilename: for info only?
Date: Sat, 27 Jun 2009 19:05:48 -0500

Hi Ralf,

    made me wonder what @setfilename is intended for; the texinfo manual
    doesn't seem to be too explicit about this.  

True :(.

    Is it meant to name the .info file only, or also serve as base to
    any or some of the HTML, DVI, PDF, .txt outputs?

All.  In short (and from memory -- let me know if you observe discrepancies):

@setfilename foo[.info]
-> foo.info[-*]
-> foo.html/  (subdir if split HTML)
-> foo.html   (file if unsplit HTML)
              (I don't know what we're going do with chapter-split HTML)
-> foo.txt
-> foo.dvi
-> foo.pdf
-> foo.xml    (Texinfo XML)
-> foo.dbk    (Docbook)

The presence or absence of the .info extension in the input is obeyed
for the Info output; that is, if we have @setfilename foo, the Info
output is "foo" (possibly split: foo-1, foo-2, ...), whereas
@setfilename foo.info outputs to "foo.info" (foo.info-1, foo.info-2, ...).

However, the .info in the input is ignored for all the other output
formats, which always use the extension.  @setfilename foo -> foo.html.

As for your remark about the undesirability of determining the output
filename by looking at the contents of the input file, well, I agree
with you in principle.  I don't think there was any overriding need for
@setfilename in the first place (instead of just using the input
filename) and don't know why rms needed it.  But it's too late now.

I'll try to improve the documentation at some point.

k




reply via email to

[Prev in Thread] Current Thread [Next in Thread]