export/log, bundle (Documentation)

[Alexander Schatten]

I am just trying to understand the details of patches for cooperation without server repository. Now there are some small issues that I did not completly understood reading the docs:

(1) what is the difference between hg export and hg log --patch?

(2) There is apparently no option to generate a diff over multipe versions? something like (or is there?):

hg export 10-15

(3) Finally I figured that the bundle command is actually very powerful to communicate a series of changesets; exactly what I searched. However, I wanted to note that the documentation to bundle is in my opinion not very clear.

It took me some time to understand that bundle actually works like "push" just with the difference that it does not push, but generates a "repository diff" as file. Maybe one could add this to the documentation, because I believe it would help to understand the command.

Also

--base       a base changeset to specify instead of a destination

seemed not very clear to me: maybe in the regular text an addition should be added: "When no destination repository is available for comparison, --base can be used: bundle is created starting from manual set base-revision instead of a destination repository"


(4) what I would also find very good for clarity is, if related commands are marked as such; e.g. in the doc of "export" "see also: "import, log --patch, bundle" and so on.


have a good weekend



Alex