changeset 5797:aad3ee70a0bb stable

doc: document stack as a substitue for MQ's qseries
author Chuck Tuffli <chuck@tuffli.net>
date Fri, 12 Feb 2021 13:16:01 -0800
parents c23cbde54a58
children 87006dcf2bb7
files CHANGELOG docs/from-mq.rst
diffstat 2 files changed, 26 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/CHANGELOG	Wed Feb 03 08:07:10 2021 -0800
+++ b/CHANGELOG	Fri Feb 12 13:16:01 2021 -0800
@@ -1,6 +1,11 @@
 Changelog
 =========
 
+10.2.1 - in progress
+--------------------
+
+ * doc: document stack as a substitue for MQ's qseries
+
 10.2.0.post1 -- 2021-02-01
 --------------------------
 
--- a/docs/from-mq.rst	Wed Feb 03 08:07:10 2021 -0800
+++ b/docs/from-mq.rst	Fri Feb 12 13:16:01 2021 -0800
@@ -48,6 +48,27 @@
   [alias]
   wip = log -r 'not public()' --template='{rev}:{node|short} {desc|firstline}\n'
 
+Using the topic extension provides another way of looking at your
+work in progress. Topic branches are lightweight branches which
+disappear when changes are finalized. Although the underlying
+mechanics are different, both queues and topics help users
+organize and share their unfinished work. The topic extension
+provides the ``stack`` command. Similar to ``qseries``, ``stack``
+lists all changesets in a topic as well as other related
+information.
+
+.. code-block:: console
+
+  $ hg stack
+
+Installing the evolve extension also installs the topic extension. To enable
+it, add the following to your `hgrc` config:
+
+.. code-block:: ini
+
+  [extensions]
+  topic =
+
 hg qnew
 ```````