Mercurial > public > mercurial-scm > hg
diff hgext/largefiles/lfcommands.py @ 15230:697289c5d415
largefiles: improve help
Extension help taken from the URL formerly in the text
(https://developers.kilnhg.com/Repo/Kiln/largefiles/largefiles/File/usage.txt)
and improved.
author | Greg Ward <greg@gerg.ca> |
---|---|
date | Tue, 11 Oct 2011 21:10:03 -0400 |
parents | ee625de3541e |
children | 6e809bb4f969 |
line wrap: on
line diff
--- a/hgext/largefiles/lfcommands.py Tue Oct 11 21:11:01 2011 -0400 +++ b/hgext/largefiles/lfcommands.py Tue Oct 11 21:10:03 2011 -0400 @@ -20,14 +20,23 @@ # -- Commands ---------------------------------------------------------- def lfconvert(ui, src, dest, *pats, **opts): - '''Convert a normal repository to a largefiles repository + '''convert a normal repository to a largefiles repository - Convert source repository creating an identical repository, except that all - files that match the patterns given, or are over the given size will be - added as largefiles. The size used to determine whether or not to track a - file as a largefile is the size of the first version of the file. After - running this command you will need to make sure that largefiles is enabled - anywhere you intend to push the new repository.''' + Convert repository SOURCE to a new repository DEST, identical to + SOURCE except that certain files will be converted as largefiles: + specifically, any file that matches any PATTERN *or* whose size is + above the minimum size threshold is converted as a largefile. The + size used to determine whether or not to track a file as a + largefile is the size of the first version of the file. The + minimum size can be specified either with --size or in + configuration as ``largefiles.size``. + + After running this command you will need to make sure that + largefiles is enabled anywhere you intend to push the new + repository. + + Use --tonormal to convert largefiles back to normal files; after + this, the DEST repository can be used without largefiles at all.''' if opts['tonormal']: tolfile = False @@ -464,10 +473,12 @@ cmdtable = { 'lfconvert': (lfconvert, - [('s', 'size', '', 'All files over this size (in megabytes) ' - 'will be considered largefiles. This can also be specified ' - 'in your hgrc as [largefiles].size.'), - ('','tonormal',False, - 'Convert from a largefiles repo to a normal repo')], + [('s', 'size', '', + _('minimum size (MB) for files to be converted ' + 'as largefiles'), + 'SIZE'), + ('', 'tonormal', False, + _('convert from a largefiles repo to a normal repo')), + ], _('hg lfconvert SOURCE DEST [FILE ...]')), }