comparison tests/test-topic-tutorial.t @ 6882:3ac0e0375509 stable

tests: small fixes to the user-visible text in test-topic-tutorial.t

6881:beee3d9a129a

  $ cd server

  $ cat >> .hg/hgrc << EOF
  > [ui]
  > user= Shopping Master
  > EOF

  $ cat >> shopping << EOF
  > Spam
  > Whizzo butter

  updating to branch default
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  $ cd client
  $ cat >> .hg/hgrc << EOF
  > [ui]
  > user= Tutorial User
  > EOF
#if docgraph-ext
  $ . "$TESTDIR/testlib/docgraph_setup.sh" #rest-ignore
#endif

  $ hg topics food
  marked working directory as topic: food

Much like a named branch, our topic is active but it does not contain any
changeset yet:

  $ hg topics
   * food (0 changesets)

  $ hg summary

Keep working within topics
==========================

Making sure all your new local commit are made within a topic will help you
organize your work. It is possible to ensure this through the Mercurial
configuration.

For this tutorial, we'll add the config at the repository level:

  $ cat << EOF >> .hg/hgrc
  > [experimental]
  > topic-mode = enforce
  > EOF

You can also use `hg config --edit` to update your mercurial configuration.


Once enforcement is turned on. New local commit will be denied if no topic is active.

  $ echo sickle >> shopping
  $ hg commit -m 'Adding sickle'
  abort: no active topic
  (see 'hg help -e topic.topic-mode' for details)

  $ hg commit -m 'Adding saw'

  $ echo drill >> shopping
  $ hg commit -m 'Adding drill'

But we are not sure we will actually go to the hardware store, so in the
meantime, we want to extend the list with drinks. We go back to the official
default branch and start a new topic:

  $ hg update default
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg rebase
  nothing to rebase
  [1]

We simulate independant contributions to the repo with this
activity:

  $ cd ../server
  $ hg update
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ cat foo >> shopping
  $ rm foo
  $ hg commit -m 'add a pair of shoes'
  $ cd ../client

Let's discover what other people did contribute:

  $ hg pull
  pulling from $TESTTMP/server (glob)
  searching for changes
  adding changesets

  rebasing 7:cffff85af537 tools "Adding saw"
  merging shopping
  rebasing 8:34255b455dac tools "Adding drill"
  merging shopping

But what about the other topic? You can use 'hg topics --verbose' to see
information about all the topics:

  $ hg topics --verbose
     drinks (on branch: default, 2 changesets, 2 behind)
   * tools  (on branch: default, 3 changesets)

The "2 behind" is telling you that there are 2 new changesets over the base of the topic.

Pushing that topic would create a new head, and therefore will be prevented:

  $ hg push --rev drinks
  pushing to $TESTTMP/server (glob)

  (merge or see 'hg help push' for details about pushing new heads)
  [20]


Even after a rebase, pushing all active topics at the same time would publish
them to the default branch, and then mercurial would complain about the
multiple *public* heads it would create on that branch:

  $ hg rebase -b drinks
  rebasing 9:8dfa45bd5e0c drinks "Adding apple juice"
  merging shopping

  adding manifests
  adding file changes
  added 2 changesets with 2 changes to 1 files
  2 new obsolescence markers

The published topic has now faded out, and the other is now marked as
"behind":

  $ hg topics --verbose
   * tools (on branch: default, 3 changesets, 2 behind)

===========================

Navigating within your stack
----------------------------

As we saw before `stack` displays changesets on your current topic in a clean way:

  $ hg topics --verbose
   * tools (on branch: default, 3 changesets, 2 behind)

  $ hg stack

  s3@ Adding drill (current)
  s2: Adding saw
  s1: Adding hammer
  s0^ add a pair of shoes (base)

You can navigate in your current stack with `previous` and `next`.

`previous` will bring you back to the parent of the topic head.

  $ hg previous
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  [s2] Adding saw

  s3: Adding drill
  s2@ Adding saw (current)
  s1: Adding hammer
  s0^ add a pair of shoes (base)

`next` will move you forward to the topic head.

  $ hg next
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  [s3] Adding drill

  s3@ Adding drill (current)
  s2: Adding saw
  s1: Adding hammer
  s0^ add a pair of shoes (base)

You can also directly jump to a changeset within your stack with the revset `t#`.

  $ hg update s1
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg stack

  s3$ Adding drill (orphan)
  s2$ Adding saw (orphan)
  s1@ Adding hammer to the shopping list (current)
  s0^ add a pair of shoes (base)

It's easy to stabilize the situation, `next` has an `--evolve` option.  It will
do the necessary relocation of `s2` and `s3` over the new `s1` without having
to do that rebase by hand.:

  $ hg next --evolve
  move:[s2] Adding saw
  atop:[s1] Adding hammer to the shopping list
  working directory is now at d5c51ee5762a

  s3@ Adding drill (current)
  s2: Adding saw
  s1: Adding hammer to the shopping list
  s0^ add a pair of shoes (base)

Let's take a look at `hg log` once again:

  $ hg log -G -r "s0::"
  @  changeset:   20:bae3758e46bf
  |  tag:         tip
  |  topic:       tools

  adding file changes
  added 4 changesets with 4 changes to 1 files (+1 heads)
  8 new obsolescence markers

Pushing the new topic branch to a non-publishing server did not require
--force. As long as new heads are on their own topic, Mercurial will not
complain about them.

