Skip to content

Latest commit

 

History

History
55 lines (35 loc) · 1.52 KB

tar.md

File metadata and controls

55 lines (35 loc) · 1.52 KB

XModule Reference: tar

Create repositories from "tarballs" with tar

Main target rules

  • xrepo
    Construct an XREPO Repository target from the tar file.

Features

Tar

  • <xtar-arg> option
    tar tool receives option arguments when executed on XTAR source.
    Consult your system's tar manpage for valid options.

XModule

  • <xworkspace> and related features
    By default, the workspace for a tar XREPO target is invariant.
    It has an implicit <xinvariant>.* property.

  • <xpatch> patch-file

  • <xaction> @rule-or-action

Notes

Compression

The tar utility will determine which decompression type to use, if any, automatically from the tar file via the -f arg.

Curl

The ability to create repositories with tar is not terribly useful alone. It is, however, especially useful when combined with the curl utility. Since XCURL_URL sources are resolved to their downloaded type automatically, you can use a URL to a tarball directly.

Example:

xrepo myrepo 
    : https://host.tld/path/project-4.3.tar.xz 
    : <xtar-arg>"--strip-components 1" # remove initial path component (project-X.X)
    ;

Logs

  • workspace/tar-file-name.untar-log

Boost.Build Type Reference

Type Base Type Infer from source Generate from
XTAR *.tar, *.tar.*, *.tgz, *.zip
XREPO XMODULE XTAR