annotate README-topic @ 2957:586c9ace20b3

obslog: simplify formatter keys

The formatter field keys are all prefixed with
`debugobshistory.'. This is annoyingly useless as they are already in
the `debughistory` topic.

This patch simplify these keys. For examle, on this repository `hg obslog -Tdebug -r 31cbace4c0f1` :

```
debugobshistory = [
   {
      'node':'31cbace4c0f1',
      'shortdescription':'topics: make sure we have some restrictions on topic names',
      'rev':2904,
      'markers':[

      ]
   },
   {
      'node':'d439a6087434',
      'markers':[
         {
            'date':(1504176329.83902,
            -7200            ),
            'verb':'rewritten',
            'succnodes':[
               '31cbace4c0f1'
            ],
            'effect':[
               'parent'
            ],
            'user':'Pierre-Yves David <[e-mail]>'
         }
      ]
   },
   {
      'node':'1e1f651704d4',
      'markers':[
         {
            'date':(1504175088.811924,
            -7200            ),
            'verb':'rewritten',
            'succnodes':[
               'd439a6087434'
            ],
            'effect':[
               'parent'
            ],
            'user':'Pierre-Yves David <[e-mail]>'
         }
      ]
   },
   {
      'node':'eb6495cf6cb1',
      'markers':[
         {
            'date':(1504015275.001643,
            -19800            ),
            'verb':'rewritten',
            'succnodes':[
               '1e1f651704d4'
            ],
            'effect':[
               'parent',
               'content'
            ],
            'user':'Pulkit Goyal <[e-mail]>'
         }
      ]
   },
   {
      'node':'761e446e0112',
      'markers':[
         {
            'date':(1504015201.780276,
            -19800            ),
            'verb':'rewritten',
            'succnodes':[
               'eb6495cf6cb1'
            ],
            'effect':[
               'content'
            ],
            'user':'Pulkit Goyal <[e-mail]>'
         }
      ]
   },
   {
      'node':'531a626950bd',
      'markers':[
         {
            'date':(1504015017.897054,
            -19800            ),
            'verb':'rewritten',
            'succnodes':[
               '761e446e0112'
            ],
            'effect':[
               'meta',
               'parent',
               'content'
            ],
            'user':'Pulkit Goyal <[e-mail]>'
         }
      ]
   },
   {
      'node':'c2f9ba7329ea',
      'markers':[
         {
            'date':(1504014136.876537,
            -19800            ),
            'verb':'rewritten',
            'succnodes':[
               '531a626950bd'
            ],
            'effect':[
               'meta'
            ],
            'user':'Pulkit Goyal <[e-mail]>'
         }
      ]
   },

]
```


We now able to ask `hg obslog -r 78debdfb3e4d -T '{label("log.summary", shortdescription)}\n{if(markers, markers % "  {date|age} {user|person}\n")}'`

```
doc: simplify the reference to in-core features

  9 days ago Pierre-Yves David

  9 days ago Pierre-Yves David

  9 days ago Pierre-Yves David

  9 days ago Pierre-Yves David
  9 days ago Philippe Pepiot

  9 days ago Philippe Pepiot
```

Topic Extension
================

This packages also provides the ``topic`` experiment in an independent
extension. It implements a new experimental concept to provide lightweight
feature branches for the mutable parts of the history. The experiments is still
at an early stage and have significant usability and performance issues when
enabled.

How to Install
==============

The ``topic`` extension is included into the ``evolve` package, so the same instruction apply.

Using Pip
---------

You can install the latest version using pip::

    $ pip install --user hg-evolve

Then just enable it in you hgrc::

    $ hg config --edit # adds the two line below:
    [extensions]
    topic =

From Source
-----------

To install a local version from source::

    $ hg clone https://www.mercurial-scm.org/repo/evolve/
    $ cd evolve
    $ make install-home

Enable
------

The topic extensions is included in the evolve package. See the install instruction for evolve.

Then enable it in you configuration::

    $ hg config --edit # adds the two line below:
    [extensions]
    topic =

Documentation
-------------

* See 'hg help -e topic' for a generic help.
* See 'hg help topics' and 'hg help stack' for help on specific commands.
* See the 'tests/test-topic-tutorial.t' file for a quick tutorial.