diff options
author | Sam Thursfield <sam.thursfield@codethink.co.uk> | 2015-02-04 12:21:11 +0000 |
---|---|---|
committer | Sam Thursfield <sam.thursfield@codethink.co.uk> | 2015-02-04 12:21:11 +0000 |
commit | 4fcff82742ce3325a860c060b597ff281872c594 (patch) | |
tree | 75a83fb0e3a962dc026f098b2a5eb8230c35bc0d /README | |
parent | 28ba7b9e299d9aa54328ee2eaf8c4aac48465289 (diff) | |
parent | 8b7cba630f355d37ca83e4f0605f42c7317bce7f (diff) | |
download | lorry-4fcff82742ce3325a860c060b597ff281872c594.tar.gz |
Merge branch 'sam/tarball-obsolete-fields'
Reviewed-By: Pedro Alvarez <pedro.alvarez@codethink.co.uk>
Reviewed-By: Javier Jardón <javier.jardon@codethink.co.uk>
Diffstat (limited to 'README')
-rw-r--r-- | README | 20 |
1 files changed, 12 insertions, 8 deletions
@@ -177,18 +177,22 @@ as the project name. } ### Tarball -Some projects are old enough to pre-date version control, so the source is only -available in tarballs. -Tarball support is fairly limited, the compression format is currently specified -as the long form option without the --, so --gzip becomes gzip. -Strip removes that many components from the paths. This is necessary as tarballs -often have the folder name as the first component. + +Lorry can import a tarball fetched from a URL. The contents will be +committed on a branch named after the basename of the tar file (e.g. +bc-1.06.tar.gz will be imported into a branch named 'bc-1.06'. + +The import is done by the `lorry.tar-importer` subprocess. It can detect and +handle common compression formats including gzip, bz2, xz and lzma. It will +also detect if there is a 'top directory' that contains the tarball contents +and strip this out of the imported filenames. + +Tarball imports once required 'compression' and 'strip' to be specified. +These are obsolete now and are ignored by Lorry. { "bc": { "type": "tarball", - "compression": "gzip", - "strip": 1, "url": "http://ftp.gnu.org/gnu/bc/bc-1.06.tar.gz" } } |