jj/cli
Ilya Grigoriev 684d62e8ae cli: rename --restore-descendants to --preserve-descendant-content AKA --pdc
Fixes https://github.com/jj-vcs/jj/discussions/5951

There have also been discussions on Discord on and off; people seem to
agree that `--preserve-descendant-content` is clear if verbose. I hope
that a short alias might address that (though I don't intent to make a
habit of having many cryptic short aliases), though we could also decide
to skip it for now and see whether it's really needed.

Some other options considered:

- `keep-descendant-content`. In theory, I like it better, but it'd be
  confusingly similar to `jj squash --keep-emptied` once `jj squash
  --keep-descendant-content` was implemented, and would also conflict
  with its tab completion.
- `--preserve-descendant-contents` with `s` at the end.
- The short version could be `-P`, but that would be confusable with
  `--preserve-content` for `jj rebase`, discussed below. Also, currently
  single-capital-letter flags are usually about lifting some
  restriction, e.g. `-B` for `--allow-backwards`.
- `verbatim-descendants`
- `reparent-descendants`

The last two look a bit cryptic, depending on the person.

Note that `jj rebase` will also need a `--preserve-content` flag for
preserving the content of the commit actually being rebased. I'm not
sure whether that should also be `--pc` or not.
2025-03-23 18:50:43 -07:00
..
examples cleanup: enable unused_trait_names clippy lint and run clippy --fix 2025-03-16 00:35:56 +00:00
src cli: rename --restore-descendants to --preserve-descendant-content AKA --pdc 2025-03-23 18:50:43 -07:00
testing cleanup: enable unused_trait_names clippy lint and run clippy --fix 2025-03-16 00:35:56 +00:00
tests cli: rename --restore-descendants to --preserve-descendant-content AKA --pdc 2025-03-23 18:50:43 -07:00
build.rs build: fix cargo publish by symlinking cli/docs->docs 2024-11-05 17:37:14 -08:00
Cargo.toml cargo: remove "anyhow" which was used only in config tests 2025-03-17 01:39:55 +00:00
docs build: fix cargo publish by symlinking cli/docs->docs 2024-11-05 17:37:14 -08:00
LICENSE cargo: add LICENSE file to each crate we publish 2023-09-22 21:48:28 -07:00