diff options
author | Michael Kerrisk | 2016-12-03 21:13:59 +0100 |
---|---|---|
committer | Karel Zak | 2016-12-09 13:45:09 +0100 |
commit | 46f057ed37e06d74df3e2d4471cab935f9671edf (patch) | |
tree | 7f03098b2f4ec9100730a7fcd6620052346c9ce2 | |
parent | docs: renice(1): Remove obsolete BUGS text (diff) | |
download | kernel-qcow2-util-linux-46f057ed37e06d74df3e2d4471cab935f9671edf.tar.gz kernel-qcow2-util-linux-46f057ed37e06d74df3e2d4471cab935f9671edf.tar.xz kernel-qcow2-util-linux-46f057ed37e06d74df3e2d4471cab935f9671edf.zip |
docs: various pages: Format pathnames as italic (.I)
In the majority of pages, pathnames are formatted as Italic,
which is the norm. However, there are several cases where they
are formatted as bold. This patch fixes a number of those
exceptions.
Signed-off-by: Michael Kerrisk <mtk.man-pages@gmail.com>
-rw-r--r-- | disk-utils/cfdisk.8 | 2 | ||||
-rw-r--r-- | disk-utils/fsck.8 | 12 | ||||
-rw-r--r-- | lib/terminal-colors.d.5 | 6 | ||||
-rw-r--r-- | login-utils/chfn.1 | 2 | ||||
-rw-r--r-- | login-utils/last.1 | 6 | ||||
-rw-r--r-- | login-utils/login.1 | 6 | ||||
-rw-r--r-- | login-utils/sulogin.8 | 2 | ||||
-rw-r--r-- | misc-utils/getopt.1 | 4 | ||||
-rw-r--r-- | misc-utils/lsblk.8 | 2 | ||||
-rw-r--r-- | misc-utils/whereis.1 | 6 | ||||
-rw-r--r-- | sys-utils/fstab.5 | 2 | ||||
-rw-r--r-- | sys-utils/mount.8 | 10 | ||||
-rw-r--r-- | sys-utils/readprofile.8 | 12 | ||||
-rw-r--r-- | sys-utils/renice.1 | 2 | ||||
-rw-r--r-- | sys-utils/umount.8 | 6 | ||||
-rw-r--r-- | term-utils/agetty.8 | 10 |
16 files changed, 46 insertions, 44 deletions
diff --git a/disk-utils/cfdisk.8 b/disk-utils/cfdisk.8 index d6ad327fe..3a285205a 100644 --- a/disk-utils/cfdisk.8 +++ b/disk-utils/cfdisk.8 @@ -22,7 +22,7 @@ cfdisk \- display or manipulate a disk partition table .B cfdisk is a curses-based program for partitioning any block device. The default device is -.BR /dev/sda . +.IR /dev/sda . Note that .B cfdisk diff --git a/disk-utils/fsck.8 b/disk-utils/fsck.8 index 819c69f5b..c4a5ca1b0 100644 --- a/disk-utils/fsck.8 +++ b/disk-utils/fsck.8 @@ -36,7 +36,7 @@ If no filesystems are specified on the command line, and the option is not specified, .B fsck will default to checking filesystems in -.B /etc/fstab +.I /etc/fstab serially. This is equivalent to the .B \-As options. @@ -160,13 +160,13 @@ They must have the format If an options specifier is present, then only filesystems which contain .I fs-option in their mount options field of -.B /etc/fstab +.I /etc/fstab will be checked. If the options specifier is prefixed by a negation operator, then only those filesystems that do not have .I fs-option in their mount options field of -.B /etc/fstab +.I /etc/fstab will be checked. .sp For example, if @@ -174,7 +174,7 @@ For example, if appears in .IR fslist , then only filesystems listed in -.B /etc/fstab +.I /etc/fstab with the .B ro option will be checked. @@ -261,7 +261,7 @@ normally does not check whether the device actually exists before calling a filesystem specific checker. Therefore non-existing devices may cause the system to enter filesystem repair mode during boot if the filesystem specific checker returns a fatal error. The -.B /etc/fstab +.I /etc/fstab mount option .B nofail may be used to have @@ -373,7 +373,7 @@ environment variable is used to find filesystem checkers. .B FSTAB_FILE This environment variable allows the system administrator to override the standard location of the -.B /etc/fstab +.I /etc/fstab file. It is also useful for developers who are testing .BR fsck . .TP diff --git a/lib/terminal-colors.d.5 b/lib/terminal-colors.d.5 index f4217a5d8..98b6d1504 100644 --- a/lib/terminal-colors.d.5 +++ b/lib/terminal-colors.d.5 @@ -170,11 +170,11 @@ Any other use of the hash character is not interpreted as introducing a comment. .SH FILES -.B $XDG_CONFIG_HOME/terminal-colors.d +.I $XDG_CONFIG_HOME/terminal-colors.d .br -.B $HOME/.config/terminal-colors.d +.I $HOME/.config/terminal-colors.d .br -.B /etc/terminal-colors.d +.I /etc/terminal-colors.d .SH ENVIRONMENT .IP TERMINAL_COLORS_DEBUG=all diff --git a/login-utils/chfn.1 b/login-utils/chfn.1 index bf837eab6..0cb5f28b8 100644 --- a/login-utils/chfn.1 +++ b/login-utils/chfn.1 @@ -72,7 +72,7 @@ Display version information and exit. .SH CONFIG FILE ITEMS .B chfn reads the -.BR /etc\:/login.defs (5) +.IR /etc\:/login.defs (5) configuration file. Note that the configuration file could be distributed with another package (e.g. shadow-utils). The following configuration items are relevant for diff --git a/login-utils/last.1 b/login-utils/last.1 index 2b0c1e520..ccb889509 100644 --- a/login-utils/last.1 +++ b/login-utils/last.1 @@ -28,7 +28,7 @@ last, lastb \- show a listing of last logged in users .SH DESCRIPTION .B last searches back through the -.B /var/log/wtmp +.I /var/log/wtmp file (or the file designated by the .B \-f option) and displays a list of all users logged in (and out) since that @@ -61,7 +61,7 @@ will show a log of all the reboots since the log file was created. is the same as .BR last , except that by default it shows a log of the -.BR /var/log/btmp +.IR /var/log/btmp file, which contains all the bad login attempts. .SH OPTIONS .TP @@ -79,7 +79,7 @@ back into a hostname. Tell .B last to use a specific \fIfile\fR instead of -.BR /var/log/wtmp . +.IR /var/log/wtmp . The .B \-\-file option can be given multiple times, and all of the specified files will be diff --git a/login-utils/login.1 b/login-utils/login.1 index d74e96220..3043e3251 100644 --- a/login-utils/login.1 +++ b/login-utils/login.1 @@ -67,9 +67,9 @@ option is given), else it will be initialized to the terminal type on your tty. .PP Then the user's shell is started. If no shell is specified for the user in -.BR /etc\:/passwd , +.IR /etc\:/passwd , then -.B /bin\:/sh +.I /bin\:/sh is used. If there is no directory specified in .IR /etc\:/passwd , then @@ -136,7 +136,7 @@ Display version information and exit. .SH CONFIG FILE ITEMS .B login reads the -.BR /etc\:/login.defs (5) +.IR /etc\:/login.defs (5) configuration file. Note that the configuration file could be distributed with another package (e.g. shadow-utils). The following configuration items are relevant for diff --git a/login-utils/sulogin.8 b/login-utils/sulogin.8 index 9bc2effce..fbf8bca74 100644 --- a/login-utils/sulogin.8 +++ b/login-utils/sulogin.8 @@ -38,7 +38,7 @@ If the root account is locked and --force is specified, no password is required. .B sulogin will be connected to the current terminal, or to the optional \fItty\fR device that can be specified on the command line (typically -.BR /dev/console ). +.IR /dev/console ). .PP When the user exits from the single-user shell, or presses control\-D at the prompt, the system will continue to boot. diff --git a/misc-utils/getopt.1 b/misc-utils/getopt.1 index 62fd8aa87..06e1e54d9 100644 --- a/misc-utils/getopt.1 +++ b/misc-utils/getopt.1 @@ -416,9 +416,9 @@ if it is called with Example scripts for (ba)sh and (t)csh are provided with the .BR getopt (1) distribution, and are optionally installed in -.BR /usr/share/getopt/ +.IR /usr/share/getopt/ or -.BR /usr/share/doc/ +.IR /usr/share/doc/ in the util-linux subdirectory. .SH ENVIRONMENT .IP POSIXLY_CORRECT diff --git a/misc-utils/lsblk.8 b/misc-utils/lsblk.8 index 1450e92ca..c727351ea 100644 --- a/misc-utils/lsblk.8 +++ b/misc-utils/lsblk.8 @@ -134,7 +134,7 @@ The .B lsblk command needs to be able to look up each block device by major:minor numbers, which is done by using -.BR /sys/dev/block . +.IR /sys/dev/block . This sysfs block directory appeared in kernel 2.6.27 (October 2008). In case of problems with a new enough kernel, check that CONFIG_SYSFS was enabled at the time of the kernel build. diff --git a/misc-utils/whereis.1 b/misc-utils/whereis.1 index 6cdec70b2..ac2068d56 100644 --- a/misc-utils/whereis.1 +++ b/misc-utils/whereis.1 @@ -127,12 +127,12 @@ is specified, the option will output the hard-coded paths that the command was able to find on the system. .SH EXAMPLE To find all files in -.B /usr/\:bin +.I /usr/\:bin which are not documented in -.B /usr/\:man/\:man1 +.I /usr/\:man/\:man1 or have no source in -.BR /usr/\:src : +.IR /usr/\:src : .IP .B cd /usr/bin .br diff --git a/sys-utils/fstab.5 b/sys-utils/fstab.5 index ab32383be..30c2cd4ab 100644 --- a/sys-utils/fstab.5 +++ b/sys-utils/fstab.5 @@ -35,7 +35,7 @@ .SH NAME fstab \- static information about the filesystems .SH SYNOPSIS -.B /etc/fstab +.I /etc/fstab .SH DESCRIPTION The file .B fstab diff --git a/sys-utils/mount.8 b/sys-utils/mount.8 index 36e7ce650..d1ef9083f 100644 --- a/sys-utils/mount.8 +++ b/sys-utils/mount.8 @@ -57,7 +57,7 @@ mount \- mount a filesystem .SH DESCRIPTION All files accessible in a Unix system are arranged in one big tree, the file hierarchy, rooted at -.BR / . +.IR / . These files can be spread out over several devices. The .B mount command serves to attach the filesystem found on some device @@ -143,8 +143,10 @@ unique, especially if you move, share or copy the device. Use to verify that the UUIDs are really unique in your system. The recommended setup is to use tags (e.g.\& \fBLABEL=\fIlabel\fR) rather than -.B /dev/disk/by-{label,uuid,partuuid,partlabel} -udev symlinks in the /etc/fstab file. Tags are +.I /dev/disk/by-{label,uuid,partuuid,partlabel} +udev symlinks in the +.I /etc/fstab +file. Tags are more readable, robust and portable. The .BR mount (8) command internally uses udev @@ -418,7 +420,7 @@ to the other mirror. A slave mount receives propagation from its master, but not vice versa. A private mount carries no propagation abilities. An unbindable mount is a private mount which cannot be cloned through a bind operation. The detailed semantics are documented in -.B Documentation/filesystems/sharedsubtree.txt +.I Documentation/filesystems/sharedsubtree.txt file in the kernel source tree. Supported operations are: diff --git a/sys-utils/readprofile.8 b/sys-utils/readprofile.8 index c01e3ca69..59c930b3d 100644 --- a/sys-utils/readprofile.8 +++ b/sys-utils/readprofile.8 @@ -11,7 +11,7 @@ This manpage documents version 2.0 of the program. The .B readprofile command uses the -.B /proc/profile +.I /proc/profile information to print ascii data on standard output. The output is organized in three columns: the first is the number of clock ticks, the second is the name of the C function in the kernel where those @@ -42,7 +42,7 @@ only the decimal number is printed. .TP \fB\-m\fR, \fB\-\-mapfile\fR \fImapfile\fR Specify a mapfile, which by default is -.BR /usr/src/linux/System.map . +.IR /usr/src/linux/System.map . You should specify the map file on cmdline if your current kernel isn't the last one you compiled, or if you keep System.map elsewhere. If the name of the map file ends with `.gz' it is decompressed on the @@ -58,10 +58,10 @@ resets the profiling buffer, and requires superuser privileges. .TP \fB\-p\fR, \fB\-\-profile\fR \fIpro-file\fR Specify a different profiling buffer, which by default is -.B /proc/profile. +.IR /proc/profile . Using a different pro-file is useful if you want to `freeze' the kernel profiling at some time and read it later. The -.B /proc/profile +.I /proc/profile file can be copied using `cat' or `cp'. There is no more support for compressed profile buffers, like in .B readprofile-1.1, @@ -70,7 +70,7 @@ because the program needs to know the size of the buffer in advance. \fB\-r\fR, \fB\-\-reset\fR Reset the profiling buffer. This can only be invoked by root, because -.B /proc/profile +.I /proc/profile is readable by everybody but writable only by the superuser. However, you can make .B readprofile @@ -124,7 +124,7 @@ Request profiling at 2kHz per CPU, and reset the profiling buffer: .LP .B readprofile only works with an 1.3.x or newer kernel, because -.B /proc/profile +.I /proc/profile changed in the step from 1.2 to 1.3 .LP This program only works with ELF kernels. The change for a.out diff --git a/sys-utils/renice.1 b/sys-utils/renice.1 index c4b6834d5..7cd9e8909 100644 --- a/sys-utils/renice.1 +++ b/sys-utils/renice.1 @@ -100,7 +100,7 @@ else in the system wants to), 0 (the ``base'' scheduling priority), anything negative (to make things go very fast). .SH FILES .TP -.B /etc/passwd +.I /etc/passwd to map user names to user IDs .SH SEE ALSO .BR nice (1), diff --git a/sys-utils/umount.8 b/sys-utils/umount.8 index 8abfc1b67..96cfed061 100644 --- a/sys-utils/umount.8 +++ b/sys-utils/umount.8 @@ -202,14 +202,14 @@ Note that \fI/etc/mtab\fR is currently deprecated and helper= and another userspace mount options are maintained by libmount. .SH FILES .TP -.B /etc/mtab +.I /etc/mtab table of mounted filesystems (deprecated and usually replaced by symlink to /proc/mounts) .TP -.B /etc/fstab +.I /etc/fstab table of known filesystems .TP -.B /proc/self/mountinfo +.I /proc/self/mountinfo table of mounted filesystems generated by kernel. .SH ENVIRONMENT .IP LIBMOUNT_FSTAB=<path> diff --git a/term-utils/agetty.8 b/term-utils/agetty.8 index 3dbbb8944..fb7f1c176 100644 --- a/term-utils/agetty.8 +++ b/term-utils/agetty.8 @@ -405,19 +405,19 @@ This is thingol.orcan.dk (Linux i386 1.1.9) 18:29:30 .SH FILES .na .TP -.B /var/run/utmp +.I /var/run/utmp the system status file. .TP -.B /etc/issue +.I /etc/issue printed before the login prompt. .TP -.B /etc/os-release /usr/lib/os-release +.I /etc/os-release /usr/lib/os-release operating system identification data. .TP -.B /dev/console +.I /dev/console problem reports (if syslog(3) is not used). .TP -.B /etc/inittab +.I /etc/inittab \fIinit\fP(8) configuration file for SysV-style init daemon. .SH BUGS .ad |