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

NAME

6       shtool arx - GNU shtool ar(1) extensional command
7

SYNOPSIS

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

DESCRIPTION

12       shtool arx is a wrapper around the archiving tool ar(1). It provides
13       the ability to create archives out of existing archives, i.e., if one
14       of file matches ""*.a"", the archive member files of file are used
15       instead of file itself.
16
17       The trick of this command is the automatic handling of archive members
18       which is especially interesting if one wants to construct a (usually
19       top-level) library archive out of pre-built sub-library archives
20       (usually staying inside subdirs) in a large source tree. For GNU
21       libtool based projects, a similar functionality is provided by GNU
22       libtool internally, too.
23

OPTIONS

25       The following command line options are available.
26
27       -t, --trace
28           Shows the actually involved shell commands.
29
30       -C, --command cmd
31           Set the used ar(1) command to cmd instead of just "ar" (searched in
32           $PATH).
33

EXAMPLE

35        #   Makefile
36        AR=ar
37        RANLIB=ranlib
38          :
39        OBJS=foo.o bar.o
40        LIBS=baz/libbaz.a quux/libquux.a
41          :
42        libfoo.a: $(OBJS) $(LIBS)
43            shtool arx -C $(AR) rc libfoo.a $(OBJS) $(LIBS)
44            $(RANLIB) libfoo.a
45

HISTORY

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

SEE ALSO

53       shtool(1), ar(1).
54
55
56
5718-Jul-2008                      shtool 2.0.8                SHTOOL-ARX.TMP(1)