kc3-lang/pkgconf/man/pkgconf.1

Branch : - branch - master - tag - pkgconf-0.1 pkgconf-0.1.1 pkgconf-0.2 pkgconf-0.3 pkgconf-0.4 pkgconf-0.5 pkgconf-0.5.1 pkgconf-0.5.2 pkgconf-0.5.3 pkgconf-0.6 pkgconf-0.7 pkgconf-0.8 pkgconf-0.8.1 pkgconf-0.8.10 pkgconf-0.8.11 pkgconf-0.8.12 pkgconf-0.8.2 pkgconf-0.8.3 pkgconf-0.8.4 pkgconf-0.8.7 pkgconf-0.8.8 pkgconf-0.8.9 pkgconf-0.9.0 pkgconf-0.9.1 pkgconf-0.9.10 pkgconf-0.9.11 pkgconf-0.9.12 pkgconf-0.9.2 pkgconf-0.9.3 pkgconf-0.9.4 pkgconf-0.9.5 pkgconf-0.9.6 pkgconf-0.9.7 pkgconf-0.9.8 pkgconf-0.9.9 pkgconf-1 pkgconf-1.0.1 pkgconf-1.1.0 pkgconf-1.2.0 pkgconf-1.3.0 pkgconf-1.3.1 pkgconf-1.3.2 pkgconf-1.3.3 pkgconf-1.3.4 pkgconf-1.3.5 pkgconf-1.3.6 pkgconf-1.3.7 pkgconf-1.3.90 pkgconf-1.4.0 pkgconf-1.4.1 pkgconf-1.4.2 pkgconf-1.5.1 pkgconf-1.5.2 pkgconf-1.5.3 pkgconf-1.5.4 pkgconf-1.6.0 pkgconf-1.6.1 pkgconf-1.6.2 pkgconf-1.6.3 pkgconf-1.7.0 pkgconf-1.7.1 pkgconf-1.7.2 pkgconf-1.7.3 pkgconf-1.7.4 pkgconf-1.8.0 pkgconf-1.9.0 pkgconf-1.9.1 pkgconf-1.9.2 pkgconf-1.9.3 pkgconf-1.9.4 pkgconf-1.9.5 pkgconf-2.0.0 pkgconf-2.0.1 pkgconf-2.0.2 pkgconf-2.0.3 pkgconf-2.1.0 pkgconf-2.1.1 pkgconf-2.2.0 pkgconf-2.3.0 pkgconf-2.4.0 pkgconf-2.4.1 pkgconf-2.4.2 pkgconf-2.4.3 pkgconf-2.5.0 pkgconf-2.5.1

• Show log

  Commit

• Author : orbea
  Date : 2018-04-09 09:23:46
  Hash : 8d060b84
  Message : man: Silence more mandoc warnings man -Tlint pkgconf skipping no-space macro (mdoc) An input line begins with an Ns macro, or the next argument after an Ns macro is an isolated closing delimiter. The macro is ignored. unusual Xr order (mdoc) In the SEE ALSO section, an Xr macro with a lower section number follows one with a higher number, or two Xr macros referring to the same section are out of alphabetical order. man: pkgconf.1:114:16: WARNING: skipping no-space macro man: pkgconf.1:114:39: WARNING: skipping no-space macro man: pkgconf.1:119:14: WARNING: skipping no-space macro man: pkgconf.1:119:35: WARNING: skipping no-space macro man: pkgconf.1:119:56: WARNING: skipping no-space macro man: pkgconf.1:128:28: WARNING: skipping no-space macro man: pkgconf.1:147:24: WARNING: skipping no-space macro man: pkgconf.1:217:2: WARNING: unusual Xr order: pc(5) after pkg.m4(7) man -Tlint pc whitespace at end of input line (mdoc, man, roff) Whitespace at the end of input lines is almost never semantically significant -- but in the odd case where it might be, it is extremely confusing when reviewing and maintaining documents. new sentence, new line (mdoc) A new sentence starts in the middle of a text line. Start it on a new input line to help formatters produce correct spacing. missing -width in -tag list, using 8n (mdoc) Every Bl macro having the -tag argument requires -width, too. man: pc.5:17:76: STYLE: whitespace at end of input line man: pc.5:18:50: WARNING: new sentence, new line man: pc.5:49:67: WARNING: new sentence, new line man: pc.5:87:38: WARNING: new sentence, new line man: pc.5:90:27: WARNING: new sentence, new line man: pc.5:113:66: WARNING: new sentence, new line man: pc.5:117:61: WARNING: new sentence, new line man: pc.5:123:49: WARNING: new sentence, new line man: pc.5:56:2: WARNING: missing -width in -tag list, using 6n: Bl -tag man: pc.5:80:2: WARNING: missing -width in -tag list, using 6n: Bl -tag https://man.openbsd.org/mandoc.1

