$ 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"
The waiting game begins.
Please rebuild octave with USE="doc".
heh :)
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>
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?