mirror of
https://git.savannah.gnu.org/git/coreutils.git
synced 2026-11-17 18:02:09 +03:00
(basename invocation, dirname invocation):
Improve documentation to match recent // patches.
This commit is contained in:
1 parent
bbee8a57b0
commit
ee660c455a
1 file changed
+21
-2
+21
-2
@@ -10588,8 +10588,25 @@ basename @var{name} [@var{suffix}]
|
||||
@end example
|
||||
|
||||
If @var{suffix} is specified and is identical to the end of @var{name},
|
||||
it is removed from @var{name} as well. @command{basename} prints the
|
||||
result on standard output.
|
||||
it is removed from @var{name} as well. Note that since trailing slashes
|
||||
are removed prior to suffix matching, @var{suffix} will do nothing if it
|
||||
contains slashes. @command{basename} prints the result on standard
|
||||
output.
|
||||
|
||||
@c This test is used both here and in the section on dirname.
|
||||
@macro basenameAndDirname
|
||||
Together, @command{basename} and @command{dirname} are designed such
|
||||
that if @samp{ls "$name"} succeeds, then the command sequence @samp{cd
|
||||
"$(dirname "$name")"; ls "$(basename "$name")"} will, too. This works
|
||||
for everything except file names containing a trailing newline.
|
||||
|
||||
@acronym{POSIX} allows the implementation to define the results if
|
||||
@var{name} is empty or @samp{//}. In the former case, @acronym{GNU}
|
||||
@command{basename} returns the empty string. In the latter case, the
|
||||
result is @samp{//} on platforms where @var{//} is distinct from
|
||||
@var{/}, and @samp{/} on platforms where there is no difference.
|
||||
@end macro
|
||||
@basenameAndDirname
|
||||
|
||||
The only options are @option{--help} and @option{--version}. @xref{Common
|
||||
options}. Options must precede operands.
|
||||
@@ -10625,6 +10642,8 @@ dirname @var{name}
|
||||
If @var{name} is a single component, @command{dirname} prints @samp{.}
|
||||
(meaning the current directory).
|
||||
|
||||
@basenameAndDirname
|
||||
|
||||
The only options are @option{--help} and @option{--version}. @xref{Common
|
||||
options}.
|
||||
|
||||
|
||||
Reference in new issue
Block a user