man: pc: discuss extensions and optional gating approach for hard dependency on extensions

feature/tap-sh
William Pitcock 2017-12-21 02:25:09 -06:00
parent a42f265c07
commit a7864d0111
1 changed files with 13 additions and 4 deletions

View File

@ -31,9 +31,9 @@ is an implementation.
.Ss FILE SYNTAX .Ss FILE SYNTAX
The The
.Nm .pc .Nm .pc
file follows a format inspired by RFC822. Comments are prefixed by an octothorpe file follows a format inspired by RFC822. Comments are prefixed by a pound sign,
(#), and variable assignment is similar to POSIX shell. Properties are defined hash sign or octothorpe (#), and variable assignment is similar to POSIX shell.
using RFC822-style stanzas. Properties are defined using RFC822-style stanzas.
.\" .\"
.Ss VARIABLES .Ss VARIABLES
.\" .\"
@ -54,7 +54,7 @@ There are three types of property:
.Bl -tag .Bl -tag
.\" .\"
.It Literal .It Literal
the property will be set to the text of the value. The property will be set to the text of the value.
.\" .\"
.It Dependency List .It Dependency List
The property will be set to a list of dependencies parsed from the The property will be set to a list of dependencies parsed from the
@ -118,6 +118,15 @@ Dependencies that may be provided by an alternate package. If a package cannot
found, the entire package collection is scanned for providers which can match the found, the entire package collection is scanned for providers which can match the
requested dependency. (optional; dependency list; pkgconf extension) requested dependency. (optional; dependency list; pkgconf extension)
.El .El
.Ss EXTENSIONS
Features that have been marked as a pkgconf extension are only guaranteed to work
with the pkgconf implementation of pkg-config. Other implementations may or may
not support the extensions.
.Pp
Accordingly, it is suggested that
.Nm .pc
files which absolutely depend on these extensions declare a requirement on the
pkgconf virtual.
.Sh EXAMPLES .Sh EXAMPLES
An example .pc file: An example .pc file:
.Bd -literal .Bd -literal