Mercurial > hg
changeset 20784:7f4cf938643d stable
convert: more clear documentation of the 'include' default of a 'include .'
At first glance it can be confusing that adding a superfluous include directive
will exclude more files.
| author | Mads Kiilerich <madski@unity3d.com> |
|---|---|
| date | Wed, 19 Mar 2014 00:19:54 +0100 |
| parents | 03774a2b6991 |
| children | 29b159bd71bc 6a2acb0d9352 |
| files | hgext/convert/__init__.py tests/test-convert.t |
| diffstat | 2 files changed, 10 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/hgext/convert/__init__.py Mon Mar 17 14:57:13 2014 -0400 +++ b/hgext/convert/__init__.py Wed Mar 19 00:19:54 2014 +0100 @@ -101,9 +101,10 @@ longest matching path applies, so line order does not matter. The ``include`` directive causes a file, or all files under a - directory, to be included in the destination repository, and the - exclusion of all other files and directories not explicitly - included. The ``exclude`` directive causes files or directories to + directory, to be included in the destination repository. The default + if there are no ``include`` statements is to include everything. + If there are any ``include`` statements, nothing else is included. + The ``exclude`` directive causes files or directories to be omitted. The ``rename`` directive renames a file or directory if it is converted. To rename from a subdirectory into the root of the repository, use ``.`` as the path to rename to.
--- a/tests/test-convert.t Mon Mar 17 14:57:13 2014 -0400 +++ b/tests/test-convert.t Wed Mar 19 00:19:54 2014 +0100 @@ -84,11 +84,12 @@ so line order does not matter. The "include" directive causes a file, or all files under a directory, to - be included in the destination repository, and the exclusion of all other - files and directories not explicitly included. The "exclude" directive - causes files or directories to be omitted. The "rename" directive renames - a file or directory if it is converted. To rename from a subdirectory into - the root of the repository, use "." as the path to rename to. + be included in the destination repository. The default if there are no + "include" statements is to include everything. If there are any "include" + statements, nothing else is included. The "exclude" directive causes files + or directories to be omitted. The "rename" directive renames a file or + directory if it is converted. To rename from a subdirectory into the root + of the repository, use "." as the path to rename to. The splicemap is a file that allows insertion of synthetic history, letting you specify the parents of a revision. This is useful if you want