add apk-index(8)

doc/Makefile

@@ -10,6 +10,7 @@ docs: $(obj)/apk.8 \
 	$(obj)/apk-del.8 \
 	$(obj)/apk-dot.8 \
 	$(obj)/apk-fix.8 \
+	$(obj)/apk-index.8 \
 	$(obj)/apk-info.8 \
 	$(obj)/apk-list.8 \
 	$(obj)/apk-policy.8 \

doc/apk-index.8.scd

@@ -0,0 +1,36 @@
+apk-index(8)
+
+# NAME
+
+apk index - create repository index file from packages
+
+# SYNOPSIS
+
+*apk index* [<_options_>...] _packages_...
+
+# DESCRIPTION
+
+*apk index* creates a repository index from a list of package files. See
+*apk-repositories*(8) for more information on repository indicies.
+
+Generally, the resulting index must be cryptographically signed before *apk*
+will accept it. See *abuild-sign*(1) for details.
+
+# OPTIONS
+
+*-d, --description* _TEXT_
+	Add a description to the index. Upstream, this is used to add version
+	information based on the git commit SHA of aports HEAD at the time of
+	index generation.
+
+*-o, --output* _FILE_
+	Output generated index to _FILE_.
+
+*-x, --index* _INDEX_
+	Read an existing index from _INDEX_ to speed up the creation of the new
+	index by reusing data when possible.
+
+# AUTHORS
+
+Natanael Copa <ncopa@alpinelinux.org>++
+Timo Teräs <_timo.teras@iki.fi_>