summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDan McGee <dan@archlinux.org>2011-03-23 07:43:58 +0100
committerDan McGee <dan@archlinux.org>2011-03-23 08:07:47 +0100
commit7d899910c5453162c1564dd4bbb1c728368280f8 (patch)
treeed6613cc8c624051fff7cfe20be521da4901f789
parent5eca2fbdf10d91274433635e2dde0dec3e3994a1 (diff)
downloadpacman-7d899910c5453162c1564dd4bbb1c728368280f8.tar.gz
pacman-7d899910c5453162c1564dd4bbb1c728368280f8.tar.xz
Documentation consistency fixes
Fix the way we were referring to paths (use ``), .pac* extensions (use ''), and other general things across our main manpages. Signed-off-by: Dan McGee <dan@archlinux.org>
-rw-r--r--doc/makepkg.8.txt6
-rw-r--r--doc/pacman.8.txt38
-rw-r--r--doc/pacman.conf.5.txt8
3 files changed, 26 insertions, 26 deletions
diff --git a/doc/makepkg.8.txt b/doc/makepkg.8.txt
index 164f404d..c59800c6 100644
--- a/doc/makepkg.8.txt
+++ b/doc/makepkg.8.txt
@@ -52,7 +52,7 @@ Options
Removes all cached source files from the directory specified in `SRCDEST`
in linkman:makepkg.conf[5].
-*--config* <`/path/to/config`>::
+*\--config* <file>::
Use an alternate config file instead of the `{sysconfdir}/makepkg.conf`
default.
@@ -118,7 +118,7 @@ Options
`\--noextract` option if you wish to tweak the files in src/ before
building.
-*-p* <`buildscript`>::
+*-p* <buildscript>::
Read the package script `buildscript` instead of the `PKGBUILD` default;
see linkman:PKGBUILD[5].
@@ -150,7 +150,7 @@ Options
remote builder, or a tarball upload. Because integrity checks are verified,
all source files of the package need to be present or downloadable.
-*\--pkg <`list`>*::
+*\--pkg <list>*::
Only build listed packages from a split package. The use of quotes is
necessary when specifying multiple packages. e.g. `--pkg "pkg1 pkg3"`
diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index 249c774e..b727269b 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -55,7 +55,7 @@ Operations
removed, in which case every package in that group will be removed.
Files belonging to the specified package will be deleted, and the
database will be updated. Most configuration files will be saved
- with a `.pacsave` extension unless the '\--nosave' option is used.
+ with a '.pacsave' extension unless the '\--nosave' option is used.
See <<RO,Remove Options>> below.
*-S, \--sync*::
@@ -115,16 +115,16 @@ greater than `1:3.6-1`.
Options
-------
-*-b, \--dbpath* <'path'>::
+*-b, \--dbpath* <path>::
Specify an alternative database location (a typical default is
- ``{localstatedir}/lib/pacman''). This should not be used unless you know what you are
+ `{localstatedir}/lib/pacman`). This should not be used unless you know what you are
doing. *NOTE*: if specified, this is an absolute path and the root path is
not automatically prepended.
-*-r, \--root* <'path'>::
- Specify an alternative installation root (default is ``/''). This should
- not be used as a way to install software into ``/usr/local'' instead of
- ``/usr''. This option is used if you want to install a package on a
+*-r, \--root* <path>::
+ Specify an alternative installation root (default is `/`). This should
+ not be used as a way to install software into `/usr/local` instead of
+ `/usr`. This option is used if you want to install a package on a
temporary mounted partition which is "owned" by another system.
*NOTE*: if database path or logfile are not specified on either the
command line or in linkman:pacman.conf[5], their default location will
@@ -133,23 +133,23 @@ Options
*-v, \--verbose*::
Output paths such as as the Root, Conf File, DB Path, Cache Dirs, etc.
-*\--arch* <'arch'>::
+*\--arch* <arch>::
Specify an alternate architecture.
-*\--cachedir* <'dir'>::
+*\--cachedir* <dir>::
Specify an alternative package cache location (a typical default is
- ``{localstatedir}/cache/pacman/pkg''). Multiple cache directories can be specified,
+ `{localstatedir}/cache/pacman/pkg`). Multiple cache directories can be specified,
and they are tried in the order they are passed to pacman. *NOTE*: this
is an absolute path, the root path is not automatically prepended.
-*\--config* <'file'>::
+*\--config* <file>::
Specify an alternate configuration file.
*\--debug*::
Display debug messages. When reporting bugs, this option is recommended
to be used.
-*\--logfile* <'file'>::
+*\--logfile* <file>::
Specify an alternate log file. This is an absolute path, regardless of
the installation root setting.
@@ -182,7 +182,7 @@ Transaction Options (apply to '-S', '-R' and '-U')
displayed. The default format string is "%l", which displays URLs with
'-S', filenames with '-U' and pkgname-pkgver with '-R'.
-*\--print-format* <'format'>::
+*\--print-format* <format>::
Specify a printf-like format to control the output of the '\--print'
operation. The possible attributes are: %n for pkgname, %v for pkgver,
%l for location, %r for repo and %s for size.
@@ -207,12 +207,12 @@ Upgrade Options (apply to '-S' and '-U')[[UO]]
as explicitly installed so it will not be removed by the '\--recursive'
remove operation.
-*\--ignore* <'package'>::
+*\--ignore* <package>::
Directs pacman to ignore upgrades of package even if there is one
available. Multiple packages can be specified by separating them
with a comma.
-*\--ignoregroup* <'group'>::
+*\--ignoregroup* <group>::
Directs pacman to ignore upgrades of all packages in 'group' even if
there is one available. Multiple groups can be specified by
separating them with a comma.
@@ -257,7 +257,7 @@ Query Options[[QO]]
database(s). Typically these are packages that were downloaded manually
and installed with '\--upgrade'.
-*-o, \--owns* <'file'>::
+*-o, \--owns* <file>::
Search for packages that own the specified file(s). The path can be
relative or absolute and one or more files can be specified.
@@ -276,7 +276,7 @@ Query Options[[QO]]
and missing files; a bare query will only show package names
rather than names and versions.
-*-s, \--search* <'regexp'>::
+*-s, \--search* <regexp>::
Search each locally-installed package for names or descriptions that
match `regexp`. When including multiple search terms, only packages
with descriptions matching ALL of those terms are returned.
@@ -302,7 +302,7 @@ Remove Options[[RO]]
*-n, \--nosave*::
Instructs pacman to ignore file backup designations. Normally, when a
file is removed from the system the database is checked to see if the
- file should be renamed with a ``.pacsave'' extension.
+ file should be renamed with a '.pacsave' extension.
*-s, \--recursive*::
Remove each target specified including all of their dependencies, provided
@@ -354,7 +354,7 @@ linkman:pacman.conf[5].
will only show package names and omit databases and versions; group will
only show package names and omit group names.
-*-s, \--search* <'regexp'>::
+*-s, \--search* <regexp>::
This will search each package in the sync databases for names or
descriptions that match `regexp`. When you include multiple search
terms, only packages with descriptions matching ALL of those terms will
diff --git a/doc/pacman.conf.5.txt b/doc/pacman.conf.5.txt
index cb4c5898..bfa07458 100644
--- a/doc/pacman.conf.5.txt
+++ b/doc/pacman.conf.5.txt
@@ -57,13 +57,13 @@ Options
*DBPath =* path/to/db/dir::
Overrides the default location of the toplevel database directory. A
- typical default is ``{localstatedir}/lib/pacman/''. Most users will not need to set
+ typical default is `{localstatedir}/lib/pacman/`. Most users will not need to set
this option. *NOTE*: if specified, this is an absolute path and the root
path is not automatically prepended.
*CacheDir =* path/to/cache/dir::
Overrides the default location of the package cache directory. A typical
- default is ``{localstatedir}/cache/pacman/pkg/''. Multiple cache directories can be
+ default is `{localstatedir}/cache/pacman/pkg/`. Multiple cache directories can be
specified, and they are tried in the order they are listed in the config
file. If a file is not found in any cache directory, it will be downloaded
to the first cache directory with write access. *NOTE*: this is an absolute
@@ -72,7 +72,7 @@ Options
*LogFile =* '/path/to/file'::
Overrides the default location of the pacman log file. A typical default
- is ``{localstatedir}/log/pacman.log''. This is an absolute path and the root directory
+ is `{localstatedir}/log/pacman.log`. This is an absolute path and the root directory
is not prepended.
*HoldPkg =* package ...::
@@ -149,7 +149,7 @@ Options
*UseSyslog*::
Log action messages through syslog(). This will insert log entries into
- ``{localstatedir}/log/messages'' or equivalent.
+ `{localstatedir}/log/messages` or equivalent.
*ShowSize*::
Display the size of individual packages for '\--sync' and '\--query' modes.