$ . "$TESTDIR/testlib/topic_setup.sh"

  $ hg init pinky

  $ cd pinky

  $ cat <<EOF >> .hg/hgrc

  > [phases]

  > publish=false

  > EOF

  $ cat <<EOF >> $HGRCPATH

  > [experimental]

  > # disable the new graph style until we drop 3.7 support

  > graphstyle.missing = |

  > EOF

  $ hg help topics

  hg topics [TOPIC]

  View current topic, set current topic, change topic for a set of revisions, or

  see all topics.

      Clear topic on existing topiced revisions:

        hg topic --rev <related revset> --clear

      Change topic on some revisions:

        hg topic <newtopicname> --rev <related revset>

      Clear current topic:

        hg topic --clear

      Set current topic:

        hg topic <topicname>

      List of topics:

        hg topics

      List of topics with their last touched time sorted according to it:

        hg topic --age

      The active topic (if any) will be prepended with a "*".

      The '--current' flag helps to take active topic into account. For example,

      if you want to set the topic on all the draft changesets to the active

      topic, you can do: 'hg topic -r "draft()" --current'

      The --verbose version of this command display various information on the

      state of each topic.

  options ([+] can be repeated):

      --clear       clear active topic if any

   -r --rev REV [+] revset of existing revisions

   -l --list        show the stack of changeset in the topic

      --age         show when you last touched the topics

      --current     display the current topic only

  (some details hidden, use --verbose to show complete help)

  $ hg topics

Test topics interaction with evolution:

  $ hg topics --config experimental.evolution=

  $ hg topics --config experimental.evolution= --rev . bob

  abort: must have obsolete enabled to change topics

  [255]

Create some changes:

  $ for x in alpha beta gamma delta ; do

  >   echo file $x >> $x

  >   hg addremove

  >   hg ci -m "Add file $x"

  > done

  adding alpha

  adding beta

  adding gamma

  adding delta

Still no topics

  $ hg topics

  $ hg topics --current

  no active topic

  [1]

  $ hg topics --current somerandomtopic

  abort: cannot use --current when setting a topic

  [255]

  $ hg topics --current --clear

  abort: cannot use --current and --clear

  [255]

  $ hg topics --clear somerandomtopic

  abort: cannot use --clear when setting a topic

  [255]

Trying some invalid topicnames

  $ hg topic '.'

  abort: the name '.' is reserved

  [255]

  $ hg topic null

  abort: the name 'null' is reserved

  [255]

  $ hg topic tip

  abort: the name 'tip' is reserved

  [255]

  $ hg topic 12345

  abort: cannot use an integer as a name

  [255]

  $ hg topic '   '

  abort: topic name cannot consist entirely of whitespaces

  [255]

Test commit flag and help text

  $ echo stuff >> alpha

  $ HGEDITOR=cat hg ci -t topicflag

  HG: Enter commit message.  Lines beginning with 'HG:' are removed.

  HG: Leave message empty to abort commit.

  HG: --

  HG: user: test

  HG: topic 'topicflag'

  HG: branch 'default'

  HG: changed alpha

  abort: empty commit message

  [255]

  $ hg revert alpha

  $ hg topic

   * topicflag

Make a topic

  $ hg topic narf

  $ hg topics

   * narf

  $ hg topics -v

   * narf (on branch: default, 0 changesets)

  $ hg stack

  ### topic: narf

  ### branch: default

  (stack is empty)

  t0^ Add file delta (base)

Add commits to topic

  $ echo topic work >> alpha

  $ hg ci -m 'start on narf'

  $ hg co .^

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg topic fran

  $ hg topics

   * fran

     narf

  $ hg topics --current

  fran

  $ echo >> fran work >> beta

  $ hg ci -m 'start on fran'

  $ hg co narf

  switching to topic narf

  2 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg topic

     fran

   * narf

  $ hg log -r . -T '{topics}\n'

  narf

  $ echo 'narf!!!' >> alpha

  $ hg ci -m 'narf!'

  $ hg log -G

  @  changeset:   6:7c34953036d6

  |  tag:         tip

  |  topic:       narf

  |  parent:      4:fb147b0b417c

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     narf!

  |

  | o  changeset:   5:0469d521db49

  | |  topic:       fran

  | |  parent:      3:a53952faf762

  | |  user:        test

  | |  date:        Thu Jan 01 00:00:00 1970 +0000

  | |  summary:     start on fran

  | |

  o |  changeset:   4:fb147b0b417c

  |/   topic:       narf

  |    user:        test

  |    date:        Thu Jan 01 00:00:00 1970 +0000

  |    summary:     start on narf

  |

  o  changeset:   3:a53952faf762

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     Add file delta

  |

  o  changeset:   2:15d1eb11d2fa

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     Add file gamma

  |

  o  changeset:   1:c692ea2c9224

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     Add file beta

  |

  o  changeset:   0:c2b7d2f7d14b

     user:        test

     date:        Thu Jan 01 00:00:00 1970 +0000

     summary:     Add file alpha

Exchanging of topics:

  $ cd ..

  $ hg init brain

  $ hg -R pinky push -r 4 brain

  pushing to brain

  searching for changes

  adding changesets

  adding manifests

  adding file changes

  added 5 changesets with 5 changes to 4 files

