On Tue, Oct 15, 2024 at 10:44:34PM +0100, Julian Gilbey wrote:
> On Tue, Oct 15, 2024 at 04:42:59PM +0200, Bill Allombert wrote:
> > Package: jupyter
> > Version: 5.7.2-4
> > Severity: normal
> > 
> > Hello Debian Python Team,
> > 
> > 'man jupyter' is listing only two subcommands while there are much more
> > available.  Maybe you could use help2man ?
> 
> Hi Bill,
> 
> Oh, that's a bit of a tricky one: the available subcommands depend on
> which jupyter extensions are installed.  We could replace that line in
> jupyter.1 with a note saying: "To list the currently available
> subcommands, run jupyter --help".

Thanks for looking into this!

It would be nice to explain that the subcommands are provided by other packages
and mention the more important ones.
I suppose most users want to use 'jupyter notebook' for example.

Also it should point to 'man jupyter-$subcommand' to get the help for the
subcommand.

If you do not know the difference between jupyter and jupyter-notebook it is 
easy to get lost.

Cheers,
Bill.

Reply via email to