man: Use uniform line spacing between sections

Remove blank lines immediately following section headings.
Ensure two blank lines before the start of a new section.

Signed-off-by: Jason St. John <jstjohn@purdue.edu>
Signed-off-by: Allan McRae <allan@archlinux.org>
This commit is contained in:
Jason St. John 2014-08-07 00:43:19 -04:00 committed by Allan McRae
parent db14815f46
commit 37634d22e5
12 changed files with 30 additions and 6 deletions

View file

@ -322,7 +322,6 @@ underscore and the architecture name e.g., 'replaces_x86_64=()'.
Packaging Functions Packaging Functions
------------------- -------------------
In addition to the above directives, PKGBUILDs require a set of functions that In addition to the above directives, PKGBUILDs require a set of functions that
provide instructions to build and install the package. As a minimum, the provide instructions to build and install the package. As a minimum, the
PKGBUILD must contain a `package()` function which installs all the package's PKGBUILD must contain a `package()` function which installs all the package's
@ -379,6 +378,7 @@ variables for use during the build and install process:
located, which is usually the output of `$(pwd)` when makepkg is started. located, which is usually the output of `$(pwd)` when makepkg is started.
Use of this variable is deprecated and strongly discouraged. Use of this variable is deprecated and strongly discouraged.
Package Splitting Package Splitting
----------------- -----------------
makepkg supports building multiple packages from a single PKGBUILD. This is makepkg supports building multiple packages from a single PKGBUILD. This is
@ -401,6 +401,7 @@ An optional global directive is available when building a split package:
element in the `pkgname` array is used. The variable is not allowed to element in the `pkgname` array is used. The variable is not allowed to
begin with a hyphen. begin with a hyphen.
Install/Upgrade/Remove Scripting Install/Upgrade/Remove Scripting
-------------------------------- --------------------------------
Pacman has the ability to store and execute a package-specific script when it Pacman has the ability to store and execute a package-specific script when it
@ -448,6 +449,7 @@ The install script does not need to be specified in the source array. A
template install file is available in '{pkgdatadir}' as 'proto.install' for template install file is available in '{pkgdatadir}' as 'proto.install' for
reference with all of the available functions defined. reference with all of the available functions defined.
Using VCS Sources[[VCS]] Using VCS Sources[[VCS]]
------------------------ ------------------------
Building a developmental version of a package using sources from a version Building a developmental version of a package using sources from a version
@ -489,6 +491,7 @@ The source URL is divided into three components:
*svn*;; *svn*;;
revision revision
Example Example
------- -------
The following is an example PKGBUILD for the 'patch' package. For more The following is an example PKGBUILD for the 'patch' package. For more
@ -500,6 +503,7 @@ those using Arch Linux, consult the Arch Build System (ABS) tree.
include::PKGBUILD-example.txt[] include::PKGBUILD-example.txt[]
------------------------------- -------------------------------
See Also See Also
-------- --------
linkman:makepkg[8], linkman:pacman[8], linkman:makepkg.conf[5] linkman:makepkg[8], linkman:pacman[8], linkman:makepkg.conf[5]

View file

@ -16,7 +16,6 @@ Synopsis
Description Description
----------- -----------
'makepkg-template' is a script to ease the work of maintaining multiple similar 'makepkg-template' is a script to ease the work of maintaining multiple similar
PKGBUILDs. It allows you to move most of the code from the PKGBUILD into a PKGBUILDs. It allows you to move most of the code from the PKGBUILD into a
template file and uses markers to allow in-place updating of existing PKGBUILDs template file and uses markers to allow in-place updating of existing PKGBUILDs
@ -60,9 +59,9 @@ resulting PKGBUILD. If you use markers in a template, please set the version
you used/tested with in the start/input marker so other people can properly you used/tested with in the start/input marker so other people can properly
recreate from templates. recreate from templates.
Options Options
------- -------
*-p, \--input* <build script>:: *-p, \--input* <build script>::
Read the package script `build script` instead of the default. Read the package script `build script` instead of the default.
@ -75,6 +74,7 @@ Options
*\--template-dir* <dir>:: *\--template-dir* <dir>::
Change the dir where we are looking for template files. Change the dir where we are looking for template files.
Example PKGBUILD Example PKGBUILD
---------------- ----------------
@ -112,7 +112,6 @@ Example PKGBUILD
# template end; # template end;
See Also See Also
-------- --------
linkman:makepkg[8], linkman:PKGBUILD[5] linkman:makepkg[8], linkman:PKGBUILD[5]

