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

[Rafael Laboissiere <rafael@laboissiere.net>]

* Rafael Laboissiere <rafael@laboissiere.net> [2014-01-02 20:56]:

> * Rafael Laboissiere <rafael@laboissiere.net> [2014-01-02 10:28]:
> > 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?
>
> The text above clearly does not reflect the situation of the final 
> 3.8.0 release, since the octave command launches the CLI.  I am right 
> now working on a more accurate text.

I just committed the changes.  It reads now:

 SYNOPSIS
      octave [options]... [file]
      octave-cli [options]... [file]

 DESCRIPTION
      Octave  is a high-level language, primarily intended for numerical com‐
      putations.  It provides a convenient command line interface for solving
      linear  and nonlinear problems numerically.  It also provides a graphi‐
      cal user interface  that  can  be  launched  with  the  command  octave
      --force-gui.   The  octave-cli command is a synonym for the octave com‐
      mand, except for the fact that option --force-gui will  not  work  with
      it.

Rafael