summaryrefslogtreecommitdiffstats
path: root/sys-utils
diff options
context:
space:
mode:
authorMichael Kerrisk2016-12-03 21:13:59 +0100
committerKarel Zak2016-12-09 13:45:09 +0100
commit46f057ed37e06d74df3e2d4471cab935f9671edf (patch)
tree7f03098b2f4ec9100730a7fcd6620052346c9ce2 /sys-utils
parentdocs: renice(1): Remove obsolete BUGS text (diff)
downloadkernel-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>
Diffstat (limited to 'sys-utils')
-rw-r--r--sys-utils/fstab.52
-rw-r--r--sys-utils/mount.810
-rw-r--r--sys-utils/readprofile.812
-rw-r--r--sys-utils/renice.12
-rw-r--r--sys-utils/umount.86
5 files changed, 17 insertions, 15 deletions
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>