--- Begin Message ---
I am forwarding below a bug report filed against the octave2.9 Debian
package. The user is complaining that the bookmarks added by texi2pdf in
the octave.pdf file are wrong. It seems that this is an old bug, already
reported against the texinfo package in Debian:
http://bugs.debian.org/37515
The origin of the problem may be the outdated texinfo.tex which is
distributed with the octave sources:
$ grep '\\def\\texinfoversion{' doc/texinfo.tex
\def\texinfoversion{1999-09-25.10}
I tried then to generate the PDF file with a more recent version of
texinfo.tex that I found in my system:
$ grep '\\def\\texinfoversion{' /usr/share/automake-1.9/texinfo.tex
\def\texinfoversion{2005-07-05.19}
Unfortunately, it did not work, texi2pdf stopped with the following
error message:
./arith.texi:1130: Unbalanced square braces in @def.
@badbrackcount ...nbalanced square braces in @def}
@global @brackcount =0
@checkparencounts ...ount =0 @else @badbrackcount
@fi
@printdefunline ...enalty 10002 @checkparencounts
@endgroup
l.1130 ...ar{y}] = pol2cart (@var{theta}, @var{r})
After investigation, I discovered that the @deftypefn macro is now
confused by square brackets in its arguments. The following patch makes
the compilation goes past the error above, but chokes on the next
@deftypefn:
--- octave2.1-2.1.72.orig/scripts/general/cart2pol.m
+++ octave2.1-2.1.72/scripts/general/cart2pol.m
@@ -18,8 +18,8 @@
## 02110-1301, USA.
## -*- texinfo -*-
-## @deftypefn {Function File} {} [@var{theta}, @var{r}] = cart2pol (@var{x}, @var{y})
-## @deftypefnx {Function File} {} [@var{theta}, @var{r}, @var{z}] = cart2pol (@var{x}, @var{y}, @var{z})
+## @deftypefn {Function File} {} {[@var{theta}, @var{r}]} = cart2pol (@var{x},
@var{y})
+## @deftypefnx {Function File} {} {[@var{theta}, @var{r}, @var{z}]} = cart2pol
(@var{x}, @var{y}, @var{z})
## Transform cartesian to polar or cylindrical coordinates.
## @var{x}, @var{y} (and @var{z}) must be of same shape.
## @var{theta} describes the angle relative to the x - axis.
I am afraid that using a more recent texinfo.tex (which may fix the
bookmarks problem) will imply lots of changes in the current Octave
sources. At any rate, I think the upstream authors should seriously
consider using a modern version of texinfo.tex.
----- Forwarded message from Kamaraju Kusumanchi <kamaraju@gmail.com> -----
From: Kamaraju Kusumanchi <kamaraju@gmail.com>
Subject: [Pkg-octave-devel] Bug#354638: octave2.9-doc: off by one error in
showing the pages of octave.pdf
Date: Mon, 27 Feb 2006 16:58:36 -0500
To: Debian Bug Tracking System <submit@bugs.debian.org>
Reply-To: Kamaraju Kusumanchi <kamaraju@gmail.com>, 354638@bugs.debian.org
Package: octave2.9-doc
Version: 2.9.4-12
Severity: normal
octave2.9-doc comes with /usr/share/doc/octave2.9-doc/octave.pdf.gz
To reproduce the bug
1) gunzip the octave.pdf.gz file to octave.pdf
2) open the file with kpdf
$kpdf /usr/share/doc/octave2.9-doc/octave.pdf &
3) Select contents tab in the left panel of kpdf
4) Click on any of the links say "Preface"
the user is shown pg 2 instead of pg 1.
Similarly click on the link "Distribution"
the user will be shown pg 5 instead of pg 4.
I have checked with acroread and kpdf. Both of them exhibit the above
behaviour. However xpdf exhibits correct behaviour (without any off by one
errors) which made me think that may be it is a problem with acroread and kpdf.
However when viewing /usr/share/doc/maxima-doc/maximabook-19-Sept-2004.pdf
all the three viewers namely acroread, kpdf, xpdf did not exhibit any off by one
errors.
So I am guessing that there is something going on in the way octave.pdf is
created. Hence I am reporting the bug against octave2.9-doc
thanks
raju
$dpkg -l acroread kpdf xpdf
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed
|/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad)
||/ Name Version Description
+++-====================================-====================================-========================================================================================
ii acroread 7.0.5-0.3 Adobe Acrobat Reader: Portable Document Format file viewer
ii kpdf 3.5.1-2 PDF viewer for KDE
ii xpdf 3.01-7 Portable Document Format (PDF) suite
-- System Information:
Debian Release: testing/unstable
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.14-2-686-smp
Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ISO-8859-1)
-- no debconf information
_______________________________________________
Pkg-octave-devel mailing list
Pkg-octave-devel@lists.alioth.debian.org
http://lists.alioth.debian.org/mailman/listinfo/pkg-octave-devel
----- End forwarded message -----
--
Rafael
--- End Message ---