Export

  $ hg -R pinky export

  # HG changeset patch

  # User test

  # Date 0 0

  #      Thu Jan 01 00:00:00 1970 +0000

  # Node ID 7c34953036d6a36eae468c550d0592b89ee8bffc

  # Parent  fb147b0b417c25ca15547cd945acf51cf8dcaf02

  # EXP-Topic narf

  narf!

  diff -r fb147b0b417c -r 7c34953036d6 alpha

  --- a/alpha	Thu Jan 01 00:00:00 1970 +0000

  +++ b/alpha	Thu Jan 01 00:00:00 1970 +0000

  @@ -1,2 +1,3 @@

   file alpha

   topic work

  +narf!!!

Import

  $ hg -R pinky export > narf.diff

  $ hg -R pinky --config extensions.strip= strip .

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  saved backup bundle to $TESTTMP/pinky/.hg/strip-backup/7c34953036d6-1ff3bae2-backup.hg (glob)

  $ hg -R pinky import narf.diff

  applying narf.diff

  $ hg -R pinky log -r .

  changeset:   6:7c34953036d6

  tag:         tip

  topic:       narf

  parent:      4:fb147b0b417c

  user:        test

  date:        Thu Jan 01 00:00:00 1970 +0000

  summary:     narf!

Now that we've pushed to brain, the work done on narf is no longer a

draft, so we won't see that topic name anymore:

  $ hg log -R pinky -G

  @  changeset:   6:7c34953036d6

  |  tag:         tip

  |  topic:       narf

  |  parent:      4:fb147b0b417c

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     narf!

  |

  | o  changeset:   5:0469d521db49

  | |  topic:       fran

  | |  parent:      3:a53952faf762

  | |  user:        test

  | |  date:        Thu Jan 01 00:00:00 1970 +0000

  | |  summary:     start on fran

  | |

  o |  changeset:   4:fb147b0b417c

  |/   user:        test

  |    date:        Thu Jan 01 00:00:00 1970 +0000

  |    summary:     start on narf

  |

  o  changeset:   3:a53952faf762

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     Add file delta

  |

  o  changeset:   2:15d1eb11d2fa

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     Add file gamma

  |

  o  changeset:   1:c692ea2c9224

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     Add file beta

  |

  o  changeset:   0:c2b7d2f7d14b

     user:        test

     date:        Thu Jan 01 00:00:00 1970 +0000

     summary:     Add file alpha

  $ cd brain

  $ hg co tip

  4 files updated, 0 files merged, 0 files removed, 0 files unresolved

Because the change is public, we won't inherit the topic from narf.

  $ hg topic

  $ echo what >> alpha

  $ hg topic query

  $ hg ci -m 'what is narf, pinky?'

  $ hg log -Gl2

  @  changeset:   5:c01515cfc331

  |  tag:         tip

  |  topic:       query

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     what is narf, pinky?

  |

  o  changeset:   4:fb147b0b417c

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     start on narf

  |

  $ hg push -f ../pinky -r query

  pushing to ../pinky

  searching for changes

  adding changesets

  adding manifests

  adding file changes

  added 1 changesets with 1 changes to 1 files (+1 heads)

  $ hg -R ../pinky log -Gl 4

  o  changeset:   7:c01515cfc331

  |  tag:         tip

  |  topic:       query

  |  parent:      4:fb147b0b417c

  |  user:        test

  |  date:        Thu Jan 01 00:00:00 1970 +0000

  |  summary:     what is narf, pinky?

  |

  | @  changeset:   6:7c34953036d6

  |/   topic:       narf

  |    parent:      4:fb147b0b417c

  |    user:        test

  |    date:        Thu Jan 01 00:00:00 1970 +0000

  |    summary:     narf!

  |

  | o  changeset:   5:0469d521db49

  | |  topic:       fran

  | |  parent:      3:a53952faf762

  | |  user:        test

  | |  date:        Thu Jan 01 00:00:00 1970 +0000

  | |  summary:     start on fran

  | |

  o |  changeset:   4:fb147b0b417c

  |/   user:        test

  |    date:        Thu Jan 01 00:00:00 1970 +0000

  |    summary:     start on narf

  |

  $ hg topics

   * query

  $ cd ../pinky

  $ hg co query

  switching to topic query

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ echo answer >> alpha

  $ hg ci -m 'Narf is like `zort` or `poit`!'

  $ hg merge narf

  merging alpha

  warning: conflicts while merging alpha! (edit, then use 'hg resolve --mark')

  0 files updated, 0 files merged, 0 files removed, 1 files unresolved

  use 'hg resolve' to retry unresolved file merges or 'hg update -C .' to abandon

  [1]

  $ hg revert -r narf alpha

  $ hg resolve -m alpha

  (no more unresolved files)

  $ hg topic narf

  $ hg ci -m 'Finish narf'

  $ hg topics

     fran

   * narf

     query

  $ hg debugnamecomplete # branch:topic here is a buggy side effect

  default

  default:fran

  default:narf

  default:query

  fran

  narf

  query