head	1.8;
access;
symbols
	XDS_0_9_3:1.8
	XDS_0_9_2:1.8
	XDS_0_9_1:1.7
	XDS_0_9_0:1.6;
locks; strict;
comment	@# @;


1.8
date	2005.06.02.18.51.44;	author rse;	state Exp;
branches;
next	1.7;

1.7
date	2004.09.12.17.32.14;	author rse;	state Exp;
branches;
next	1.6;

1.6
date	2003.02.17.12.36.02;	author rse;	state Exp;
branches;
next	1.5;

1.5
date	2002.03.17.10.25.53;	author rse;	state Exp;
branches;
next	1.4;

1.4
date	2002.01.02.17.13.44;	author rse;	state Exp;
branches;
next	1.3;

1.3
date	2001.08.13.19.48.02;	author rse;	state Exp;
branches;
next	1.2;

1.2
date	2001.08.12.11.31.45;	author rse;	state Exp;
branches;
next	1.1;

1.1
date	2001.08.09.21.19.28;	author rse;	state Exp;
branches;
next	;


desc
@@


1.8
log
@Bumped year in copyright messages for year 2005.
@
text
@##
##  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

@


1.7
log
@Bumped year in copyright messages for year 2004.
@
text
@d3 3
a5 3
##  Copyright (c) 2001-2004 Ralf S. Engelschall <rse@@engelschall.com>
##  Copyright (c) 2001-2004 The OSSP Project <http://www.ossp.org/>
##  Copyright (c) 2001-2004 Cable & Wireless <http://www.cw.com/>
@


1.6
log
@upgrade to standard OSSP copyright and bump year to 2003
@
text
@d3 3
a5 3
##  Copyright (c) 2001-2003 Ralf S. Engelschall <rse@@engelschall.com>
##  Copyright (c) 2001-2003 The OSSP Project <http://www.ossp.org/>
##  Copyright (c) 2001-2003 Cable & Wireless Germany <http://www.cw.com/de/>
@


1.5
log
@update texts
@
text
@d3 3
a5 2
##  Copyright (c) 2001-2002 The OSSP Project (http://www.ossp.org/)
##  Copyright (c) 2001-2002 Cable & Wireless Deutschland (http://www.cw.com/de/)
@


1.4
log
@bump copyright year
@
text
@d2 1
a2 1
##  XDS - OSSP Extensible Data Serialization Library
d6 2
a7 2
##  This file is part of OSSP XDS, an extensible data serialization
##  library which can be found at http://www.ossp.org/pkg/xds/.
d38 1
a38 1
OSSP XDS XDS_VERSION_STR
@


1.3
log
@Remove trailing whitespaces on all non-generated files.
@
text
@d3 2
a4 2
##  Copyright (c) 2001 The OSSP Project (http://www.ossp.org/)
##  Copyright (c) 2001 Cable & Wireless Deutschland (http://www.cw.com/de/)
@


1.2
log
@Hhmm... who has introduced ossp.com?!
Our project's domain is ossp.org, of course.
@
text
@d5 1
a5 1
##  
d8 1
a8 1
##  
d13 1
a13 1
##  
@


1.1
log
@Add xds-config stuff for building applications with OSSP XDS.
This will be installed with XDS soon...
@
text
@d7 1
a7 1
##  library which can be found at http://www.ossp.com/pkg/xds/.
@