manual/GNU_coreutils/original/man1/dirname.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
   2 .TH DIRNAME "1" "May 2014" "GNU coreutils 8.22" "User Commands"
   3 .SH NAME
   4 dirname \- strip last component from file name
   5 .SH SYNOPSIS
   6 .B dirname
   7 [\fIOPTION\fR] \fINAME\fR...
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Output each NAME with its last non\-slash component and trailing slashes
  12 removed; if NAME contains no /'s, output '.' (meaning the current directory).
  13 .TP
  14 \fB\-z\fR, \fB\-\-zero\fR
  15 separate output with NUL rather than newline
  16 .TP
  17 \fB\-\-help\fR
  18 display this help and exit
  19 .TP
  20 \fB\-\-version\fR
  21 output version information and exit
  22 .SH EXAMPLES
  23 .TP
  24 dirname /usr/bin/
  25 \-> "/usr"
  26 .TP
  27 dirname dir1/str dir2/str
  28 \-> "dir1" followed by "dir2"
  29 .TP
  30 dirname stdio.h
  31 \-> "."
  32 .PP
  33 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  34 Report dirname translation bugs to <http://translationproject.org/team/>
  35 .SH AUTHOR
  36 Written by David MacKenzie and Jim Meyering.
  37 .SH COPYRIGHT
  38 Copyright \(co 2013 Free Software Foundation, Inc.
  39 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  40 .br
  41 This is free software: you are free to change and redistribute it.
  42 There is NO WARRANTY, to the extent permitted by law.
  43 .SH "SEE ALSO"
  44 basename(1), readlink(1)
  45 .PP
  46 The full documentation for
  47 .B dirname
  48 is maintained as a Texinfo manual.  If the
  49 .B info
  50 and
  51 .B dirname
  52 programs are properly installed at your site, the command
  53 .IP
  54 .B info coreutils \(aqdirname invocation\(aq
  55 .PP
  56 should give you access to the complete manual.