jj icon indicating copy to clipboard operation
jj copied to clipboard

docs: Add graph to more JJ command help

Open poliorcetics opened this issue 1 year ago • 2 comments

Description

Several JJ commands already have graphs to help understand them when in their long --help form, this is awesome!

I would like all JJ command working with graph of more than a single revision to have at least one of those.

Steps to Reproduce the Problem

  1. jj interdiff --help <- no graph

Expected Behavior

The current list of commands is at https://martinvonz.github.io/jj/v0.17.1/cli-reference/ and we can for example see jj next has a graph. This should be the standard whenever possible/relevant, since words alone are often confusing/not enough when talking about graphs

poliorcetics avatar May 14 '24 14:05 poliorcetics

That is not a bad idea. I might give that a shot. Will probably also help myself understand some of the commands better.

Kintaro avatar Jun 14 '24 15:06 Kintaro

That is not a bad idea. I might give that a shot. Will probably also help myself understand some of the commands better.

Thanks! We have also talked about adding graphs to https://martinvonz.github.io/jj/prerelease/revsets, in case you feel like doing that too.

martinvonz avatar Jun 14 '24 22:06 martinvonz