[Pkg-octave-devel] Manpages for octave-cli and octave-gui

[Rafael Laboissiere]

* 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