From 4fbba0926a436d5f1fd75c7dd01c36fdf78e8baf Mon Sep 17 00:00:00 2001 From: Patrick McDermott Date: Sun, 28 Apr 2019 14:36:40 -0400 Subject: dev/prokit: Update for 2.0.0 And update manual pages, including new pages dev/prokit/prokit-installer-pc.8 and dev/prokit/prokit-mkinitramfs.8. --- diff --git a/dev/prokit.mdwn b/dev/prokit.mdwn index 9d6dc88..53a2fc2 100644 --- a/dev/prokit.mdwn +++ b/dev/prokit.mdwn @@ -14,7 +14,7 @@ programs of Debian and derivatives. Downloading =========== -The current version of prokit is [1.1.0][rel-ann]. +The current version of prokit is [2.0.0][rel-ann]. prokit can be found on the ProteanOS files site by [HTTP][dl-http] or [FTP][dl-ftp]. @@ -22,7 +22,7 @@ prokit can be found on the ProteanOS files site by [HTTP][dl-http] or prokit is maintained in a [Git repository][repo-http], which can be cloned from `git://git.proteanos.com/prokit/prokit.git`. -[rel-ann]: http://lists.proteanos.com/proteanos-dev/2014/10/msg00000.html +[rel-ann]: http://lists.proteanos.com/proteanos-dev/2019/04/msg00004.html [dl-http]: http://files.proteanos.com/pub/prokit/ [dl-ftp]: ftp://files.proteanos.com/pub/prokit/ [repo-http]: http://git.proteanos.com/prokit/prokit.git/ @@ -49,3 +49,5 @@ Pages in the ProteanOS Development Kit Manual: * [[**prokit-shell**(8)|dev/prokit/prokit-shell.8]] * [[**prokit-opkg**(8)|dev/prokit/prokit-opkg.8]] * [[**prokit-build**(8)|dev/prokit/prokit-build.8]] + * [[**prokit-prokit-installer-pc**(8)|dev/prokit/prokit-prokit-installer-pc.8]] + * [[**prokit-mkinitramfs**(8)|dev/prokit/prokit-mkinitramfs.8]] diff --git a/dev/prokit/prokit-build.8.mdwn b/dev/prokit/prokit-build.8.mdwn index fefa5fc..e7ad25f 100644 --- a/dev/prokit/prokit-build.8.mdwn +++ b/dev/prokit/prokit-build.8.mdwn @@ -1,4 +1,4 @@ -[[!meta title="prokit-build"]] +[[!meta title="PROKIT-BUILD"]] NAME
SYNOPSIS
@@ -13,8 +13,8 @@ -

prokit-build -− Build a package

+

prokit-build - +Build a package

SYNOPSIS @@ -22,8 +22,7 @@

prokit -build root-dir [option ...] -pkg-dir

+build root [option ...] pkg-dir

DESCRIPTION @@ -35,6 +34,10 @@ build runs opkbuild to build a package in an isolated file system environment, temporarily installing any missing build dependencies.

+

If root +is a block device node, the block device is mounted and +opkbuild is run in its file system.

+

options are opkbuild options. Run prokit build -h . for more information.

@@ -48,7 +51,7 @@ is a source package directory.

Copyright (C) -2014 Patrick "P. J." McDermott

+2014 Patrick McDermott

The ProteanOS Development Kit is free software: you can redistribute it diff --git a/dev/prokit/prokit-help.1.mdwn b/dev/prokit/prokit-help.1.mdwn index 733a358..f594457 100644 --- a/dev/prokit/prokit-help.1.mdwn +++ b/dev/prokit/prokit-help.1.mdwn @@ -1,4 +1,4 @@ -[[!meta title="prokit-help"]] +[[!meta title="PROKIT-HELP"]] NAME
SYNOPSIS
@@ -13,8 +13,8 @@

-

prokit-help -− Print help information

+

prokit-help - +Print help information

SYNOPSIS @@ -48,7 +48,7 @@ help [command].

Copyright (C) -2014 Patrick "P. J." McDermott

+2014 Patrick McDermott

The ProteanOS Development Kit is free software: you can redistribute it diff --git a/dev/prokit/prokit-install.8.mdwn b/dev/prokit/prokit-install.8.mdwn index 427f6a7..2f617d5 100644 --- a/dev/prokit/prokit-install.8.mdwn +++ b/dev/prokit/prokit-install.8.mdwn @@ -1,4 +1,4 @@ -[[!meta title="prokit-install"]] +[[!meta title="PROKIT-INSTALL"]] NAME
SYNOPSIS
@@ -15,7 +15,7 @@

prokit-install -− Install a system into a directory

+- Install a system into a directory

SYNOPSIS @@ -24,8 +24,7 @@

prokit install [-a arch] [-p plat] -[-m mirror] [-F] suite -root-dir

+[-m mirror] [-F] suite root

DESCRIPTION @@ -34,7 +33,11 @@ root-dir

prokit install installs a basic system of suite into -root-dir.

+root.

+ +

If root +is a block device node, the block device is mounted and a +system is installed into its file system.

