changectx descendants()

Greg Ward greg-hg at gerg.ca
Mon Oct 19 13:38:26 CDT 2009


On Thu, Oct 15, 2009 at 4:27 AM, Berkes Adam <adam.berkes at intland.com> wrote:
> I supposed descendants() follow all parents. Am I retrive this info
> wrongly? Also: is there 'more' documentation on core classes like
> changectx or revlog?

I don't know anything about descendants(), but I know a good way to
trick the community into explaining internals better:

  * read the code and try to understand it as best you can
  * write a docstring that explains what the method does, as you understand it
  * submit a patch with that docstring
  * sit back and wait for people to correct your misunderstandings

Repeat the process until your patch adds a concise, accurate, useful
docstring and somebody pushes it to a canonical development
repository.  End result: you understand the method in question, and it
is documented so the next person to come along doesn't have to dig as
deeply as you did.  And, even though you did this for purely selfish
reasons, your karma in the Mercurial community goes *up*.  It's a
great trick.  ;-)

Greg


More information about the Mercurial-devel mailing list