From ca642b0dad8c5ee1ec9d172eae534dacd79d9410 Mon Sep 17 00:00:00 2001 From: Dave Reisner Date: Sun, 27 Jul 2014 12:30:00 -0400 Subject: initial commit --- man/asp.1.txt | 92 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 man/asp.1.txt (limited to 'man') diff --git a/man/asp.1.txt b/man/asp.1.txt new file mode 100644 index 0000000..3a90780 --- /dev/null +++ b/man/asp.1.txt @@ -0,0 +1,92 @@ +///// +vim:set ts=4 sw=4 syntax=asciidoc noet: +///// +asp(1) +====== + +Name +---- +asp - Manage Arch Linux build sources + +Synopsis +-------- +asp [options] command [targets...] + +Description +----------- +Manage the version-controlled sources for the build scripts used to create Arch +Linux packages. This program provides a thin wrapper over the svntogit +repositories hosted at http://projects.archlinux.org. It aims to provide a +replacement for abs which favors a sparse checkout. + +Commands +-------- +The following commands are understood: + +*difflog*:: + Show the full revision history of the target, with file diffs. + +*export*:: + Dump the build source files for each target into a directory of the + target's name in $PWD. Targets can be specified simply as 'package' to + check out the source files at HEAD, or in 'repository/package' format + to checkout the source files which were used to push the 'package' which + exists in 'repository'. + +*gc*:: + Perform housekeeping procedures on the local repo, optimizing and + compacting the repo to free disk space. + +*disk-usage*:: + Report the approximate disk usage for locally tracked packages. + +*help*:: + Display the command line usage and exit. + +*list-all*:: + List all known packages in the repositories. + +*list-arches*:: + List the architectures the given targets are available for. + +*list-local*:: + List all packages which are tracked locally. + +*list-repos*:: + List the repositories the given targets exist in. + +*log*:: + Show the revision history of the target. + +*shortlog*:: + Show a condensed revision history of the target. + +*update*:: + For each target, if the package is not known to the local repository, + attempt to track it. If the package is tracked, update the package + to the newest version. If no targets are provided, all locally known + packages will be updated. + +Options +------- +*-a* 'architecture':: + When relevant, specify an architecture other than that of the current host. + +*-f*:: + Allow files to be overwritten. + +*-h*:: + Print a short help text and exit. + +*-V*:: + Print a short version string and exit. + +Environment +----------- +*ASPROOT*:: + Determines where the metadata is stored for locally tracked packages. Defaults + to '$HOME/asp'. + +Authors +------- +Dave Reisner -- cgit v1.2.3-54-g00ecf