[email protected]
[Top] [All Lists]

Bug#354638: marked as forwarded (octave2.9-doc: off by one error in show

Subject: Bug#354638: marked as forwarded octave2.9-doc: off by one error in showing the pages of octave.pdf
From: Debian Bug Tracking System
Date: Tue, 14 Mar 2006 00:33:21 -0800
Your message dated Tue, 14 Mar 2006 09:29:35 +0100
with message-id <[email protected]>
has caused the Debian Bug report #354638,
regarding octave2.9-doc: off by one error in showing the pages of octave.pdf
to be marked as having been forwarded to the upstream software
author(s) [email protected]

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--- Begin Message ---
Subject: : Bug#354638: octave2.9-doc: off by one error in showing the pages of octave.pdf]
From: Rafael Laboissiere
Date: Tue, 14 Mar 2006 09:29:35 +0100
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:

The origin of the problem may be the outdated texinfo.tex which is
distributed with the octave sources:

    $ grep '\\def\\texinfoversion{' doc/texinfo.tex
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

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
@printdefunline ...enalty 10002 @checkparencounts
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

--- 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}, 
-## @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},
+## @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 <[email protected]> -----

From: Kamaraju Kusumanchi <[email protected]>
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 <[email protected]>
Reply-To: Kamaraju Kusumanchi <[email protected]>, [email protected]

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

  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


$dpkg -l acroread kpdf xpdf
| Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed
|/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad)
||/ Name                                 Version                              
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
[email protected]

----- End forwarded message -----


--- End Message ---
<Prev in Thread] Current Thread [Next in Thread>
  • Bug#354638: marked as forwarded (octave2.9-doc: off by one error in showing the pages of octave.pdf), Debian Bug Tracking System <=