coreutils: pwd invocation

1 
1 19.1 ‘pwd’: Print working directory
1 ===================================
1 
1 ‘pwd’ prints the name of the current directory.  Synopsis:
1 
1      pwd [OPTION]...
1 
11    The program accepts the following options.  Also see ⇒Common
 options.
1 
1 ‘-L’
1 ‘--logical’
1      If the contents of the environment variable ‘PWD’ provide an
1      absolute name of the current directory with no ‘.’ or ‘..’
1      components, but possibly with symbolic links, then output those
1      contents.  Otherwise, fall back to default ‘-P’ handling.
1 
1 ‘-P’
1 ‘--physical’
1      Print a fully resolved name for the current directory.  That is,
1      all components of the printed name will be actual directory
1      names—none will be symbolic links.
1 
1    If ‘-L’ and ‘-P’ are both given, the last one takes precedence.  If
1 neither option is given, then this implementation uses ‘-P’ as the
1 default unless the ‘POSIXLY_CORRECT’ environment variable is set.
1 
1    Due to shell aliases and built-in ‘pwd’ functions, using an unadorned
1 ‘pwd’ interactively or in a script may get you different functionality
1 than that described here.  Invoke it via ‘env’ (i.e., ‘env pwd ...’) to
1 avoid interference from the shell.
1 
1    An exit status of zero indicates success, and a nonzero value
1 indicates failure.
1