From 7e5ffbeb93cbb4f6af3d0325de1f288c98be7be2 Mon Sep 17 00:00:00 2001 From: Johannes Schauer Marin Rodrigues Date: Sat, 28 Oct 2023 15:24:51 +0200 Subject: [PATCH] use L<> in POD formatting --- mmdebstrap | 34 +++++++++++++++---------------- mmdebstrap-autopkgtest-build-qemu | 12 +++++------ 2 files changed, 23 insertions(+), 23 deletions(-) diff --git a/mmdebstrap b/mmdebstrap index d9f40bc..d9b5cee 100755 --- a/mmdebstrap +++ b/mmdebstrap @@ -6528,13 +6528,13 @@ Example: Minimizing the number of packages installed from experimental Change the default keyring to use by apt during the initial setup. This is similar to setting B and B using B<--aptopt> except that the latter setting will be permanently stored in the -chroot while the keyrings passed via <--keyring> will only be visible to apt as -run by B. Do not use B<--keyring> if apt inside the chroot needs to -know about your keys after the initial chroot creation by B. This -option is mainly intended for users who use B as a B -drop-in replacement. As such, it is probably not what you want to use if you -use B with more than a single mirror unless you pass it a directory -containing all the keyrings you need. +chroot while the keyrings passed via B<--keyring> will only be visible to apt +as run by B. Do not use B<--keyring> if apt inside the chroot needs +to know about your keys after the initial chroot creation by B. +This option is mainly intended for users who use B as a +B drop-in replacement. As such, it is probably not what you want to +use if you use B with more than a single mirror unless you pass it +a directory containing all the keyrings you need. By default, the local setting of B and B are used to choose the keyring used by apt as run by @@ -6570,7 +6570,7 @@ pointing to F. You do not need to use B<--keyring> or C if you placed the keys that apt needs to know about into F in the B<--setup-hook> -(which is before C runs), for example by using the +(which is before C runs), for example by using the B special hook. You also need to copy your keys into the chroot explicitly if the key you passed via C points to a location that is not otherwise populated during chroot creation (for example by installing a keyring package). @@ -6606,7 +6606,7 @@ additional packages. Package names are directly passed to apt and thus, you can use apt features like C, C, C, use a glob or regex for C, use apt patterns or pass a path to a .deb package file (see below for notes concerning passing the path to a .deb package file in -B mode). See apt(8) for the supported syntax. +B mode). See L for the supported syntax. The option can be specified multiple times and the packages are concatenated in the order in which they are given on the command line. If later list items are @@ -6870,9 +6870,9 @@ allow unprivileged use of chroot and creation of files that appear to be owned by the superuser inside the unshared namespace. A tarball created in this mode will be bit-by-bit identical to a tarball created with the B mode. With this mode, the only binaries that will run as the root user will be -B and B via their setuid bit. Running those +L and L via their setuid bit. Running those successfully requires F and F to have an entry for -your username. This entry was usually created by B already. +your username. This entry was usually created by L already. The unshared user will not automatically have access to the same files as you do. This is intentional and an additional security against unintended changes @@ -6882,8 +6882,8 @@ globally readable or writable directories or use special hooks like B and B. Besides the user namespace, the mount, pid (process ids), uts (hostname) and -ipc namespaces will be unshared as well. See the man pages of B -and B as well as the manual pages they are linking to. +ipc namespaces will be unshared as well. See the man pages of L +and L as well as the manual pages they are linking to. A directory chroot created with this mode will end up with wrong ownership information (seen from outside the unshared user namespace). For correct @@ -6919,7 +6919,7 @@ C. This mode will not work if maintainer scripts are unable to handle C correctly like the package B until version 0.132. This mode will also not work with a different libc inside the chroot than on the outside. See the section -B in B. +B in L. =item B @@ -6934,7 +6934,7 @@ dpkg-root-support usertag of debian-dpkg@lists.debian.org in the Debian bug tracking system. B: if this option is used carelessly with packages that do not support C, this mode can result in undesired changes to the system running B because maintainer-scripts will be run without -B. +L. =for TODO =item B @@ -7030,7 +7030,7 @@ of the filename extensions listed in the section B, or if I equals C<->, or if I is a named pipe (fifo) or if I is a character special file, then the B format will be chosen. If I ends with C<.squashfs> or C<.sqfs>, then the B format will -be chosen. If ends with C<.ext2> then the B format will be +be chosen. If I ends with C<.ext2> then the B format will be chosen. If none of these conditions apply, the B format will be chosen. @@ -7841,7 +7841,7 @@ update" as an error. =head1 SEE ALSO - debootstrap(8), debvm(1), bdebstrap(1) +L, L, L =cut diff --git a/mmdebstrap-autopkgtest-build-qemu b/mmdebstrap-autopkgtest-build-qemu index 17b78e6..6e2d147 100755 --- a/mmdebstrap-autopkgtest-build-qemu +++ b/mmdebstrap-autopkgtest-build-qemu @@ -27,10 +27,10 @@ B [I] B<--boot>=B I I< =head1 DESCRIPTION B is a mostly compatible drop-in replacement -for B(1) with two main differences: Firstly, it uses -B(1) instead of B(1) and thus is able to create QEMU disk +for L with two main differences: Firstly, it uses +L instead of L and thus is able to create QEMU disk images without requiring superuser privileges. Secondly, it uses -B(7) and thus only supports booting via EFI. +L and thus only supports booting via EFI. =head1 POSITIONAL PARAMETERS @@ -58,7 +58,7 @@ Debian derivative. =item B<--architecture>=I -Set the architecture for the virtual machine image, specified as a B(1) +Set the architecture for the virtual machine image, specified as a L architecture. If omitted, the host architecture is assumed. B<--arch>=I is an alias for this option. @@ -70,7 +70,7 @@ image as its first parameter. This script can them make any necesssary modifications to the root filesystem. The script must be a POSIX shell script, and should not depend on bash-specific -features. This script will be executed inside a B(1) call in the +features. This script will be executed inside a L call in the virtual machine root filesystem. =item B<--size>=I @@ -102,7 +102,7 @@ Passes an additional B<--keyring> parameter to B. =head1 SEE ALSO - B(1), B(1), B(1), B(1) +L, L, L, L =cut POD2MAN