openpkg/rpm-config.pod@4f973c756446
openpkg/rpm-config.pod
Fri, 15 Oct 2010 18:46:25 +0200
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Fri, 15 Oct 2010 18:46:25 +0200
- changeset 261
- 4f973c756446
- child 428
- f880f219c566
- permissions
- -rw-r--r--
Update copyright, file server URL, modify doc and link logic.
Now documentation is installed by default to the correct path,
and QtCreator links against Qt shared libraries instead of Qt
static libraries. This unfortunate change supports Nokia's
unfortunate decision to poorly support static linking in Qt.
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
