[gnu.emacs] gnews 1.9 =MANUAL: texinfo-format-buffer chokes on @l command

emv@mailrus.cc.umich.edu (Edward Vielmetti) (08/27/88)

(caveat: I'm new at gnu emacs, texinfo, and gnews)

When I try to produce the info file from the gnews 1.9 distribution
=MANUAL, texinfo-format-buffer dies partway through with the message:

	@l is not handled by texinfo

Sure enough, the line reads

	... @l{open-network-stream} ...

Is this a case of 
	me messing up somewhere ?
	an old version of texinfo here ?
	a newer version of weemba-texinfo ?

Help would be appreciated - for now I think I'll edit the
text and replace the @l directives with something innocuous.

--Ed
Edward Vielmetti, U of Michigan

weemba@garnet.berkeley.edu (Matthew P Wiener) (08/27/88)

>[@l not handled by texinfo]

From the ==README:

|To set up a manual, on-line or printed, mostly follow the directions in
|the `texinfo' node of the Emacs info tree.  Change the second line of
|the manual to suit yourself.  There are two minor bugs in texinfo.  To
|get around them, evaluate the following two expressions after loading
|texinfmt.el but before running M-x texinfo-format-buffer:
|
|	(put 'l 'texinfo-format 'texinfo-format-code)
|
|	(defun texinfo-index (indexvar)
|	  (set indexvar
|	       (cons (list (texinfo-parse-arg-discard)
|			   texinfo-last-node)
|		     (symbol-value indexvar)))
|	  (save-excursion
|	    (goto-char texinfo-command-start)
|	    (if (looking-at "^[ \t]*$")
|		(delete-region (match-beginning 0) (1+ (match-end 0))))))

After the fact correction: there is only the one `bug'.  The second more
complicated hackery is how I got around my own misreading of the Texinfo
manual, and is gone in the later drafts.  (And thanks to RMS himself for
steering me clear on this one.  I guess there just aren't that many folks
who've used Texinfo.)

(The purpose of the @l is to generate that neat sans-serif font for Lisp
objects in TeX.  The above put code makes @l{gnews-is-great} come out as
`gnews-is-great' in the Info manual.)

In Gnews 2.0 (progress is very slow this time around), the central bulk
of TeX and Info generation will be handled by single Emacs commands, btw.

ucbvax!garnet!weemba	Matthew P Wiener/Brahms Gang/Berkeley CA 94720