changeset 20516:3af218cf2007

obsstore: update create docstring to point to the coder friendly function The `obsstore` class have a `create` method that create new obsolescence marker from node. There is another function in the same module `createmarkers`. This other function is higher level and automatically missing meta data (ultimately calling the first one) We add a new comment in the docstring of `obsstore.create` highlighting that people writing new code probably want to use the top level one.
author Pierre-Yves David <pierre-yves.david@logilab.fr>
date Thu, 13 Feb 2014 17:33:45 -0800
parents 6afbfb9b1af1
children 2158e8f3cbd2
files mercurial/obsolete.py
diffstat 1 files changed, 3 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/mercurial/obsolete.py	Sat Feb 15 18:40:39 2014 +0900
+++ b/mercurial/obsolete.py	Thu Feb 13 17:33:45 2014 -0800
@@ -256,6 +256,9 @@
         * ensuring it is hashable
         * check mandatory metadata
         * encode metadata
+
+        If you are a human writing code creating marker you want to use the
+        `createmarkers` function in this module instead.
         """
         if metadata is None:
             metadata = {}