From 01ac041bb94fa63fa9d41272f1e560a42b6cbbab Mon Sep 17 00:00:00 2001 From: Drew DeVault Date: Mon, 6 Jan 2020 16:23:24 -0500 Subject: [PATCH] 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). --- Make.rules | 5 +- Makefile | 2 +- doc/Makefile | 8 +++ doc/apk.8.scd | 167 ++++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 179 insertions(+), 3 deletions(-) create mode 100644 doc/Makefile create mode 100644 doc/apk.8.scd 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 ++ +Timo Teräs <_timo.teras@iki.fi_>