[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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



* John W. Eaton <jwe@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




Reply to: