SHTOOL-ARX.TMP(1)                    GNU Portable Shell Tool                    SHTOOL-ARX.TMP(1)



NAME
       shtool-arx - GNU shtool ar(1) extensional command

SYNOPSIS
       shtool arx [-t|--trace] [-C|--command cmd] op archive file [file ...]

DESCRIPTION
       shtool arx is a wrapper around the archiving tool ar(1). It provides the ability to create
       archives out of existing archives, i.e., if one of file matches ""*.a"", the archive
       member files of file are used instead of file itself.

       The trick of this command is the automatic handling of archive members which is especially
       interesting if one wants to construct a (usually top-level) library archive out of pre-
       built sub-library archives (usually staying inside subdirs) in a large source tree. For
       GNU libtool based projects, a similar functionality is provided by GNU libtool internally,
       too.

OPTIONS
       The following command line options are available.

       -t, --trace
           Shows the actually involved shell commands.

       -C, --command cmd
           Set the used ar(1) command to cmd instead of just "ar" (searched in $PATH).

EXAMPLE
        #   Makefile
        AR=ar
        RANLIB=ranlib
          :
        OBJS=foo.o bar.o
        LIBS=baz/libbaz.a quux/libquux.a
          :
        libfoo.a: $(OBJS) $(LIBS)
            shtool arx -C $(AR) rc libfoo.a $(OBJS) $(LIBS)
            $(RANLIB) libfoo.a

HISTORY
       The GNU shtool arx command was originally written by Ralf S.  Engelschall
       <rse AT engelschall.com> in 1999 for GNU shtool. It was prompted by need to build libraries
       out of sub-libraries inside the OSSP project.

SEE ALSO
       shtool(1), ar(1).



18-Jul-2008                                shtool 2.0.8                         SHTOOL-ARX.TMP(1)