[Pkg-octave-devel] Manpages for octave-cli and octave-gui
Rafael Laboissiere
rafael at laboissiere.net
Thu Jan 2 09:28:14 UTC 2014
* John W. Eaton <jwe at octave.org> [2014-01-01 19:58]:
> On 01/01/2014 02:46 PM, Rafael Laboissiere wrote:
>> In package version 3.8.0~rc2-1, the commands octave-gui and octave-cli
>> are lacking manpages. I implemented a solution in commit b3d5849, by
>> linking octave-gui.1.gz and octave-cli.1.gz to octave.1.gz [snip]
>>
>> Please, tell me whether you think this solution is acceptable, and I
>> will forward the patch upstream.
>
> The octave-gui binary is not intended to be executed directly by users
> so it should not be listed in the man page. In the 3.8.0 release it
> is installed in the libexec directory, not bin.
Thanks for your input on this issue, John. The Debian package currently
in the experimental distribution is using the 3.8.0-rc2 tarball, which
pre-dates the changeset 65e4e05, in which octave-gui ceased to be
installed in the bin directory.
However, there will be still octave-cli installed into bin. Since the
Debian Policy requires that every program in /usr/bin/ have a man page, I
kept the octave-cli.1.gz link and patched the octave.1 man page to read:
DESCRIPTION
Octave is a high-level language, primarily intended for numerical com‐
putations. It provides convenient command line (octave-cli command)
and graphical user (octave command) interfaces for solving linear and
nonlinear problems numerically.
Would this change be appropriate for the upstream sources?
Rafael
More information about the Pkg-octave-devel
mailing list