From 16f2b17e2bb52856c43d1bb4f5e6affb558ceb67 Mon Sep 17 00:00:00 2001 From: Andreas Baumann Date: Tue, 2 Jan 2018 09:52:08 +0100 Subject: renamed to arch32 --- man/asp.1.txt | 123 ---------------------------------------------------- man/asp32.1.txt | 131 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 131 insertions(+), 123 deletions(-) delete mode 100644 man/asp.1.txt create mode 100644 man/asp32.1.txt (limited to 'man') diff --git a/man/asp.1.txt b/man/asp.1.txt deleted file mode 100644 index 7b984e3..0000000 --- a/man/asp.1.txt +++ /dev/null @@ -1,123 +0,0 @@ -///// -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 https://git.archlinux.org. It aims to provide a -replacement for abs which favors a sparse checkout. - -Commands --------- -The following commands are understood: - -*checkout* 'TARGET'...:: - Create a new git repository containing the full source and history - for each of the given targets. The new repository will pull from the - repository in '$ASPROOT' and must be updated separately after using - 'asp update'. If a checkout occurs on the same filesystem as '$ASPROOT', - most of the metadata can be hard linked, making this a relatively cheap - copy. - -*difflog* 'TARGET':: - Show the full revision history of the target, with file diffs. - -*disk-usage*:: - Report the approximate disk usage for locally tracked packages. - -*export* 'TARGET'...:: - 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. - -*help*:: - Display the command line usage and exit. - -*list-all*:: - List all known packages in the repositories. - -*list-arches* 'TARGET'...:: - List the architectures the given targets are available for. - -*list-local*:: - List all packages which are tracked locally. - -*list-repos* 'TARGET'...:: - List the repositories the given targets exist in. - -*log* 'TARGET':: - Show the revision history of the target. - -*ls-files* 'TARGET':: - List source files for the given target. - -*set-git-protocol* 'PROTOCOL':: - Set the protocol used to communicate with the remote git repositories. Must - be one of 'git', 'http', or 'https'. - -*shortlog* 'TARGET':: - Show a condensed revision history of the target. - -*show* 'TARGET' ['FILE']:: - Show the file content of the target, which may be in the format 'package' - or 'repository/package'. If an additional 'file' argument is provided, attempt - to display that file rather than the PKGBUILD. If the repository is not - specified, the file will be shown at the most recent revision (which may be - newer than what is in the repositories). - -*untrack* 'TARGET'...:: - Remove a remote tracking branch from the local repository. Disk usage for - the removed package(s) may not be freed until garbage collection has taken - place. - -*update* ['TARGET'...]:: - 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 '`${XDG_CACHE_HOME:-$HOME/.cache}/asp`'. - -*ASPCACHE*:: - Determines where cached data is stored. Defaults to '$ASPROOT/cache'. Data in - this directory can always be safely deleted. - -Authors -------- -Dave Reisner diff --git a/man/asp32.1.txt b/man/asp32.1.txt new file mode 100644 index 0000000..be089d4 --- /dev/null +++ b/man/asp32.1.txt @@ -0,0 +1,131 @@ +///// +vim:set ts=4 sw=4 syntax=asciidoc noet: +///// +asp32(1) +======== + +Name +---- +asp32 - Manage Arch Linux 32 build sources + +Synopsis +-------- +asp32 [options] command [targets...] + +Description +----------- +The original script can be found at https://github.com/falconindy/asp. +This is a fork for the specific needs of the Archlinux32 project +(https://www.archlinux32.org). + +Manage the version-controlled sources for the build scripts used to create Arch +Linux 32 packages. This program provides a thin wrapper over the svntogit +repositories hosted at https://git.archlinux.org and https://github.com/archlinux32/packages. +It aims to provide a replacement for abs which favors a sparse checkout. + +Commands +-------- +The following commands are understood: + +*checkout* 'TARGET'...:: + Create a new git repository containing the full source and history + for each of the given targets. The new repository will pull from the + repository in '$ASPROOT' and must be updated separately after using + 'asp32 update'. If a checkout occurs on the same filesystem as '$ASPROOT', + most of the metadata can be hard linked, making this a relatively cheap + copy. + +*difflog* 'TARGET':: + Show the full revision history of the target, with file diffs. + +*disk-usage*:: + Report the approximate disk usage for locally tracked packages. + +*export* 'TARGET'...:: + 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. + +*help*:: + Display the command line usage and exit. + +*list-all*:: + List all known packages in the repositories. + +*list-arches* 'TARGET'...:: + List the architectures the given targets are available for. + +*list-local*:: + List all packages which are tracked locally. + +*list-repos* 'TARGET'...:: + List the repositories the given targets exist in. + +*log* 'TARGET':: + Show the revision history of the target. + +*ls-files* 'TARGET':: + List source files for the given target. + +*set-git-protocol* 'PROTOCOL':: + Set the protocol used to communicate with the remote git repositories. Must + be one of 'git', 'http', or 'https'. + +*shortlog* 'TARGET':: + Show a condensed revision history of the target. + +*show* 'TARGET' ['FILE']:: + Show the file content of the target, which may be in the format 'package' + or 'repository/package'. If an additional 'file' argument is provided, attempt + to display that file rather than the PKGBUILD. If the repository is not + specified, the file will be shown at the most recent revision (which may be + newer than what is in the repositories). + +*untrack* 'TARGET'...:: + Remove a remote tracking branch from the local repository. Disk usage for + the removed package(s) may not be freed until garbage collection has taken + place. + +*update* ['TARGET'...]:: + 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 '`${XDG_CACHE_HOME:-$HOME/.cache}/asp32`'. + +*ASPCACHE*:: + Determines where cached data is stored. Defaults to '$ASPROOT/cache'. Data in + this directory can always be safely deleted. + +Authors +------- +Dave Reisner + +Motifications for Archlinux32 +----------------------------- +Andreas Baumann -- cgit v1.2.3-70-g09d2