View file

@ -33,6 +33,7 @@ building packages. If you wish to share your build output with others when
seeking help or for other purposes, you may wish to run "`LC_ALL=C makepkg`" so seeking help or for other purposes, you may wish to run "`LC_ALL=C makepkg`" so
your logs and output are not localized. your logs and output are not localized.
Options Options
------- -------
*-A, \--ignorearch*:: *-A, \--ignorearch*::
@ -262,6 +263,7 @@ Environment Variables
Specify a key to use when signing packages, overriding the GPGKEY setting Specify a key to use when signing packages, overriding the GPGKEY setting
in linkman:makepkg.conf[5] in linkman:makepkg.conf[5]
Configuration Configuration
------------- -------------
See linkman:makepkg.conf[5] for more details on configuring makepkg using the See linkman:makepkg.conf[5] for more details on configuring makepkg using the

View file

@ -261,6 +261,7 @@ Options
`.tar.lzo`, `.tar.lrz`, and `.tar.Z`. `.tar.lzo`, `.tar.lrz`, and `.tar.Z`.
Do not touch these unless you know what you are doing. Do not touch these unless you know what you are doing.
See Also See Also
-------- --------
linkman:makepkg[8], linkman:pacman[8], linkman:PKGBUILD[5] linkman:makepkg[8], linkman:pacman[8], linkman:PKGBUILD[5]

View file

@ -30,6 +30,7 @@ Invoking pacman-key consists of supplying an operation with any potential
options and targets to operate on. Depending on the operation, a 'target' may options and targets to operate on. Depending on the operation, a 'target' may
be a valid key identifier, filename, or directory. be a valid key identifier, filename, or directory.
Operations Operations
---------- ----------
*-a, \--add*:: *-a, \--add*::

View file

@ -13,6 +13,7 @@ Synopsis
-------- --------
'pacman' <operation> [options] [targets] 'pacman' <operation> [options] [targets]
Description Description
----------- -----------
Pacman is a package management utility that tracks installed packages on a Linux Pacman is a package management utility that tracks installed packages on a Linux
@ -176,6 +177,7 @@ Options
Bypass any and all ``Are you sure?'' messages. It's not a good idea to do Bypass any and all ``Are you sure?'' messages. It's not a good idea to do
this unless you want to run pacman from a script. this unless you want to run pacman from a script.
Transaction Options (apply to '-S', '-R' and '-U') Transaction Options (apply to '-S', '-R' and '-U')
-------------------------------------------------- --------------------------------------------------
*-d, \--nodeps*:: *-d, \--nodeps*::
@ -206,6 +208,7 @@ Transaction Options (apply to '-S', '-R' and '-U')
operation. The possible attributes are: "%n" for pkgname, "%v" for pkgver, operation. The possible attributes are: "%n" for pkgname, "%v" for pkgver,
"%l" for location, "%r" for repository, and "%s" for size. Implies '\--print'. "%l" for location, "%r" for repository, and "%s" for size. Implies '\--print'.
Upgrade Options (apply to '-S' and '-U')[[UO]] Upgrade Options (apply to '-S' and '-U')[[UO]]
-------------------------------------------- --------------------------------------------
*\--force*:: *\--force*::
@ -474,6 +477,7 @@ pacman -Syu gpm::
Update package list, upgrade all packages, and then install gpm if it Update package list, upgrade all packages, and then install gpm if it
wasn't already installed. wasn't already installed.
Configuration Configuration
------------- -------------
See linkman:pacman.conf[5] for more details on configuring pacman using the See linkman:pacman.conf[5] for more details on configuring pacman using the

View file

@ -199,6 +199,7 @@ Options
Displays name, version and size of target packages formatted Displays name, version and size of target packages formatted
as a table for upgrade, sync and remove operations. as a table for upgrade, sync and remove operations.
Repository Sections Repository Sections
------------------- -------------------
Each repository section defines a section name and at least one location where Each repository section defines a section name and at least one location where
@ -329,6 +330,7 @@ The built-in default is the following:
SigLevel = Optional TrustedOnly SigLevel = Optional TrustedOnly
-------- --------
Using Your Own Repository Using Your Own Repository
------------------------- -------------------------
If you have numerous custom packages of your own, it is often easier to generate If you have numerous custom packages of your own, it is often easier to generate

View file

