Reference for CLI subcommands?

[eitsupi]

Currently the Quarto CLI has many subcommands.
It would be nice to have a comprehensive reference page for subcommands.

$ quarto --help

  Usage:   quarto 
  Version: 0.9.215
                  

  Description:

    Quarto CLI

  Options:

    -h, --help     - Show this help.                            
    -V, --version  - Show the version number for this program.  

  Commands:

    render          [input] [args...]  - Render input file(s) to various document types.                                                
    serve           [input]            - Serve an interactive document.                                                                 
    create-project  [dir]              - Create a project for rendering multiple documents                                              
    preview         [file] [args...]   - Render and preview a Quarto document or website project. Automatically reloads the browser when
    convert         [input]            - Convert documents to alternate representations.                                                
    capabilities                       - Query for current capabilities (output formats, engines, kernels etc.)                         
    check           [target]           - Check and verify correct functioning of Quarto installation and computation engines.           
    inspect         [path]             - Inspect a Quarto project or input path. Inspecting a project returns its config and engines.   
    tools           [command] [tool]   - Manage the installation, update, and uninstallation of useful tools.                           
    help            [command]          - Show this help or the help of a sub-command.

[cwickham]

Moving from related issue:

Also, I noticed the quarto use command is not at all documented, not even in Quarto CLI itself.

[mcanouil]

FYI, related to #5421.

[cderv]

Related:

• [CLI help] Improve doc about CLI command for project creation #6692

[cwickham]

Related to #1531

[SichangHe]

Some shell configurations read the manpage and generate shell completions. Related: #3216.

[cscheid]

We should investigate if Cliffy's Command objects support extracting existing options and configuration, from which we can generate a command-reference.yml file to be used in quarto-web.

[winniehell]

it sounds like #10878 wants to be resolved first