чување 9e5f9d2a349909149305bd2c1ff7266e79900453
родитељ 111cbf86460c0b06851a3891f03549deff9fea37
Аутор: Страхиња Радић <contact@strahinja.org>
Датум: Tue, 23 Aug 2022 19:26:33 +0200
README and manpage updates
Signed-off-by: Страхиња Радић <contact@strahinja.org>
Diffstat:
| M | README | | | 8 | ++++---- |
| M | mkpk.8 | | | 59 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++----- |
измењених датотека: 2, додавања: 58(+), брисања: 9(-)
diff --git a/README b/README
@@ -10,7 +10,7 @@ Prerequisites
* PRoot[1]
* sbase tar[2] + -n patch[3]
* xz
-* install, sed, sort, uniq, mv
+* install, sed, sort, uniq, mv…
* Plan9 mk, for example from [4]
@@ -23,12 +23,12 @@ Installation
mkpk helper usage (for admins/users)
------------------------------------
-# mkpk update # Pulls the galeb-mkfiles repository
+# mkpk update # Pulls the MKFILESREPO repository
# mkpk fetch foo # fetches the sources of foo to SRCBASEDIR
# mkpk build foo # builds the foo tarball and puts it into PKGDIR
# mkpk install foo # installs the built tarball
# mkpk list foo # lists files in the installed tarball
-# mkpk info foo # show information about the installed tarball
+# mkpk info foo # shows information about the installed tarball
# mkpk uninstall foo # uninstalls the package using the installed
# tarball as a filelist
# mkpk upgrade foo # upgrades the existing package, by running
@@ -63,7 +63,7 @@ $ doas mk package-install # installs the above to PKGDIR
[1]: https://proot-me.github.io/
-[2]: https://tools.suckless.org/sbase/
+[2]: https://core.suckless.org/sbase/
[3]: https://git.sr.ht/~strahinja/sbase/tree/master/item/patches/0001-Add-n-equivalent-of-no-recursion.patch
[4]: https://tools.suckless.org/9base/
[5]: https://git.sr.ht/~strahinja/table/
diff --git a/mkpk.8 b/mkpk.8
@@ -66,15 +66,32 @@ You can see the full list of relevant environment variables used by
.Nm
in the file
.Pa /lib/mkpk/defaults.mk
-(default location). Only some of the more interesting variables are listed here.
+(default location).
.Bl -tag -width ".Ev SRCMKFILES"
.It Ev mkpklib
Directory holding the library mkfiles. By default,
.Pa /lib/mkpk .
.
+.It Ev BINDDIRS
+Passed to PRoot as an argument. Defaults to
+.Fl "b /etc" ,
+which bind-mounts
+.Pa /etc
+when creating a package.
+.
.It Ev MKFILESREPO
URL of the repository with the mkfiles with information on how to build
-individual packages.
+individual packages. Defaults to galeb-mkfiles repository.
+.
+.It Ev NOBINDDIRS
+If set to 1, no directories will be bind-mounted by PRoot when creating a
+package.
+.
+.It Ev PKG
+Full name of a package, including the full version. For example,
+.Dq gcc-12.1.0-2
+or
+.Dq vim-9.0.135 .
.
.It Ev PKGBASE
Base name of a package. For example,
@@ -82,9 +99,41 @@ Base name of a package. For example,
or
.Dq vim .
.
-.It Ev PKG
-Full name of a package, including the full version. For example,
-.Dq gcc-12.1.0-2 .
+.It Ev PKGDB
+Package database; TSV file holding the names, versions and installation
+timestamps of all installed packages. By default,
+.Pa /pkg/pkgdb.tsv .
+.
+.It Ev SRCBASEDIR
+Base directory for source code. Defaults to
+.Pa /src .
+.
+.It Ev SRCDIRS
+Space-separated list of directories which are created by extracting archives.
+.
+.It Ev SRCCRDIRS
+Space-separated list of directories to be
+.Sm off
+.Sy cr No eated,
+.Sm on
+to which the archives are to be extracted. Useful when a source archive doesn't
+have a root directory like it should.
+.
+.It Ev SRCEXDIRS
+Space-separated list of directories to which the archive will be
+.Sm off
+.Sy ex No tracted.
+.Sm on
+An alternative to
+.Ev SRCCRDIRS ,
+when the directories already exist.
+.
+.It Ev SRCTODIRS
+Space-separated list of directories
+.Sy to
+which the directories from
+.Ev SRCDIRS
+will be renamed after extracting source archives.
.
.It Ev SRCMKFILES
Directory containing mkfiles. By default,
