+++ /dev/null
-\input texinfo @c -*-texinfo-*-
-@c %**start of header
-@setfilename which.info
-@settitle @command{which}: show full path of commands
-@include version.texi
-@dircategory System administration
-@direntry
-* Which: (which). Show full path of commands.
-@end direntry
-@c %**end of header
-
-@setchapternewpage odd
-
-@ifinfo
-@format
-
-@c !BEGIN INTRO
-This file documents `which' version 2.x@.
-@c !END INTRO
-
-@c !BEGIN COPYING
-Copyright @copyright{} 2000 - 2015, by
-
-Carlo Wood, Run on IRC <carlo@@alinoe.com>
-RSA-1024 0x624ACAD5 1997-01-26 Sign & Encrypt
-Fingerprint16 = 32 EC A7 B6 AC DB 65 A6 F6 F6 55 DD 1C DC FF 61
-
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-@end format
-
-@ignore
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that the
-section entitled ``GNU General Public License'' is included exactly as
-in the original, and provided that the entire resulting derived work is
-distributed under the terms of a permission notice identical to this
-one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions,
-except that the section entitled ``GNU General Public License'' may be
-included in a translation approved by the author instead of in the
-original English.
-@end ignore
-@c !END COPYING
-@end ifinfo
-
-@titlepage
-@title Which
-@subtitle Show the full path of commands
-@sp 1
-@subtitle Edition @value{EDITION}, for Which Version @value{VERSION}
-@subtitle @value{UPDATED}
-@c !BEGIN AUTHORS
-@author Carlo Wood <@email{carlo@@gnu.org}>
-@c !END AUTHORS
-@page
-@vskip 0pt plus 1filll
-Copyright @copyright{} 2000 - 2015, by
-
-Carlo Wood, Run on IRC <carlo@@alinoe.com>
-RSA-1024 0x624ACAD5 1997-01-26 Sign & Encrypt
-Fingerprint16 = 32 EC A7 B6 AC DB 65 A6 F6 F6 55 DD 1C DC FF 61
-
-@end titlepage
-
-@ifnottex
-@node Top, Which Program, (dir), (dir)
-@top @command{which}: Show the full path of commands
-@end ifnottex
-
-@ifinfo
-The @command{which} program
-@c !BEGIN NAME
-shows the full path of (shell) commands.
-@c !END NAME
-
-@noindent
-This file documents @command{which} version @value{VERSION}, updated @value{UPDATED}.
-@end ifinfo
-
-@menu
-* Which Program:: The @command{which} Program
-* Invoking Which:: How to invoke @command{which}
-* Option Summary:: Overview of commandline options
-* Return Value:: The return value of @command{which}
-* Example:: Examples of invokation
-* Bugs:: Known bugs
-* See Also:: Related UNIX commands
-* Index:: Index
-@end menu
-
-@node Which Program, Invoking Which, Top, Top
-@chapter The @command{which} Program
-@cindex Description of @command{which}
-
-@c !BEGIN DESCRIPTION
-@command{Which} takes one or more arguments. For each of its arguments
-it prints to stdout the full path of the executables
-that would have been executed when this argument had been
-entered at the shell prompt. It does this by searching
-for an executable or script in the directories listed in
-the environment variable @env{PATH} using the same algorithm as @command{bash(1)}.
-@c !END DESCRIPTION
-
-@node Invoking Which, Option Summary, Which Program, Top
-@chapter Invoking @command{which}
-@cindex Invoking @command{which}
-@cindex Synopsis
-
-@noindent
-The synopsis to invoke @command{which} is
-
-@c !BEGIN SYNOPSIS
-@example
-which [options] [--] programname [...]
-@end example
-@c !END SYNOPSIS
-
-@menu
-* Option Summary:: Option summary
-@end menu
-
-@node Option Summary, Return Value, Invoking Which, Top
-@chapter Option Summary
-@cindex Options, command line
-@cindex Command line Options
-@cindex Overview of command line options
-
-@c !BEGIN OPTIONS
-@table @samp
-@cindex @option{--all}
-@cindex @option{-a}
-@item --all
-@itemx -a
-Print all matching executables in @env{PATH}, not just the first.
-
-@cindex @option{--read-alias}
-@cindex @option{-i}
-@item --read-alias
-@itemx -i
-Read aliases from stdin, reporting matching ones on
-stdout. This is useful in combination with using an
-alias for which itself. For example@*
-@code{alias which='alias | which -i'}.
-
-@cindex @option{--skip-alias}
-@item --skip-alias
-Ignore option @option{--read-alias}, if any. This is useful to
-explicity search for normal binaries, while using
-the @option{--read-alias} option in an alias or function for which.
-
-@cindex @option{--read-functions}
-@item --read-functions
-Read shell function definitions from stdin, reporting matching
-ones on stdout. This is useful in combination with using a shell
-function for which itself. For example:@*
-@code{which() @{ declare -f | which --read-functions $@@ @}@*export -f which}
-
-@cindex @option{--skip-functions}
-@item --skip-functions
-Ignore option @option{--read-functions}, if any. This is useful to
-explicity search for normal binaries, while using
-the @option{--read-functions} option in an alias or function for which.
-
-@cindex @option{--skip-dot}
-@item --skip-dot
-Skip directories in @env{PATH} that start with a dot.
-
-@cindex @option{--skip-tilde}
-@item --skip-tilde
-Skip directories in @env{PATH} that start with a tilde and
-executables which reside in the @env{HOME} directory.
-
-@cindex @option{--show-dot}
-@item --show-dot
-If a directory in @env{PATH} starts with a dot and a matching
-executable was found for that path, then print
-"./programname" rather than the full path.
-
-@cindex @option{--show-tilde}
-@item --show-tilde
-Output a tilde when a directory matches the @env{HOME}
-directory. This option is ignored when which is
-invoked as root.
-
-@cindex @option{--tty-only}
-@item --tty-only
-Stop processing options on the right if not on tty.
-
-@cindex @option{--version}
-@cindex @option{-v}
-@cindex @option{-V}
-@item --version, -v, -V
-Print version information on standard output then exit
-successfully.
-
-@cindex @option{--help}
-@item --help
-Print usage information on standard output then exit
-successfully.
-
-@end table
-@c !END OPTIONS
-
-@node Return Value, Example, Option Summary, Top
-@chapter Return Value
-@cindex Return value of @command{which}
-
-@c !BEGIN RETURNVALUE
-@command{Which} returns the number of failed arguments, or -1 when
-no @file{programname} was given.
-@c !END RETURNVALUE
-
-@node Example, Bugs, Return Value, Top
-@chapter Example
-@cindex Examples
-@cindex aliases, handling of
-
-@c !BEGIN EXAMPLE
-The recommended way to use this utility is by adding an alias (C shell)
-or shell function (Bourne shell) for @command{which} like the following:
-
-[ba]sh:
-
-@example
-@group
-which ()
-@{
- (alias; declare -f) | /usr/bin/which --tty-only --read-alias --read-functions --show-tilde --show-dot $@@
-@}
-export -f which
-@end group
-@end example
-
-[t]csh:
-
-@example
-@group
-alias which 'alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde'
-@end group
-@end example
-
-@noindent
-This will print the readable ~/ and ./ when starting which
-from your prompt, while still printing the full path when
-used from a script:
-
-@example
-@group
-> which q2
-~/bin/q2
-> echo `which q2`
-/home/carlo/bin/q2
-@end group
-@end example
-@c !END EXAMPLE
-
-@node Bugs, See Also, Example, Top
-@chapter Bugs
-@cindex Bugs, known
-
-@c !BEGIN BUGS
-The @env{HOME} directory is determined by looking for the @env{HOME}
-environment variable, which aborts when this variable
-doesn't exist. @command{Which} will consider two equivalent directories
-to be different when one of them contains a path
-with a symbolic link.
-@c !END BUGS
-
-@node See Also, Index, Bugs, Top
-@chapter See Also
-
-@c !BEGIN SEEALSO
-@command{bash(1)}
-@c !END SEEALSO
-
-@node Index, , See Also, Top
-@comment node-name, next, previous, up
-@unnumbered Index
-
-@printindex cp
-
-@contents
-@bye
OSDN Git Service
