add checkout verb, to make bite-sized git repos

This allows you to create a repo as a child of asp's, which you can
modify as you wish, and continue to pull changes from after calling
'abs update'. One might create a new remote for this repo in which
to publish their own downstream branch.

1 files changed, 9 insertions, 1 deletions

diff --git a/man/asp.1.txt b/man/asp.1.txt
index f94fe8c..c318d3c 100644
--- a/man/asp.1.txt
+++ b/man/asp.1.txt
@@ -23,12 +23,20 @@ Commands
 --------
 The following commands are understood:
 
+*checkout*::
+	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
+	'abs 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*::
 	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
+	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'.