ossp-pkg/xds/xds-config.pod
##
## OSSP xds - Extensible Data Serialization
## Copyright (c) 2001-2005 Ralf S. Engelschall <rse@engelschall.com>
## Copyright (c) 2001-2005 The OSSP Project <http://www.ossp.org/>
## Copyright (c) 2001-2005 Cable & Wireless <http://www.cw.com/>
##
## This file is part of OSSP xds, an extensible data serialization
## library which can be found at http://www.ossp.org/pkg/lib/xds/.
##
## Permission to use, copy, modify, and 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 ANY EXPRESSED OR IMPLIED
## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
## SUCH DAMAGE.
##
## xds-config.pod: XDS library build utility manual page
##
=pod
=head1 NAME
B<xds-config> - XDS library build utility
=head1 VERSION
OSSP xds XDS_VERSION_STR
=head1 SYNOPSIS
B<xds-config>
[B<--help>]
[B<--version>]
[B<--all>]
[B<--prefix>]
[B<--exec-prefix>]
[B<--bindir>]
[B<--libdir>]
[B<--includedir>]
[B<--mandir>]
[B<--datadir>]
[B<--acdir>]
[B<--cflags>]
[B<--ldflags>]
[B<--libs>]
[B<--libs++>]
=head1 DESCRIPTION
The B<xds-config> program is a little helper utility for easy configuring and
building applications based on the xds(3) library. It can be used to query the
C compiler and linker flags which are required to correctly compile and link
the application against the xds(3) library.
=head1 OPTIONS
B<xds-config> accepts the following options:
=over 4
=item B<--help>
Prints the short usage information.
=item B<--version>
Prints the version number and date of the installed xds(3) library.
=item B<--all>
Forces the output of all flags, that is, including extra flags which are not
B<XDS> specific.
=item B<--prefix>
Prints the installation prefix of architecture independent files
=item B<--exec-prefix>
Prints the installation prefix of architecture dependent files.
=item B<--bindir>
Prints the installation directory of binaries.
=item B<--libdir>
Prints the installation directory of libraries.
=item B<--includedir>
Prints the installation directory of include headers.
=item B<--mandir>
Prints the installation directory of manual pages.
=item B<--datadir>
Prints the installation directory of shared data.
=item B<--acdir>
Prints the installation directory of B<autoconf> data.
=item B<--cflags>
Prints the C compiler flags which are needed to compile the xds(3)-based
application. The output is usually added to the C<CFLAGS> variable of the
applications C<Makefile>.
=item B<--ldflags>
Prints the linker flags (C<-L>) which are needed to link the application with
the xds(3) library. The output is usually added to the C<LDFLAGS> variable of
the applications C<Makefile>.
=item B<--libs>
Prints the library flags (C<-l>) which are needed to link the application with
the C xds(3) library. The output is usually added to the C<LIBS> variable of the
applications C<Makefile>.
=back
=head1 EXAMPLE
CC = cc
CFLAGS = -O `xds-config --cflags`
LDFLAGS = `xds-config --ldflags`
LIBS = -lm `xds-config --libs`
all: foo
foo: foo.o
$(CC) $(LDFLAGS) -o foo foo.o $(LIBS)
foo.o: foo.c
$(CC) $(CFLAGS) -c foo.c
=head1 SEE ALSO
xds(3), cc(1).
=head1 AUTHOR
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
=cut
