Question

My scripts are using mercurial command-line and parse output, and now i’m a bit confised about ‘summary’ command output. For commit it writes (clean) in some cases, like this:

$ hg summary
branch: default
commit: 2 unknown (clean)
update: (current)

And sometimes it don’t writes (clean):

$ hg summary
branch: default
commit: 1 modified, 2 unknown
update: (current)

Is it any documentation available that explains meaning of this (clean) text? Or it is implementation specific and mercurial output is not intended to be parsed via scripts?

I’m also curious what are (current), (update) etc, but they seems not very important.

Answer 1

The documentation for the command (hg help summary) is admittedly terse. You can, however, look at the implementation of hg summary here to understand what the output means.