On Thu, 16 Mar 2000 [EMAIL PROTECTED] wrote:
> After a successful trial with `info'
> file `texinfo' I have reformatted `texinfo.txi' (without touching
> the wording) to include it here as a proposal; please see the diff
> output attached below.
FWIW, I like the original format better: it shows unequivocally that, for
example, in the following snippet:
* texi2dvi: (texinfo)Format with texi2dvi. Print Texinfo documents.
the "Format with texi2dvi" part is a name of a node in the file
`texinfo'. In contrast, your suggestion:
* texi2dvi: (texinfo) Format with texi2dvi.
Print Texinfo documents.
makes them physically separated by lots of whitespace, and creates an
impression that "Format with texi2dvi" is a free text part of the menu.
(When I first looked at the reformatted menu, I was almost certain that
Info won't work with such entries, but apparently it does. However, I
won't be surprised if some other Info reader out there will fail.)
> Now, the menue entry's second part lacks the trailing period. That seems
> to be harmless. Is it?
I don't understand what trailing period are you talking about here. Your
reformatted entry didn't remove any periods from the original one.
Anyway, the period after "texi2dvi" is mandatory: you cannot remove it
without breaking the reader. The period after "documents" is optional
(as is all the text "Print Texinfo documents.").
> Is there a convention to start the entry's third part ("description")
> at column 32?
There's no such convention, AFAIK. You are supposed to do what is
visually plausible, given the limitations imposed by the width of
a typical display screen.
