chiark / gitweb /
git-debrebase(1): Make this manpage a less intimidating entry point
authorSean Whitton <spwhitton@spwhitton.name>
Sat, 20 Jul 2019 12:00:34 +0000 (13:00 +0100)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Sun, 21 Jul 2019 15:22:28 +0000 (16:22 +0100)
commitc32fe13de2b9eded09a713ea00330131ac719225
tree5cca482dda0f2c99ef2e0257c87511ef13023684
parent7376ab4e0011581acd76bd90a62073c63026f401
git-debrebase(1): Make this manpage a less intimidating entry point

- Nicer short description right in the first section.

- Don't use the term 'delta queue' until it's needed.

- Don't talk about other manpages so early.

- Cater for people who type `man git-debrebase` looking for a
  barebones tutorial, not (just) a command line reference.

  - That tutorial should minimise references to dgit, especially since
    users might want to use git-debpush to upload.

Thanks to Sam Hartman for the user feedback which prompted this and
Ian Jackson for feedback on the content of "QUICK REFERENCE".

Closes: #926656
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
git-debrebase.1.pod