suite can be a distribution like trunk; a channel and @@ -49,26 +52,25 @@ channel, and distribution like -

−a arch

+

-a arch

Install packages built for the arch architecture instead of automatically detecting the architecture of the running system.

- -

−p plat

+

-p plat

Install packages built for the plat platform instead of automatically choosing a default platform.

-

−m mirror

+

-m mirror

Download packages from mirror instead of automatically selecting one at random. mirror is a base URL like -http://mirror.gnu.dk/pub/proteanos.

+http://us.mirror.gnu.dk/pub/proteanos.

@@ -77,7 +79,7 @@ random. mirror is a base URL like +

-F

Copyright (C) -2014 Patrick "P. J." McDermott

+2014 Patrick McDermott

The ProteanOS Development Kit is free software: you can redistribute it diff --git a/dev/prokit/prokit-installer-pc.8.mdwn b/dev/prokit/prokit-installer-pc.8.mdwn new file mode 100644 index 0000000..7b32be9 --- /dev/null +++ b/dev/prokit/prokit-installer-pc.8.mdwn @@ -0,0 +1,122 @@ +[[!meta title="PROKIT-INSTALLER-PC"]] + +NAME
+SYNOPSIS
+DESCRIPTION
+OPTIONS
+EXAMPLES
+COPYRIGHT
+ +

+ + +

NAME + +

+ + + +

prokit-installer-pc +- Install a PC system onto a block device

+ +

SYNOPSIS + +

+ + +

prokit +installer-pc -a arch -p plat +[-m mirror] suite device

+ +

DESCRIPTION + +

+ + +

prokit +installer-pc installs a basic PC system of +suite onto device.

+ +

suite +can be a distribution like trunk; a channel and +distribution like dev/trunk; a profile and +distribution like proteanos:trunk; or a profile, +channel, and distribution like +proteanos:dev/trunk.

+ +

device +must be a block device file representing a whole storage +device, not a partition.

+ +

OPTIONS + +

+ + + +

-a arch

+ +

Install packages built for the +arch architecture.

+ +

-p plat

+ +

Install packages built for the +plat platform.

+ + +

-m mirror

+ +

Download packages from +mirror instead of automatically selecting one at +random. mirror is a base URL like +http://us.mirror.gnu.dk/pub/proteanos.

+ +

EXAMPLES + +

+ + +
-

−F

 @@ -92,7 +94,7 @@ for packages to be configured later.

+ + + + + +
+ + +

•

 + + +

# prokit installer-pc -a +i686-linux-glibc -p x60 dev/trunk /dev/sdb

+ +

COPYRIGHT + +

+ + +

Copyright (C) +2014, 2015 Patrick McDermott

+ +

The ProteanOS +Development Kit is free software: you can redistribute it +and/or modify it under the terms of the GNU General Public +License as published by the Free Software Foundation, either +version 3 of the License, or (at your option) any later +version.

+ +

The ProteanOS +Development Kit is distributed in the hope that it will be +useful, but WITHOUT ANY WARRANTY; without even the implied +warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR +PURPOSE. See the GNU General Public License for more +details.

+ +

You should have +received a copy of the GNU General Public License along with +the ProteanOS Development Kit. If not, see +<http://www.gnu.org/licenses/>.

+ diff --git a/dev/prokit/prokit-mkinitramfs.8.mdwn b/dev/prokit/prokit-mkinitramfs.8.mdwn new file mode 100644 index 0000000..0b5381d --- /dev/null +++ b/dev/prokit/prokit-mkinitramfs.8.mdwn @@ -0,0 +1,110 @@ +[[!meta title="PROKIT-MKINITRAMFS"]] + +NAME
+SYNOPSIS
+DESCRIPTION
+OPTIONS
+EXAMPLES
+COPYRIGHT
+ +
+ + +

NAME + +

+ + + +

prokit-mkinitramfs +- Generate an initramfs containing an installed system

+ +

SYNOPSIS + +

+ + +

prokit +mkinitramfs -l linux-output -i +initramfs-output root

+ +

DESCRIPTION + +

+ + +

prokit +mkinitramfs generates an initial RAM-based file +system image containing an installed system found at +root.

+ +

If root +is a block device node, the block device is mounted and the +initial RAM-based file system is generated from the +device’s file system.

+ +

OPTIONS + +

+ + + +

-l linux-output

+ +

Copy a Linux image from the +system at root to linux-output.

+ + +

-i initramfs-output

+ +

Write the initial RAM-based +file system image to initramfs-output.

+ +

EXAMPLES + +

+ + + + + + + + +
+ + +

•

 + + +

# prokit mkinitramfs -l vmlinuz +-i initrd.img $root

+ +

COPYRIGHT + +

+ + +

Copyright (C) +2016 Patrick McDermott

+ +

The ProteanOS +Development Kit is free software: you can redistribute it +and/or modify it under the terms of the GNU General Public +License as published by the Free Software Foundation, either +version 3 of the License, or (at your option) any later +version.

+ +

