aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDrew DeVault <sir@cmpwn.com>2020-01-06 16:23:24 -0500
committerTimo Teräs <timo.teras@iki.fi>2020-01-26 09:01:26 +0200
commit01ac041bb94fa63fa9d41272f1e560a42b6cbbab (patch)
tree0f69cc1c963f5f591147226f1761ebadb5fafd69
parent980d2498779408a7ade3c49b5153bd8d2a446ad3 (diff)
downloadapk-tools-01ac041bb94fa63fa9d41272f1e560a42b6cbbab.tar.bz2
apk-tools-01ac041bb94fa63fa9d41272f1e560a42b6cbbab.tar.xz
Initial riggings for man pages, add apk(8)
This commit sets up the build system to compile man pages with scdoc, and adds the first man page: apk(8).
-rw-r--r--Make.rules5
-rw-r--r--Makefile2
-rw-r--r--doc/Makefile8
-rw-r--r--doc/apk.8.scd167
4 files changed, 179 insertions, 3 deletions
diff --git a/Make.rules b/Make.rules
index 7f33e0a..aab5f71 100644
--- a/Make.rules
+++ b/Make.rules
@@ -67,6 +67,7 @@ CROSS_COMPILE ?=
CC := $(CROSS_COMPILE)gcc
AR := $(CROSS_COMPILE)ar
LD := $(CROSS_COMPILE)ld
+SCDOC := scdoc
INSTALL := install
INSTALLDIR := $(INSTALL) -d
@@ -77,7 +78,7 @@ CFLAGS_ALL += $(CFLAGS)
LDFLAGS ?= -g
LDFLAGS_ALL += $(LDFLAGS)
-export CC AR LD INSTALL INSTALLDIR CFLAGS_ALL LDFLAGS_ALL
+export CC AR LD SCDOC INSTALL INSTALLDIR CFLAGS_ALL LDFLAGS_ALL
build :=
@@ -106,7 +107,7 @@ endif
##
# Rules and helpers
-PHONY += all compile install clean FORCE
+PHONY += all compile install clean docs FORCE
# Convinient variables
comma := ,
diff --git a/Makefile b/Makefile
index 98b565d..fdb6945 100644
--- a/Makefile
+++ b/Makefile
@@ -21,7 +21,7 @@ export DESTDIR SBINDIR LIBDIR CONFDIR MANDIR DOCDIR
##
# Top-level rules and targets
-targets := libfetch/ src/
+targets := libfetch/ src/ doc/
##
# Include all rules and stuff
diff --git a/doc/Makefile b/doc/Makefile
new file mode 100644
index 0000000..be37b7d
--- /dev/null
+++ b/doc/Makefile
@@ -0,0 +1,8 @@
+$(obj)/%.8: $(src)/%.8.scd
+ $(SCDOC) < $< > $@
+
+docs: $(obj)/apk.8
+targets += docs
+
+install: docs
+ # TODO
diff --git a/doc/apk.8.scd b/doc/apk.8.scd
new file mode 100644
index 0000000..2ae3d3b
--- /dev/null
+++ b/doc/apk.8.scd
@@ -0,0 +1,167 @@
+apk(8)
+
+# NAME
+
+apk - Alpine Package Keeper
+
+# SYNOPSIS
+
+*apk* [<_options_>...] _command_ [<_arguments_>...]
+
+# DESCRIPTION
+
+*apk* manages packages installed on the system. The set of installed packages
+is called the _world_ (see *apk-world*(5)). *apk* supports various sub-commands
+to query and manipulate _world_ and local & remote package repositories.
+
+# COMMANDS
+
+Each command is documented in detail on its manual page.
+
+## PACKAGE INSTALLATION AND REMOVAL
+
+|[ *apk-add*(8)
+:< Add packages to _world_ and commit changes
+| *apk-del*(1)
+: Remove packages from _world_ and commit changes
+
+## SYSTEM MAINTENANCE
+
+|[ *apk-fix*(8)
+:< Check _world_ against the system and ensure consistency
+| *apk-update*(8)
+: Update repository indexes
+| *apk-upgrade*(8)
+: Install upgrades available from repositories
+| *apk-cache*(8)
+: Commands related to the management of an offline package cache
+
+## QUERYING PACKAGE INFORMATION
+
+|[ *apk-info*(8)
+:< Give detailed information about packages or repositories
+| *apk-list*(8)
+: List packages by patterns or other criteria
+| *apk-dot*(8)
+: Generate graphviz graphs
+| *apk-policy*(8)
+: Show repository policy for packages
+
+## REPOSITORY MAINTENANCE
+
+|[ *apk-index*(8)
+:< Create repository index file from packages
+| *apk-fetch*(8)
+: Download packages from global repositories to a local directory
+| *apk-manifest*(8)
+: Show checksums of package contents
+| *apk-verify*(8)
+: Verify package integrity and signature
+
+## MISCELLANEOUS
+
+|[ *apk-audit*(8)
+:< Audit directories for changes
+| *apk-stats*(8)
+: Show statistics about repositories and installations
+| *apk-version*(8)
+: Compare package versions or perform tests on version strings
+
+# GLOBAL OPTIONS
+
+The following options are available for all commands.
+
+*-f, --force*
+ Enable selected --force-\* options (deprecated).
+
+*-i, --interactive*
+ Ask confirmation before performing certain operations.
+
+*-p, --root* <_DIR_>
+ Install packages to _DIR_.
+
+*-q, --quiet*
+ Print less information.
+
+*-U, --update-cache*
+ Alias for '--cache-max-age 1'.
+
+*-v, --verbose*
+ Print more information (can be specified twice).
+
+*-V, --version*
+ Print program version and exit.
+
+*-X, --repository* <_REPO_>
+ Use packages only from the specified repository.
+
+*--allow-untrusted*
+ Install packages with untrusted signature or no signature.
+
+*--arch* _ARCH_
+ Temporarily override architecture, to be combined with --root.
+
+*--cache-dir* _CACHEDIR_
+ Temporarily override the cache directory.
+
+*--cache-max-age* _AGE_
+ Maximum AGE (in minutes) for index in cache before it's refresh.
+
+*--force-binary-stdout*
+ Continue even if binary data will be printed to the terminal.
+
+*--force-broken-world*
+ Continue even if _world_ cannot be satisfied.
+
+*--force-non-repository*
+ Continue even if packages may be lost on reboot.
+
+*--force-old-apk*
+ Continue even if packages use unsupported features.
+
+*--force-overwrite*
+ Overwrite files in other packages.
+
+*--force-refresh*
+ Do not use cached files (local or from proxy).
+
+*--keys-dir* _KEYSDIR_
+ Override directory of trusted keys.
+
+*--no-cache*
+ Do not use any local cache path.
+
+*--no-network*
+ Do not use the network. The cache is still used when possible.
+
+*--no-progress*
+ Disable progress bar even for TTYs.
+
+*--print-arch*
+ Print default arch and exit.
+
+*--progress*
+ Show progress.
+
+*--progress-fd* _FD_
+ Write progress to the specified file descriptor.
+
+*--purge*
+ Delete modified configuration files on package removal and uninstalled
+ packages from cache on cache clean.
+
+*--repositories-file* _REPOFILE_
+ Override repositories file, see *apk-repositories*(8).
+
+*--wait* _TIME_
+ Wait for TIME seconds to get an exclusive repository lock before
+ failing.
+
+# NOTES
+
+This apk has coffee making abilities.
+
+# AUTHORS
+
+Natanael Copa <ncopa@alpinelinux.org>++
+Timo Teräs <_timo.teras@iki.fi_>