Add a New Comment (Rich Markup)
I pushed a cset (http://hg.savannah.gnu.org/hgweb/octave/rev/1c840b2fd337) to remove escapes from within @qcode macros both for qr.cc and the deprecated luinc.m
Hi Anonymous, Thanks for your comments. Actually, the construct @qcode{\"something\"} appears only in two files:
$ find . -name "*.m" -exec grep -l '@qcode{\\"' {} \; ./scripts/deprecated/luinc.m ./doc/interpreter/genpropdoc.m
For the first case, besides the fact the script luinc.m is deprecated, @qcode{\"vector\"} should read, in fact, @qcode{"vector"}. Otherwise, the documentation looks awkward. For the second case (genpropdoc.m), all occurrences of the construct @qcode{\"something\"} appear inside strings in the Octave code. That is the reason the double quotes must be escaped. However, the above does not answer your question. The bug in the docstring for qrdelete is triggered because that docstring is processed by texinfo, in the process of building the Octave manual, which is not the case for luinc. Indeed, you can try:
info octave --index-search=qrdelete info octave --index-search=luinc
Rafael Laboissière
I had a quick look and there are many other files which use @qcode{\", some examples:
./scripts/deprecated/luinc.m:75:## Given the string argument @qcode{\"vector\"}, @code{luinc} returns the ./doc/interpreter/genpropdoc.m:134: s.doc = "If __prop__ is @qcode{\"on\"}, the __objname__ is \
are these also problematic? (found with find . -name "*.m" -exec egrep -Hn --color=auto '@qcode{\\' {} \;)
Buildinfg for source fails for the current hg tip, with the following error message:
TEXINPUTS="./build-aux:$TEXINPUTS" \ MAKEINFO='/bin/bash /path/to/octave/build-aux/missing makeinfo -I doc/interpreter -I ./doc/interpreter' \ texi2dvi --build-dir=doc/interpreter/octave.t2d -o doc/interpreter/octave.dvi \ `test -f 'doc/interpreter/octave.texi' || echo '/path/to/octave/'`doc/interpreter/octave.texi [snip] /path/to/octave/doc/interpreter/linalg.texi:1265: Argument of @" has an extra }. <inserted text> @par <to be read again> } @tclose ...n @rawbackslash @plainfrenchspacing #1} @null @codex #1->@tclose {#1} @endgroup l.1 @code{@xeatspaces {@"col@"}} @empty @scanmacro ...spaceisspace @scantokens {#1@empty } @endgroup ... l.1265 (if @var{orient} is @qcode{\"col\"} ),
The trivial patch attached to this bug report fixes the problem. Rafael Laboissière
(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)
Attach Files: Comment:
Depends on the following items: None found
Items that depend on this one: None found
There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.
Only project members can vote.
Please enter the title of George Orwell's famous dystopian book (it's a date):
Follow 3 latest changes.
Copyright © 2023 Free Software Foundation, Inc. Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved. The Levitating, Meditating, Flute-playing Gnu logo is a GNU GPL'ed image provided by the Nevrax Design Team. Source Code
Powered by Savane 3.12