OpenPKG Specs: openpkg/rpm-config.pod@f4a0b439d0fb

Correct shared library and plugin link logic, as well as informal text.
Update file server URL, update build resource estimations, correct RPATH
logic, allow for qmake(1) static to shared library changes via CONFIG
argument, correct documentation broken title and index links, correct
shared library install path, install only one set of (correct) plugins,
install the designer shared library (as required by QtCreator), announce
features related to shared linking using qmake(1), and correclty
substitute hard coded paths in prl and la library files.

     1 ##

     2 ##  rpm-config -- OpenPKG RPM Library Build Utility

     3 ##  Copyright (c) 2000-2007 OpenPKG Foundation e.V. <http://openpkg.net/>

     4 ##  Copyright (c) 2000-2007 Ralf S. Engelschall <http://engelschall.com/>

     5 ##

     6 ##  Permission to use, copy, modify, and distribute this software for

     7 ##  any purpose with or without fee is hereby granted, provided that

     8 ##  the above copyright notice and this permission notice appear in all

     9 ##  copies.

    10 ##

    11 ##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED

    12 ##  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

    13 ##  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.

    14 ##  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR

    15 ##  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

    16 ##  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

    17 ##  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF

    18 ##  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

    19 ##  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,

    20 ##  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT

    21 ##  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

    22 ##  SUCH DAMAGE.

    23 ##

    24 ##  rpm-config.pod: manual page

    25 ##

    27 =pod

    29 =head1 NAME

    31 B<rpm-config> - OpenPKG RPM library build utility

    33 =head1 VERSION

    35 OpenPKG RPM RPM_VERSION

    37 =head1 SYNOPSIS

    39 B<rpm-config>

    40 [B<--help>]

    41 [B<--version>]

    42 [B<--cc>]

    43 [B<--cppflags>]

    44 [B<--cflags>]

    45 [B<--ldflags>]

    46 [B<--libs>]

    48 =head1 DESCRIPTION

    50 The B<rpm-config> program is a little helper utility for easy

    51 configuring and building applications based on the OpenPKG RPM library.

    52 It can be used to query the C compiler and linker flags which are

    53 required to correctly compile and link the application against the

    54 RPM library.

    56 =head1 OPTIONS

    58 B<rpm-config> accepts the following options:

    60 =over 4

    62 =item B<--help>

    64 Prints the short usage information.

    66 =item B<--version>

    68 Prints the version number and date of the installed RPM library.

    70 =item B<--cc>

    72 =item B<--cppflags>

    74 Prints the C pre-processor flags (C<-I>) which are needed to compile the

    75 RPM-based application. The output is usually added to the C<CPPFLAGS>

    76 variable of the applications C<Makefile>.

    78 =item B<--cflags>

    80 Prints the C compiler flags which are needed to compile the RPM-based

    81 application. The output is usually added to the C<CFLAGS> variable of the

    82 applications C<Makefile>.

    84 =item B<--ldflags>

    86 Prints the linker flags (C<-L>) which are needed to link the application with

    87 the RPM library. The output is usually added to the C<LDFLAGS> variable of

    88 the applications C<Makefile>.

    90 =item B<--libs>

    92 Prints the library flags (C<-l>) which are needed to link the application with

    93 the RPM library. The output is usually added to the C<LIBS> variable of the

    94 applications C<Makefile>.

    96 =back

    98 =head1 EXAMPLE

   100  CC       = `rpm-config --cc`

   101  CPPFLAGS = `rpm-config --cppflags`

   102  CFLAGS   = `rpm-config --cflags`

   103  LDFLAGS  = `rpm-config --ldflags`

   104  LIBS     = `rpm-config --libs`

   106  all: foo

   108  foo: foo.o

   109      $(CC) $(LDFLAGS) -o foo foo.o $(LIBS)

   111  foo.o: foo.c

   112      $(CC) $(CPPFLAGS) $(CFLAGS) -o foo.o -c foo.c

   114 =head1 SEE ALSO

   116 rpm(1), cc(1).

   118 =head1 AUTHOR

   120  Ralf S. Engelschall

   121  rse@engelschall.com

   122  www.engelschall.com

   124 =cut

OpenPKG Specs / file revision

openpkg/rpm-config.pod@f4a0b439d0fb

openpkg/rpm-config.pod