hg topics

View current topic, set current topic, change topic for a set of revisions, or see all topics.

hg topics [OPTION]... [-r REV]... [TOPIC]

This command is provided by the topic extension.

Clear topic on existing topiced revisions:

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

Change topic on some revisions:

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

Clear current topic:

hg topics --clear

Set current topic:

hg topics <topicname>

List of topics:

hg topics

List of topics sorted according to their last touched time displaying last touched time and the user who last touched the topic:

hg topics --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 topics -r "draft()" --current

The --verbose version of this command display various information on the state of each topic.

Options

	--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
-T	--template TEMPLATE	display with template
	--mq	operate on patch repository

Options marked [+] can be repeated.