quarto install tool or quarto tools install?

[mcanouil]

While in the documentation website, it is mostly quarto tools install, in Quarto CLI, some messages highlight quarto install tool.
What is the proper/preferred way (i.e., both work)?

To note, the uninstall subcommand is only available through quarto tools uninstall.

I spotted the following places where quarto install tool is "used":

• quarto-cli/.github/workflows/test-smokes.yml

  Lines 67 to 69 in 763b0ed

  	- name: Install Tinytex
  	run: |
  	quarto install tool tinytex

• quarto-cli/src/command/install/cmd.ts

  Lines 46 to 57 in 763b0ed

  	.example(
  	"Install TinyTeX",
  	"quarto install tool tinytex",
  	)
  	.example(
  	"Install Chromium",
  	"quarto install tool chromium",
  	)
  	.example(
  	"Choose tool to install",
  	"quarto install tool",
  	)

• quarto-cli/src/command/render/latexmk/latex.ts

  Lines 214 to 216 in 763b0ed

  	info(
  	"\nNo TeX installation was detected.\n\nPlease run 'quarto install tool tinytex' to install TinyTex.\nIf you prefer, you may install TexLive or another TeX distribution.\n",
  	);

• quarto-cli/src/tools/tools.ts

  Lines 141 to 143 in 763b0ed

  	installableTools().forEach((name) =>
  	info("quarto install tool " + name, { indent: 2 })
  	);

• quarto-cli/src/tools/tools.ts

  Lines 168 to 170 in 763b0ed

  	info(
  	`${name} is not installed use 'quarto install tool ${name} to install it.`,
  	);

[jjallaire]

I think the docs should use quarto install tool. @dragonstyle Could you update the docs to be consistent in this usage?

[mcanouil]

This would mean to install, for example, tinytex with quarto install tool tinytex (I believe this command is more clear) and to uninstall it with quarto tools uninstall tinytex.
Not sure, the uninstall command is straightforward though.
Maybe if a similar subcommand as install existed, that would ease things up, i.e., quarto uninstall <type> [target].
Anyway tools is not even listed in quarto --help, so definitely not the command to keep.

[jjallaire]

Yes tools is deprecated so we will be removing it from the docs.

[dragonstyle]

I've corrected the quarto.org documentation (deploying now). You can use:

quarto remove tool tinytex

to handle uninstallation and

quarto update tool tinytex

to update to the latest version.

quarto list tools

will get you a summary of the tools.

We're in the process of improving these commands - I think making update/remove/list visible in help may have slipped through the cracks - we'll get that corrected when we can.

[mcanouil]

Perfect remove will do 😉

PS: Which posts deserves to be marked as the answer? 😏