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:
parent
db14815f46
commit
37634d22e5
12 changed files with 30 additions and 6 deletions
|
@ -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]
|
||||||
|
|
|
@ -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]
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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]
|
||||||
|
|
|
@ -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*::
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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]
|
||||||
|
|
|
@ -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]
|
||||||
|
|
|
@ -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]
|
||||||
|
|
|
@ -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.
|
||||||
|
|
|
@ -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]
|
||||||
|
|
Loading…
Add table
Reference in a new issue