Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 527260 - sci-mathematics/octave-3.8.2 incomplete documentation with USE="doc"
Summary: sci-mathematics/octave-3.8.2 incomplete documentation with USE="doc"
Status: RESOLVED INVALID
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: AMD64 Linux
: Normal normal (vote)
Assignee: Gentoo Science Mathematics related packages
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-10-28 17:32 UTC by Fedja Beader
Modified: 2014-11-13 20:17 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Fedja Beader 2014-10-28 17:32:31 UTC
$ octave -q
warning: docstring file '/usr/share/octave/3.8.2/etc/built-in-docstrings' not found
octave:1> help for
error: unable to open /usr/share/octave/3.8.2/etc/macros.texi for reading
error: called from:
error:   /usr/share/octave/3.8.2/m/help/__makeinfo__.m at line 103, column 5
error:   /usr/share/octave/3.8.2/m/help/help.m at line 99, column 22

Mentioned file macros.texi is not present.



sci-mathematics/octave-3.8.2:0/3.8.2 [3.6.4:0/3.6.4] USE="X curl glpk imagemagick opengl qhull qrupdate readline sparse zlib -doc -fftw -gnuplot -gui% -hdf5 -java% -jit% -postscript -static-libs"
Comment 1 Fedja Beader 2014-10-29 23:39:36 UTC
The waiting game begins.
Comment 2 Matthias Maier gentoo-dev 2014-10-29 23:46:19 UTC
Please rebuild octave with USE="doc".
Comment 3 Fedja Beader 2014-10-30 18:18:14 UTC
heh :)
Comment 4 Mark Wright gentoo-dev 2014-11-02 13:01:27 UTC
Testing octave 3.8.2 built with doc it works fine:

octave:1> %                                                                                                                                                                                                                                               argus% octave -q
octave:1> help for

 -- Keyword:  for I = RANGE
     Begin a for loop.

          for i = 1:10
            i
          endfor

     See also: do, parfor, while.



Additional help for built-in functions and operators is
available in the online version of the manual.  Use the command
'doc <topic>' to search the manual index.

Help and information about Octave is also available on the WWW
at http://www.octave.org and via the help@octave.org
mailing list.
octave:2>
Comment 5 Fedja Beader 2014-11-13 20:17:44 UTC
Is it not a little strange having to enable USE=doc to get basic command-line help? Atleast add a note in metadata about it.


 - - doc         : Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally

Note the 'extra'. Is command-line help regarded as 'extra' documentation? And if so, why?