Re: [OctDev] munge-texi problem with static library build

[Daniel J Sebald]

[I'm copying the Octave maintainers list because the problem may 
originate with the core Octave m-script to tex-file translator.]

On 03/15/2011 08:56 PM, Rob Frohne wrote:
> Hi All,
>
> I'm attempting to build a statically linked version of octave 3.4 on
> Ubuntu 10.10 so I can move it to a network of redhat 5 machines. Just
> after it builds munge-texi, I get the following complaint from running
> it. Can anyone give me some advice?
>
> make[4]: Leaving directory
> `/home/frohro/Desktop/octave-3.4.0/doc/interpreter'
> ./munge-texi ../.. ../../scripts/DOCSTRINGS ../../src/DOCSTRINGS <
> arith.txi > arith.texi-t
> invalid doc file format
> make[3]: *** [arith.texi] Error 1
> make[3]: Leaving directory
> `/home/frohro/Desktop/octave-3.4.0/doc/interpreter'
> make[2]: *** [all-recursive] Error 1
> make[2]: Leaving directory `/home/frohro/Desktop/octave-3.4.0/doc'
> make[1]: *** [all-recursive] Error 1
> make[1]: Leaving directory `/home/frohro/Desktop/octave-3.4.0'
> make: *** [all] Error 2

Rob

The file in question is this one:

http://hg.savannah.gnu.org/hgweb/octave/file/41d183070c04/doc/interpreter/arith.txi

I used the "raw" link to download the file and compiled the tex file as 
follows:

address@hidden junk]$ tex arith.txi
This is TeX, Version 3.141592 (Web2C 7.5.6)
(./arith.txi
Overfull \hbox (11.37076pt too wide) in paragraph at lines 121--127
[]\tenrm @DOCSTRING(sin) @DOC-STRING(cos) @DOC-STRING(tan) 
@DOC-STRING(sec) @DO
C-STRING(csc)|

[snip]

! Missing $ inserted.
<inserted text>
                $
<to be read again>
                   _
l.225 @DOCSTRING(list_
                      primes)
?

It turns out this file has three function names with underscores in 
them.  The underscore is a special character and is the source of the 
error.  I replaced all the "_" with "\_" and the tex file compiles.

The question is why this fails.  Is DOCSTRING defined correctly?  Are 
the underscore function names something that was recently added?  Should 
the translator be adding a character before underscores?  I'll defer to 
the Octave maintainers list for those answers.

You said that you configure your compilation with:

<quote>

I am working again on building octave 3.4 with static libraries.  I did a

./configure --enable-static --disable-shared --disable-dh

and when I make I get

on the Makefile in src/

an error for line 9457 about a Missing Separator.

I had to go to that line and replace the five spaces with a tab.  I got 
the hint from this page:

http://www.delorie.com/djgpp/v2faq/faq22_17.html

The Makefile was made with the automake tools, and somehow they messed 
up on this.  I'm not really familiar with them or I'd make a suggestion 
on fixing it better.

<unquote>

Dan