From another client, we will get them with their topic:

  $ cd ../other-client

6882:3ac0e0375509

  $ cd server

  $ cat >> .hg/hgrc << EOF
  > [ui]
  > user = Shopping Master
  > EOF

  $ cat >> shopping << EOF
  > Spam
  > Whizzo butter

  updating to branch default
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  $ cd client
  $ cat >> .hg/hgrc << EOF
  > [ui]
  > user = Tutorial User
  > EOF
#if docgraph-ext
  $ . "$TESTDIR/testlib/docgraph_setup.sh" #rest-ignore
#endif

  $ hg topics food
  marked working directory as topic: food

Much like a named branch, our topic is active but it does not contain any
changesets yet:

  $ hg topics
   * food (0 changesets)

  $ hg summary

Keep working within topics
==========================

Making sure all your new local commits are made within a topic will help you
organize your work. It is possible to ensure this through the Mercurial
configuration.

For this tutorial, we'll add the config at the repository level:

  $ cat << EOF >> .hg/hgrc
  > [experimental]
  > topic-mode = enforce
  > EOF

You can also use `hg config --edit` to update your Mercurial configuration.


Once enforcement is turned on, new local commits will be denied if no topic is active.

  $ echo sickle >> shopping
  $ hg commit -m 'Adding sickle'
  abort: no active topic
  (see 'hg help -e topic.topic-mode' for details)

  $ hg commit -m 'Adding saw'

  $ echo drill >> shopping
  $ hg commit -m 'Adding drill'

But we are not sure if we will actually go to the hardware store, so in the
meantime, we want to extend the list with drinks. We go back to the official
default branch and start a new topic:

  $ hg update default
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg rebase
  nothing to rebase
  [1]

We simulate independent contributions to the repo with this
activity:

  $ cd ../server
  $ hg update
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ cat foo >> shopping
  $ rm foo
  $ hg commit -m 'add a pair of shoes'
  $ cd ../client

Let's discover what other people have contributed:

  $ hg pull
  pulling from $TESTTMP/server (glob)
  searching for changes
  adding changesets

  rebasing 7:cffff85af537 tools "Adding saw"
  merging shopping
  rebasing 8:34255b455dac tools "Adding drill"
  merging shopping

But what about the other topic? You can use ``hg topics --verbose`` to see
information about all the topics:

  $ hg topics --verbose
     drinks (on branch: default, 2 changesets, 2 behind)
   * tools  (on branch: default, 3 changesets)

The "2 behind" is telling you that there are 2 new changesets on top of the base of the topic.

Pushing that topic would create a new head, and therefore will be prevented:

  $ hg push --rev drinks
  pushing to $TESTTMP/server (glob)

  (merge or see 'hg help push' for details about pushing new heads)
  [20]


Even after a rebase, pushing all active topics at the same time would publish
them to the default branch, and then Mercurial would complain about the
multiple *public* heads it would create on that branch:

  $ hg rebase -b drinks
  rebasing 9:8dfa45bd5e0c drinks "Adding apple juice"
  merging shopping

  adding manifests
  adding file changes
  added 2 changesets with 2 changes to 1 files
  2 new obsolescence markers

The published topic has now faded out, and the other is now marked as being
"behind":

  $ hg topics --verbose
   * tools (on branch: default, 3 changesets, 2 behind)

===========================

Navigating within your stack
----------------------------

As we saw before ``stack`` displays changesets on your current topic in a clean way:

  $ hg topics --verbose
   * tools (on branch: default, 3 changesets, 2 behind)

  $ hg stack

  s3@ Adding drill (current)
  s2: Adding saw
  s1: Adding hammer
  s0^ add a pair of shoes (base)

You can navigate in your current stack with ``previous`` and ``next``.

``previous`` will bring you back to the parent of the topic head.

  $ hg previous
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  [s2] Adding saw

  s3: Adding drill
  s2@ Adding saw (current)
  s1: Adding hammer
  s0^ add a pair of shoes (base)

``next`` will move you forward to the topic head.

  $ hg next
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  [s3] Adding drill

  s3@ Adding drill (current)
  s2: Adding saw
  s1: Adding hammer
  s0^ add a pair of shoes (base)

You can also directly jump to a changeset within your stack with the revset ``s<number>``.

  $ hg update s1
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg stack

  s3$ Adding drill (orphan)
  s2$ Adding saw (orphan)
  s1@ Adding hammer to the shopping list (current)
  s0^ add a pair of shoes (base)

It's easy to stabilize the situation, ``next`` has an ``--evolve`` option
(turned on by default nowadays). It will do the necessary relocation of `s2`
and `s3` over the new `s1` without having to do that rebase by hand:

  $ hg next --evolve
  move:[s2] Adding saw
  atop:[s1] Adding hammer to the shopping list
  working directory is now at d5c51ee5762a

  s3@ Adding drill (current)
  s2: Adding saw
  s1: Adding hammer to the shopping list
  s0^ add a pair of shoes (base)

Let's take a look at ``hg log`` once again:

  $ hg log -G -r "s0::"
  @  changeset:   20:bae3758e46bf
  |  tag:         tip
  |  topic:       tools

  adding file changes
  added 4 changesets with 4 changes to 1 files (+1 heads)
  8 new obsolescence markers

Pushing the new topic branch to a non-publishing server did not require
``--force``. As long as new heads are on their own topic, Mercurial will not
complain about them.

From another client, we will get them with their topic:

  $ cd ../other-client