Bug#361705: [Pkg-octave-devel] Bug#361705: octave2.1-info: wrong references in Variable index

[Rafael Laboissiere]

package octave2.1-info
forwarded 361705 bug at octave.org
tags 361705 upstream patch
thanks


The bug report below was filed against the Debian package octave2.1-info,
version 2.1.72-10.  I confirm that the same problems exist for 2.1.73 and
2.9.5.  (For detailed information, see http://bugs.debian.org/361705.)

My comments:

* Francesco Potorti` <pot at fly.isti.cnr.it> [2006-04-08 13:40]:

> Package: octave2.1-info
> Version: 1:2.1.72-10
> Severity: normal
> 
> In "Variable index" there is a reference to "return", which is not a
> variable.

I do not know if this is fixable.  The "return" keyword is defined with
"@defvr {Keyword} return" in doc/interpreter/func.txi and will be indexed
in the variable index in any case.


> In "variable index", automatic_replot refers to "Summary of built-in
> variables", which in turn refers to :Two-dimensional plotting", where
> automatic_replot is not mentioned.

This is indeed annoying.  Here is my suggested patch to fix the problem:


--- octave2.1-2.1.73.orig/doc/interpreter/plot.txi
+++ octave2.1-2.1.73/doc/interpreter/plot.txi
@@ -341,6 +341,8 @@
 any arguments.
 @end deffn
 
+ at DOCSTRING(automatic_replot)
+
 Note that NaN values in the plot data are automatically omitted, and
 Inf values are converted to a very large value before calling gnuplot.
 
--- octave2.1-2.1.73.orig/doc/interpreter/var.txi
+++ octave2.1-2.1.73/doc/interpreter/var.txi
@@ -283,7 +283,7 @@
 Default value: @code{"+ "}.
 
 @item automatic_replot
- at xref{Two-Dimensional Plotting}.
+ at xref{Low-Level plotting commands}.
 
 Default value: 0.
 


> -- System Information:
> Debian Release: testing/unstable
>   APT prefers testing
>   APT policy: (500, 'testing')
> Architecture: i386 (i686)
> Shell:  /bin/sh linked to /bin/bash
> Kernel: Linux 2.6.15-1-686
> Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
> 
> Versions of packages octave2.1-info depends on:
> ii  emacs21 [info-browser]        21.4a-3    The GNU Emacs editor
> ii  info [info-browser]           4.8-8      Standalone GNU Info documentation 
> 
> octave2.1-info recommends no packages.
> 
> -- no debconf information
> 
> 
> _______________________________________________
> Pkg-octave-devel mailing list
> Pkg-octave-devel at lists.alioth.debian.org
> http://lists.alioth.debian.org/mailman/listinfo/pkg-octave-devel
> 

-- 
Rafael