diff options
author | Sam Thursfield <sam.thursfield@codethink.co.uk> | 2015-02-04 11:21:24 +0000 |
---|---|---|
committer | Sam Thursfield <sam.thursfield@codethink.co.uk> | 2015-02-04 11:21:24 +0000 |
commit | 8b7cba630f355d37ca83e4f0605f42c7317bce7f (patch) | |
tree | bf5e43f74c2beb9e73bea6db758c7d42d118b69d /README | |
parent | c972012707f6555de6cf636d8eb5e2bf6e8ebf87 (diff) | |
download | lorry-8b7cba630f355d37ca83e4f0605f42c7317bce7f.tar.gz |
Update tests and docs for obsolete fields in tarball importssam/tarball-obsolete-fields
The 'compression' and 'strip' fields seem to have been obsolete since
commit a7f8b1b63a97c66aea6f39342313d7a5b919cfa7 in 2012.
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" } } |