OpenPKG Specs: openpkg/rpm-config.pod@78e7deb1d6ab

Correct and improve many buildconf and code logic blocks. In particular:
1. Document potential problems building with current binutils releases.
2. Document the flawed webkit and explain its temporary exclusion.
3. Document the edition of Qt which is built and installed.
4. Remove the Solaris x11_supdir logic as it is no longer found.
5. Correct several .pr[io] files including QMAKE_CXXFLAGS and INCPATH,
which previously caused preexisting Qt installations to deliver
erroneous old include and library logic instead of relying on
that of the currently building package. -I/opkg/include is now
placed at the end of the compile statements.
6. Don't trust the QMAKE_[INC|LIB]DIR_X11 identifiers in qmake.conf.
7. Allow more 64-bit builds and more properly identify the platform.
8. Place plugins (which are shared objects) in lib instead of share.
9. Build components as plugins when possible if with_shared is enabled.
10. Translate German text to English to be more consistent.
11. Instead of removing the pkgconfig directory of with_shared builds,
place it in a child directory useful for shared building.
12. Document the nonstandard shared build directory structure,
including using the hidden pkgconfig directory (PKG_CONFIG_PATH.)
13. Change %doc to specify files rather than directories in the RPM DB.

     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@78e7deb1d6ab

openpkg/rpm-config.pod