• man/pkgconf.1

• .\" Copyright (c) 2011, 2012, 2013, 2014, 2015, 2016 pkgconf authors (see AUTHORS).
  .\"
  .\" Permission to use, copy, modify, and/or distribute this software for any
  .\" purpose with or without fee is hereby granted, provided that the above
  .\" copyright notice and this permission notice appear in all copies.
  .\"
  .\" This software is provided 'as is' and without any warranty, express or
  .\" implied.  In no event shall the authors be liable for any damages arising
  .\" from the use of this software.
  .Dd November 15, 2016
  .Dt PKGCONF 1
  .Os
  .Sh NAME
  .Nm pkgconf
  .Nd a system for configuring build dependency information
  .Sh SYNOPSIS
  .Nm
  .Op Ar options
  .Op Ar list of modules
  .Sh DESCRIPTION
  .Nm
  is a program which helps to configure compiler and linker flags for
  development libraries.
  This allows build systems to detect other dependencies and use them with the
  system toolchain.
  .Sh GENERAL OPTIONS
  .Bl -tag -width indent
  .It Fl -version
  Display the supported pkg-config version and exit.
  .It Fl -atleast-pkgconfig-version Ns = Ns Ar VERSION
  Exit with error if we do not support the requested pkg-config version.
  .It Fl -errors-to-stdout
  Print all errors on the main output stream instead of the error output stream.
  .It Fl -silence-errors
  Do not display any errors at all.
  .It Fl -list-all
  Walk all directories listed in the
  .Va PKG_CONFIG_PATH
  environmental variable and display information on packages which have registered
  information there.
  .It Fl -simulate
  Simulates resolving a dependency graph based on the requested modules on the
  command line.
  Dumps a series of trees denoting pkgconf's resolver state.
  .It Fl -no-cache
  Skip caching packages when they are loaded into the internal resolver.
  This may result in an alternate dependency graph being computed.
  .It Fl -ignore-conflicts
  Ignore
  .Sq Conflicts
  rules in modules.
  .It Fl -env-only
  Learn about pkgconf's configuration strictly from environmental variables.
  .It Fl -maximum-traverse-depth Ns = Ns Ar DEPTH
  Impose a limit on the allowed depth in the dependency graph.
  For example, a depth of 2 will restrict the resolver from acting on child
  dependencies of modules added to the resolver's solution.
  .It Fl -static
  Compute a deeper dependency graph and use compiler/linker flags intended for
  static linking.
  .It Fl -pure
  Treats the computed dependency graph as if it were pure.
  This is mainly intended for use with the
  .Fl -static
  flag.
  .It Fl -no-provides
  Ignore
  .Sq Provides
  rules in modules when resolving dependencies.
  .It Fl -with-path Ns = Ns Ar PATH
  Adds a new module search path to pkgconf's dependency resolver.
  Paths added in this way are given preference before other paths.
  .It Fl -define-prefix
  Attempts to determine the prefix variable to use for CFLAGS and LIBS entry relocations.
  This is mainly useful for platforms where framework SDKs are relocatable, such as Windows.
  .It Fl -dont-define-prefix
  Disables the
  .Sq define-prefix
  feature.
  .It Fl -prefix-variable Ns = Ns Ar VARIABLE
  Sets the
  .Sq prefix
  variable used by the
  .Sq define-prefix
  feature.
  .It Fl -relocate Ns = Ns Ar PATH
  Relocates a path using the pkgconf_path_relocate API.
  This is mainly used by the testsuite to provide a guaranteed interface
  to the system's path relocation backend.
  .It Fl -dont-relocate-paths
  Disables the path relocation feature.
  .El
  .Sh MODULE-SPECIFIC OPTIONS
  .Bl -tag -width indent
  .It Fl -atleast-version Ns = Ns Ar VERSION
  Exit with error if a module's version is less than the specified version.
  .It Fl -exact-version Ns = Ns Ar VERSION
  Exit with error if a module's version is not exactly the specified version.
  .It Fl -max-version Ns = Ns Ar VERSION
  Exit with error if a module's version is greater than the specified version.
  .It Fl -exists
  Exit with a non-zero result if the dependency resolver was unable to find all of
  the requested modules.
  .It Fl -uninstalled
  Exit with a non-zero result if the dependency resolver uses an
  .Sq uninstalled
  module as part of it's solution.
  .It Fl -no-uninstalled
  Forbids the dependency resolver from considering 'uninstalled' modules as part
  of a solution.
  .El
  .Sh QUERY-SPECIFIC OPTIONS
  .Bl -tag -width indent
  .It Fl -cflags , Fl -cflags-only-I , Fl -cflags-only-other
  Display either all CFLAGS, only
  .Fl I
  CFLAGS or only CFLAGS that are not
  .Fl I .
  .It Fl -libs , Fl -libs-only-L , Fl -libs-only-l , Fl -libs-only-other
  Display either all linker flags, only
  .Fl L
  linker flags, only
  .Fl l
  linker flags or only linker flags that are not
  .Fl L
  or
  .Fl l .
  .It Fl -keep-system-cflags , Fl -keep-system-libs
  Keep CFLAGS or linker flag fragments that would be filtered due to being
  included by default in the compiler.
  .It Fl -define-variable Ns = Ns Ar VARNAME Ns = Ns Ar VALUE
  Define
  .Va VARNAME
  as
  .Va VALUE .
  Variables are used in query output, and some modules' results may change based
  on the presence of a variable definition.
  .It Fl -print-variables
  Print all seen variables for a module to the output channel.
  .It Fl -print-provides
  Print all relevant
  .Sq Provides
  entries for a module to the output channel.
  .It Fl -variable Ns = Ns Ar VARNAME
  Print the value of
  .Va VARNAME .
  .It Fl -print-requires , Fl -print-requires-private
  Print the modules included in either the
  .Va Requires
  field or the
  .Va Requires.private
  field.
  .It Fl -digraph
  Dump the dependency resolver's solution as a graphviz
  .Sq dot
  file.
  This can be used with graphviz to visualize module interdependencies.
  .It Fl -path
  Display the filenames of the
  .Sq .pc
  files used by the dependency resolver for a given dependency set.
  .It Fl -env Ns = Ns Ar VARNAME
  Print the requested values as variable declarations in a similar format as the
  .Xr env 1
  command.
  .It Fl -fragment-filter Ns = Ns Ar TYPES
  Filter the fragment lists for the specified types.
  .El
  .Sh ENVIRONMENT
  .Bl -tag -width indent
  .It Va PKG_CONFIG_PATH
  List of secondary directories where
  .Sq .pc
  files are looked up.
  .It Va PKG_CONFIG_LIBDIR
  List of primary directories where
  .Sq .pc
  files are looked up.
  .It Va PKG_CONFIG_SYSROOT_DIR
  .Sq sysroot
  directory, will be prepended to every path defined in
  .Va PKG_CONFIG_PATH .
  Useful for cross compilation.
  .It Va PKG_CONFIG_TOP_BUILD_DIR
  Provides an alternative setting for the
  .Sq pc_top_builddir
  global variable.
  .It Va PKG_CONFIG_PURE_DEPGRAPH
  If set, enables the same behaviour as the
  .Fl -pure
  flag.
  .It Va PKG_CONFIG_SYSTEM_INCLUDE_PATH
  List of paths that are considered system include paths by the toolchain.
  This is a pkgconf-specific extension.
  .It Va PKG_CONFIG_SYSTEM_LIBRARY_PATH
  List of paths that are considered system library paths by the toolchain.
  This is a pkgconf-specific extension.
  .It Va PKG_CONFIG_DISABLE_UNINSTALLED
  If set, enables the same behaviour as the
  .Fl -no-uninstalled
  flag.
  .It Va PKG_CONFIG_LOG
  .Sq logfile
  which is used for dumping audit information concerning installed module versions.
  .It Va PKG_CONFIG_DEBUG_SPEW
  If set, enables additional debug logging.
  The format of the debug log messages is implementation-specific.
  .It Va PKG_CONFIG_DONT_RELOCATE_PATHS
  If set, disables the path relocation feature.
  .El
  .Sh EXAMPLES
  Displaying the CFLAGS of a package:
  .Dl $ pkgconf --cflags foo
  .Dl -fPIC -I/usr/include/foo
  .Sh SEE ALSO
  .Xr pc 5 ,
  .Xr pkg.m4 7