[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Geiser-users] Errors in printed and Info references in the Geiser m
Re: [Geiser-users] Errors in printed and Info references in the Geiser manual
Sat, 08 Jan 2011 12:54:09 -0500
> In some cases, the Texinfo code might be fixed by changing uses of
> @ref macro with the @xref or @pxref macro (See the node (texinfo)
> Cross references). In other cases, the sentence will need to be
> rewritten in order to make the generated Info text grammatical.
> not sure that the goal of making the HTML links into readable text
> be made compatible with the requirements of the TeX (printed) and
You're probably right; i'll use a macro that will use internally an
@ifhtml conditional to decide what argument to insert. This will take
bit of time, but it'll be well spent time.
The on-line HTML for the Emacs manual appears to use the 'See ...' form
most of the time for its cross references, as does the on-line HTML for
Emacs Lisp manual:
One of the problems in the Geiser Info text is that Emacs is confused
the cross-references that it finds and doesn't fill paragraphs
There are large gaps, with lines only half or two-thirds filled, and
appears only in paragraphs that have cross-references. The raw Info
is not flawed -- I think that this is a case of the unusual
cross-referencing being an area that has not been tested, that is, it
error in the Emacs paragraph-filling algorithm.
Come to think of it, there are already a million monkeys on a million
typewriters, and Usenet is NOTHING like Shakespeare. - Blair Houghton.