@ -13,6 +13,7 @@ Synopsis
-------- --------
'pactree' [options] package 'pactree' [options] package
Description Description
----------- -----------
Pactree produces a dependency tree for a package. Pactree produces a dependency tree for a package.
@ -20,6 +21,7 @@ Pactree produces a dependency tree for a package.
By default a tree like output is generated, but with the -g option a graphviz By default a tree like output is generated, but with the -g option a graphviz
description is generated. description is generated.
Options Options
------- -------
*-a, \--ascii*:: *-a, \--ascii*::
@ -59,6 +61,7 @@ Options
*\--config <file>*:: *\--config <file>*::
Specify an alternate pacman configuration file. Specify an alternate pacman configuration file.
See Also See Also
-------- --------
linkman:pacman[8], linkman:pacman.conf[5], linkman:makepkg[8] linkman:pacman[8], linkman:pacman.conf[5], linkman:makepkg[8]

View file

@ -25,6 +25,7 @@ significantly.
'pkgdelta' requires linkman:xdelta3[1] to do its job. 'pkgdelta' requires linkman:xdelta3[1] to do its job.
Options Options
------- -------
*--max-delta-size <ratio>*:: *--max-delta-size <ratio>*::
@ -41,11 +42,13 @@ Options
*-q, \--quiet*:: *-q, \--quiet*::
Be quiet. Do not output anything but warnings and errors. Be quiet. Do not output anything but warnings and errors.
Examples Examples
-------- --------
$ pkgdelta libreoffice-3.3.2-1-x86_64.pkg.tar.xz libreoffice-3.3.2-2-x86_64.pkg.tar.xz $ pkgdelta libreoffice-3.3.2-1-x86_64.pkg.tar.xz libreoffice-3.3.2-2-x86_64.pkg.tar.xz
See Also See Also
-------- --------
linkman:pacman[8], linkman:xdelta3[1] linkman:pacman[8], linkman:xdelta3[1]

View file

@ -8,6 +8,7 @@ Name
---- ----
repo-add - package database maintenance utility repo-add - package database maintenance utility
Synopsis Synopsis
-------- --------
'repo-add' [options] <path-to-db> <package|delta> [<package|delta> ...] 'repo-add' [options] <path-to-db> <package|delta> [<package|delta> ...]
@ -82,9 +83,9 @@ repo-add Options
Remove old package files from the disk when updating their entry in the Remove old package files from the disk when updating their entry in the
database. database.
Example Example
------- -------
'repo-add' is often invoked twice to create two separate databases; a smaller 'repo-add' is often invoked twice to create two separate databases; a smaller
database used by pacman and a large database containing package file lists for database used by pacman and a large database containing package file lists for
use by other utilities. use by other utilities.
@ -95,6 +96,7 @@ use by other utilities.
While pacman can use the large database (if given a db.tar* extension), there While pacman can use the large database (if given a db.tar* extension), there
is currently no additional benefit for the larger download. is currently no additional benefit for the larger download.
See Also See Also
-------- --------
linkman:makepkg[8], linkman:pacman[8], linkman:pkgdelta[8] linkman:makepkg[8], linkman:pacman[8], linkman:pkgdelta[8]

View file

@ -8,9 +8,9 @@ please try to follow as much as you can.
NOTE: Some of this is paraphrased from the kernel documentation's NOTE: Some of this is paraphrased from the kernel documentation's
"SubmittingPatches" file. "SubmittingPatches" file.
Getting the most recent source Getting the most recent source
------------------------------ ------------------------------
Patches need to be submitted in GIT format and are best if they are against the Patches need to be submitted in GIT format and are best if they are against the
latest version of the code. There are several helpful tutorials for getting latest version of the code. There are several helpful tutorials for getting
started with GIT if you have not worked with it before. started with GIT if you have not worked with it before.

View file

@ -47,6 +47,7 @@ Options
Display syntax for the given operation. If no operation was supplied Display syntax for the given operation. If no operation was supplied
then the general syntax is shown. then the general syntax is shown.
Examples Examples
-------- --------
@ -65,10 +66,12 @@ Examples
$ vercmp 4.34 1:001 $ vercmp 4.34 1:001
-1 -1
Configuration Configuration
------------- -------------
There is none. There is none.
See Also See Also
-------- --------
linkman:pacman[8], linkman:makepkg[8], linkman:libalpm[3] linkman:pacman[8], linkman:makepkg[8], linkman:libalpm[3]