>>>> "APA" == Adrian Aichner
<aichner(a)ecf.teradyne.com> writes:
APA> Hello \(tex\)?info experts!
APA> Another big texi patch from me is lurking around the corner, so
APA> beware!
APA> 2. xrefs containing spaces may be folded during paragraph filling in
APA> `texinfo-format-buffer'. This will cause false "invalid reference
APA> ..." errors.
APA> I have fixed this problem by replacing "[ \t]+" inside reference
APA> names with single spaces.
APA> Q: Is this the Right Thing to do?
I think so now since this is what Info-follow-reference is doing:
(setq i 0)
(while (setq i (string-match "[ \n\t]+" str i))
(setq str (concat (substring str 0 i) " "
(substring str (match-end 0))))
(setq i (1+ i)))
I acomplish the same thing with:
(setq name (replace-in-string name "[ \t]+" " "))
in a patch to (defun Info-validate-node-name (kind &optional name)
which will follow.
APA> 3. Info-validate complains about (at least) the following invalid
APA> references. All of these are not real xrefs but rather `Notes'
APA> written in the texi sources. Constructs as @strong{Note:} and
APA> @emph{NOTE:} are wrong according to the Texinfo manual:
APA> *Caution:* Do not use `@emph' or `@strong' with the word
`Note';
APA> Info will mistake the combination for a cross reference. Use a
APA> phrase such as *Please note* or *Caution* instead.
APA> Q: Is it acceptable if I change all occurences from ...{note.?} to
APA> ...{[Pp]lease note.?}?
I'll just go ahead and do that tomorrow.
Any suggestions til then?
Later,
Adrian
--
Adrian Aichner
Applications Engineer
Teradyne GmbH
Semiconductor Test Group Telephone +49/89/41861(0)-208
Dingolfinger Strasse 2 Fax +49/89/41861-217
D-81673 MUENCHEN E-mail aichner(a)ecf.teradyne.com