The ProteanOS +Development Kit is distributed in the hope that it will be +useful, but WITHOUT ANY WARRANTY; without even the implied +warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR +PURPOSE. See the GNU General Public License for more +details.

+ +

You should have +received a copy of the GNU General Public License along with +the ProteanOS Development Kit. If not, see +<http://www.gnu.org/licenses/>.

+ diff --git a/dev/prokit/prokit-opkg.8.mdwn b/dev/prokit/prokit-opkg.8.mdwn index 7fb3a30..2143aa0 100644 --- a/dev/prokit/prokit-opkg.8.mdwn +++ b/dev/prokit/prokit-opkg.8.mdwn @@ -1,4 +1,4 @@ -[[!meta title="prokit-opkg"]] +[[!meta title="PROKIT-OPKG"]] NAME
SYNOPSIS
@@ -13,8 +13,8 @@ -

prokit-opkg -− Manage packages with opkg

+

prokit-opkg - +Manage packages with opkg

SYNOPSIS @@ -22,8 +22,8 @@

prokit -opkg root-dir [option ...] -sub-command [argument ...]

+opkg root [option ...] sub-command +[argument ...]

DESCRIPTION @@ -34,6 +34,10 @@ opkg root-dir [option ...] opkg runs opkg in an isolated file system environment.

+

If root +is a block device node, the block device is mounted and +opkg is run in its file system.

+

options are opkg options and sub-command is an opkg sub-command. See the usage information for @@ -50,7 +54,7 @@ isolated system for installation.

Copyright (C) -2014 Patrick "P. J." McDermott

+2014 Patrick McDermott

The ProteanOS Development Kit is free software: you can redistribute it diff --git a/dev/prokit/prokit-shell.8.mdwn b/dev/prokit/prokit-shell.8.mdwn index f454a0f..7466403 100644 --- a/dev/prokit/prokit-shell.8.mdwn +++ b/dev/prokit/prokit-shell.8.mdwn @@ -1,4 +1,4 @@ -[[!meta title="prokit-shell"]] +[[!meta title="PROKIT-SHELL"]] NAME
SYNOPSIS
@@ -14,8 +14,8 @@

-

prokit-shell -− Run a shell in an isolated environment

+

prokit-shell - +Run a shell in an isolated environment

SYNOPSIS @@ -23,7 +23,7 @@

prokit -shell root-dir [command [argument +shell root [command [argument ...]]

DESCRIPTION @@ -36,6 +36,10 @@ shell starts a shell in an isolated file system environment (using chroot(8)) with basic file systems mounted.

+

If root +is a block device node, the block device is mounted and a +shell is started in its file system.

+

If a command is given (with optional arguments), it is executed in a non-interactive shell.

@@ -71,6 +75,17 @@ world

# prokit shell $root ’opkg install build-essential-$(cat /etc/proteanos_arch)’

+ + + + + +

•

+ + + + +

# prokit shell /dev/sdb1

COPYRIGHT @@ -79,7 +94,7 @@ build-essential-$(cat /etc/proteanos_arch)’

Copyright (C) -2014 Patrick "P. J." McDermott

+2014 Patrick McDermott

The ProteanOS Development Kit is free software: you can redistribute it diff --git a/dev/prokit/prokit-version.1.mdwn b/dev/prokit/prokit-version.1.mdwn index aa6cb4e..955d692 100644 --- a/dev/prokit/prokit-version.1.mdwn +++ b/dev/prokit/prokit-version.1.mdwn @@ -1,4 +1,4 @@ -[[!meta title="prokit-version"]] +[[!meta title="PROKIT-VERSION"]] NAME
SYNOPSIS
@@ -14,7 +14,7 @@

prokit-version -− Print version information

+- Print version information

SYNOPSIS @@ -42,7 +42,7 @@ information for prokit.

Copyright (C) -2014 Patrick "P. J." McDermott

+2014 Patrick McDermott

The ProteanOS Development Kit is free software: you can redistribute it diff --git a/dev/prokit/prokit.1.mdwn b/dev/prokit/prokit.1.mdwn index 4db796b..24d22ee 100644 --- a/dev/prokit/prokit.1.mdwn +++ b/dev/prokit/prokit.1.mdwn @@ -1,4 +1,4 @@ -[[!meta title="prokit"]] +[[!meta title="PROKIT"]] NAME
SYNOPSIS
@@ -15,7 +15,7 @@

-

prokit − +

prokit - ProteanOS Development Kit

SYNOPSIS @@ -49,7 +49,7 @@ program of Debian and derivatives.

-

−h

+

-h

@@ -62,7 +62,7 @@ program of Debian and derivatives.

-

−V

+

-V

@@ -104,13 +104,25 @@ environment

Build a package

+ +

prokit-installer-pc(8)

+ +

Install a PC system onto a +block device

+ + +

prokit-mkinitramfs(8)

+ +

Generate an initramfs +containing an installed system

+

COPYRIGHT

Copyright (C) -2014 Patrick "P. J." McDermott

+2014 Patrick McDermott

The ProteanOS Development Kit is free software: you can redistribute it -- cgit v0.9.1