Mercurial > hg > mercurial-crew-with-dirclash
annotate doc/README @ 5192:33015dac5df5
convert: fix mercurial_sink.putcommit
Changeset 4ebc8693ce72 added some code to putcommit to avoid creating a
revision that touches no files, but this can break regular conversions
from some repositories:
- conceptually, since we're converting a repo, we should try to make
the new hg repo as similar as possible to the original repo - we
should create a new changeset, even if the original revision didn't
touch any files (maybe the commit message had some important bit);
- even if a "regular" revision that doesn't touch any file may seem
weird (and maybe even broken), it's completely legitimate for a merge
revision to not touch any file, and, if we just skip it, the
converted repo will end up with wrong history and possibly an extra
head.
As an example, say the crew and main hg repos are sync'ed. Somebody
sends an important patch to the mailing list. Matt quickly applies
and pushes it. But at the same time somebody also applies it to crew
and pushes it. Suppose the commit message ended up being a bit
different (say, there was a typo and somebody didn't fix it) or that
the date ended up being different (because of different patch-applying
scripts): the changeset hashes will be different, but the manifests
will be the same.
Since both changesets were pushed to public repos, it's hard to recall
them. If both are merged, the manifest from the resulting merge
revision will have the exact same contents as its parents - i.e. the
merge revision really doesn't touch any file at all.
To keep the file filtering stuff "working", the generic code was changed
to skip empty revisions if we're filtering the repo, fixing a bug in the
process (we want parents[0] instead of tip).
author | Alexis S. L. Carvalho <alexis@cecm.usp.br> |
---|---|
date | Fri, 17 Aug 2007 20:18:05 -0300 |
parents | 8db8e1100f3f |
children |
rev | line source |
---|---|
453 | 1 Mercurial's documentation is currently kept in ASCIIDOC format, which |
2 is a simple plain text format that's easy to read and edit. It's also | |
3 convertible to a variety of other formats including standard UNIX man | |
4 page format and HTML. | |
177 | 5 |
453 | 6 To do this, you'll need to install ASCIIDOC: |
177 | 7 |
453 | 8 http://www.methods.co.nz/asciidoc/ |
177 | 9 |
453 | 10 To generate the man page: |
177 | 11 |
453 | 12 asciidoc -d manpage -b docbook hg.1.txt |
13 xmlto man hg.1.xml | |
177 | 14 |
453 | 15 To display: |
177 | 16 |
453 | 17 groff -mandoc -Tascii hg.1 | more |
177 | 18 |
453 | 19 To create the html page (without stylesheets): |
177 | 20 |
5048
8db8e1100f3f
Update asciidoc instructions to suggest html4 for newer versions
Brendan Cully <brendan@kublai.com>
parents:
453
diff
changeset
|
21 asciidoc -b html4 hg.1.txt |
8db8e1100f3f
Update asciidoc instructions to suggest html4 for newer versions
Brendan Cully <brendan@kublai.com>
parents:
453
diff
changeset
|
22 |
8db8e1100f3f
Update asciidoc instructions to suggest html4 for newer versions
Brendan Cully <brendan@kublai.com>
parents:
453
diff
changeset
|
23 (older asciidoc may want html instead of html4 above) |