view docs/README @ 4252:a07cd1d076bb

next: solve the issue of `next` get confused by split

This patch solve a problem of next command which get confused by split.
Let me describe how it was getting confused:

Initial state of repo:

      A---B---C

After splitting B to (B1,B2):

          @
      A---B1---B2
       \
        ---B---C
           X   *

    (note: C is orphan; checkedout to B1)

Lets make an amend on B1:

            @
            B1'
           /
      A---B1---B2
       \  X    *
        \
         ---B---C
            X   *

Now, if run `hg next` (--evolve is True by default now):

$ it would give you choice to choose from B2 and C thinking that C could also
  be a possbile children for B1, instead of stablizing B2 on B1.

I fixed this problem by filtering those aspiring children which can be
stablized on one of the aspiring children itself.

Changes made in test-prev-next.t shows the changed expected behaviour.

Doc is generated with sphinx.

You can generate the doc with:

```
make
```

# Tutorials

For updating the tutorials, you need to have the docgraph extension installed
(https://pypi.python.org/pypi/hg-docgraph).

Then run the test-topic-tutorial.t and test-tutorial.t to update the output if
needed.

You'll need the dot binary (likely installed by the graphviz package in your
package manager) in order to have graphviz graphs rendered in the html output.

Simply run make in the docs directory should takes care of the conversion of
the tutorial .t files into .rst files. Then sphinx should do the rest of the
jobs by rendering graphviz graphs.