1Install
2=======
3
4You will need an ANSI C compiler (like gcc) to compile this package.
5
6Just type `make', followed by `make install'.
7
8History
9=======
10
11The main difference with version 1.0 by Paul Vixie is that this
12version will not return directory names as being executables
13and that by default it will expand a leading "./" and "~/" to
14its full path on output.
15
16The -all option has been added in example of a version of which
17on Ultrix.  They use `-a' as option.
18
19The --read-alias idea has been copied from a version of which by
20Maarten Litmaath called `which-v6', he was using `-i' as option
21which stands for `interactive'.
22
23Manual page
24===========
25
26
27NAME
28       which - shows the full path of (shell) commands.
29
30SYNOPSIS
31       which [options] [--] programname [...]
32
33DESCRIPTION
34       Which takes one or more arguments. For each of its arguments it prints
35       to stdout the full path of the executables that would have been exe-
36       cuted when this argument had been entered at the shell prompt. It does
37       this by searching for an executable or script in the directories listed
38       in the environment variable PATH using the same algorithm as bash(1).
39
40       This man page is generated from the file which.texinfo.
41
42OPTIONS
43       --all, -a
44           Print all matching executables in PATH, not just the first.
45
46       --read-alias, -i
47           Read aliases from stdin, reporting matching ones on stdout. This is
48           useful in combination with using an alias for which itself. For
49           example
50           alias which='alias | which -i'.
51
52       --skip-alias
53           Ignore option `--read-alias', if any. This is useful to explicity
54           search for normal binaries, while using the `--read-alias' option
55           in an alias or function for which.
56
57       --read-functions
58           Read shell function definitions from stdin, reporting matching ones
59           on stdout. This is useful in combination with using a shell func-
60           tion for which itself.  For example:
61           which() { declare -f | which --read-functions $@ }
62           export -f which
63
64       --skip-functions
65           Ignore option `--read-functions', if any. This is useful to explic-
66           ity search for normal binaries, while using the `--read-functions'
67           option in an alias or function for which.
68
69       --skip-dot
70           Skip directories in PATH that start with a dot.
71
72       --skip-tilde
73           Skip directories in PATH that start with a tilde and executables
74           which reside in the HOME directory.
75
76       --show-dot
77           If a directory in PATH starts with a dot and a matching executable
78           was found for that path, then print "./programname" rather than the
79           full path.
80
81       --show-tilde
82           Output a tilde when a directory matches the HOME directory. This
83           option is ignored when which is invoked as root.
84       --version,-v,-V
85           Print version information on standard output then exit success-
86           fully.
87
88       --help
89           Print usage information on standard output then exit successfully.
90
91RETURN VALUE
92       Which returns the number of failed arguments, or -1 when no `program-
93       name' was given.
94
95EXAMPLE
96       The recommended way to use this utility is by adding an alias (C shell)
97       or shell function (Bourne shell) for which like the following:
98
99       [ba]sh:
100
101            which ()
102            {
103              (alias; declare -f) | /usr/bin/which --tty-only --read-alias --read-functions --show-tilde --show-dot $@
104            }
105            export -f which
106
107       [t]csh:
108
109            alias which 'alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde'
110
111       This will print the readable ~/ and ./ when starting  which  from  your
112       prompt, while still printing the full path when used from a script:
113
114            > which q2
115            ~/bin/q2
116            > echo `which q2`
117            /home/carlo/bin/q2
118
119
120BUGS
121       The  HOME  directory  is determined by looking for the HOME environment
122       variable, which aborts when this variable doesn't  exist.   Which  will
123       consider  two  equivalent  directories to be different when one of them
124       contains a path with a symbolic link.
125
126AUTHOR
127       Carlo Wood <carlo@gnu.org>
128
129SEE ALSO
130       bash(1)
131
132
133
134                                                                      WHICH(1)
135