[PATCH 1 of 3 v2] backout: add examples to clarify basic usage

[Yuya Nishihara]

On Mon, 12 Oct 2015 07:04:11 +0200, Mathias De Maré wrote:
> On Sun, Oct 11, 2015 at 4:13 PM, Yuya Nishihara <yuya at tcha.org> wrote:
> 
> > On Fri, 9 Oct 2015 18:38:17 +0200, Mathias De Maré wrote:
> > > On Mon, Oct 5, 2015 at 7:14 AM, Mathias De Maré <
> > mathias.demare at gmail.com>
> > > wrote:
> > >
> > > > # HG changeset patch
> > > > # User Mathias De Maré <mathias.demare at gmail.com>
> > > > # Date 1443764903 -7200
> > > > #      Fri Oct 02 07:48:23 2015 +0200
> > > > # Node ID 1a73cad7ebc4dd778c72f6d64efb8235cae2faad
> > > > # Parent  97dc6ab42aad232c73180dee648685c26662230b
> > > > backout: add examples to clarify basic usage
> > > >
> > >
> > > This one appears to have gotten dropped from patchwork. Can someone have
> > a
> > > look?
> > >
> > > >
> > > > diff --git a/mercurial/commands.py b/mercurial/commands.py
> > > > --- a/mercurial/commands.py
> > > > +++ b/mercurial/commands.py
> > > > @@ -485,6 +485,56 @@
> > > >
> > > >      .. container:: verbose
> > > >
> > > > +      Some examples:
> > > > +
> > > > +      - Reverse the effect of the parent of the working directory.
> > > > +        This backout will be committed immediately::
> >
> > It seems we generally write bullet list in all lowercase.
>
> I was a bit confused about this. I found lowercase for one-sentence entries
> and upper case where there are multiple sentences. Not sure which practice
> I should follow?

Perhaps we tend to avoid mixing one-sentence and multi-sentence entries?

It seems a bit odd that some entries start with uppercase. But I live in
a country where no distinction exists between upper/lowercase letters, so you
would have better sense about that.