darcs

Patch 1485 make some command descriptions shorter a... (and 2 more)

Title make some command descriptions shorter a... (and 2 more)
Superseder Nosy List gh
Related Issues
Status accepted Assigned To
Milestone

Created on 2016-04-18.18:25:58 by gh, last changed 2016-04-25.04:33:36 by gh.

Files
File name Status Uploaded Type Edit Remove
make-some-command-descriptions-shorter-and-nicer.dpatch gh, 2016-04-18.18:25:57 application/x-darcs-patch
patch-preview.txt gh, 2016-04-18.18:25:57 text/x-darcs-patch
patch-preview.txt gh, 2016-04-18.20:02:42 text/x-darcs-patch
patch-preview.txt gh, 2016-04-18.20:17:23 text/x-darcs-patch
reduce-help-of-init.dpatch gh, 2016-04-18.20:17:23 application/x-darcs-patch
reduce-help-of-record.dpatch gh, 2016-04-18.20:02:42 application/x-darcs-patch
unnamed gh, 2016-04-18.18:25:57 text/plain
unnamed gh, 2016-04-18.20:02:42 text/plain
unnamed gh, 2016-04-18.20:17:23 text/plain
See mailing list archives for discussion on individual patches.
Messages
msg19171 (view) Author: gh Date: 2016-04-18.18:25:57
I've been playing with generating a manual, and noticed the
output of "darcs help" (command listing) could be sorted
a little more usefully. Here is the output of darcs help
after this bundle:

-------8<-------

Usage: darcs COMMAND ...

Commands:
  help            Display help about darcs and darcs commands.

Most used/starting out:
  initialize      Create an empty repository.
  add             Add new files to version control.
  whatsnew        List unrecorded changes in the working tree.
  record          Create a patch from unrecorded changes.
  clone           Make a copy of an existing repository.
  pull            Copy and apply patches from another repository to this one.
  push            Copy and apply patches from this repository to another one.

Preparing patches before recording:
  move            Move or rename files.
  remove          Remove files from version control.
  replace         Substitute one word for another.

Querying the repository:
  log             List patches in the repository.
  annotate        Annotate lines of a file with the last patch that modified it.
  diff            Create a diff between two versions of the repository.
  show            Show information about the given repository.
  test            Run tests and search for the patch that introduced a bug.

Undoing and correcting:
  revert          Discard unrecorded changes.
  unrevert        Undo the last revert.
  amend           Improve a patch before it leaves your repository.
  rebase          Edit several patches at once.
  rollback        Apply the inverse of recorded changes to the working tree.
  unrecord        Remove recorded patches without changing the working tree.
  obliterate      Delete selected patches from the repository.

Direct modification of the repository:
  tag             Name the current repository state for future reference.
  setpref         Set a preference (test, predist, boringfile, or binariesfile).

Exchanging patches by e-mail:
  send            Prepare a bundle of patches to be applied to some target repository.
  apply           Apply a patch bundle created by `darcs send'.

Other commands:
  optimize        Optimize the repository.
  dist            Create a distribution archive.
  mark-conflicts  Mark unresolved conflicts in working tree, for manual resolution.
  repair          Repair a corrupted repository.
  convert         Convert repositories between various formats.
  fetch           Fetch patches from another repository, but don't apply them.

Use 'darcs COMMAND --help' for help on a single command.
Use 'darcs --version' to see the darcs version number.
Use 'darcs --exact-version' to see a detailed darcs version.
Use 'darcs help patterns' for help on patch matching.
Use 'darcs help environment' for help on environment variables.
Use 'darcs help manpage' to display help in the manpage format.
Use 'darcs help markdown' to display help in the markdown format.

Check bug reports at http://bugs.darcs.net/

------->8--------





3 patches for repository http://darcs.net:

patch ae150396df80bd0fff369acec764f940d23ed160
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 15:20:01 ART 2016
  * make some command descriptions shorter and nicer

patch 3f1c73e0ca880ee2ec4098ae33ece7f0ccbd5af8
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 15:36:59 ART 2016
  * remove all hidden aliases of show, deprecated for years

patch 6f8cb17b63eb407e25344c04b3f62d8ff9610fab
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 15:41:51 ART 2016
  * darcs help: new sections and order for commands
Attachments
msg19172 (view) Author: gh Date: 2016-04-18.20:02:42
6 patches for repository http://darcs.net:

patch e748d5e5d8b4c0a01643825141e661aa3da9d003
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 16:47:45 ART 2016
  * reduce help of record

patch 954edaf34ba0117de32810014df8e9170d056843
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 16:52:32 ART 2016
  * reduce help of clone

patch d19c93fa0d001465fbbb07720f9845d5dc4325a9
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 16:56:51 ART 2016
  * reduce help of pull

patch cc3cd988ef72eec719fe677541d63d7c6c751619
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 16:58:26 ART 2016
  * reduce help of push

patch 35365e2145ccc0b37941626971dcccbe375fdf6f
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 17:07:40 ART 2016
  * update help of diff

patch 6007bd527f68ae34de9367a553468ee6d23308bf
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 17:14:53 ART 2016
  * mention weak hash in help of show repo
Attachments
msg19173 (view) Author: gh Date: 2016-04-18.20:17:23
1 patch for repository http://darcs.net:

patch 1e16ddb66f2a13db6d53e97c20de835747604b1a
Author: Guillaume Hoffmann <guillaumh@gmail.com>
Date:   Mon Apr 18 17:35:40 ART 2016
  * reduce help of init
Attachments
msg19186 (view) Author: ganesh Date: 2016-04-21.18:40:06
OK
History
Date User Action Args
2016-04-18 18:25:58ghcreate
2016-04-18 18:26:51ghsetstatus: needs-screening -> needs-review
2016-04-18 20:02:42ghsetfiles: + patch-preview.txt, reduce-help-of-record.dpatch, unnamed
messages: + msg19172
2016-04-18 20:17:24ghsetfiles: + patch-preview.txt, reduce-help-of-init.dpatch, unnamed
messages: + msg19173
2016-04-21 18:40:06ganeshsetstatus: needs-review -> accepted-pending-tests
messages: + msg19186
2016-04-25 04:33:36ghsetstatus: accepted-pending-tests -> accepted