From b2dec639457530aa167e1d9929cce2ed56f415fb Mon Sep 17 00:00:00 2001
From: vincentdarley <vincentdarley>
Date: Mon, 7 Jul 2003 08:57:58 +0000
Subject: file tail documentation clarification

---
 ChangeLog  |  4 ++++
 doc/file.n | 10 ++++++----
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 07809d9..21103fb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2003-06-23  Vince Darley  <vincentdarley@users.sourceforge.net>
+
+	* doc/file.n: clarification of 'file tail' behaviour [Bug 737977]
+
 2003-07-04  Donal K. Fellows  <fellowsd@cs.man.ac.uk>
 
 	* doc/expr.n: Tighten up the wording of some operations. [Bug 758488]
diff --git a/doc/file.n b/doc/file.n
index 3c46d88..ce699aa 100644
--- a/doc/file.n
+++ b/doc/file.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: file.n,v 1.24 2003/05/14 19:21:22 das Exp $
+'\" RCS: @(#) $Id: file.n,v 1.25 2003/07/07 08:57:58 vincentdarley Exp $
 '\" 
 .so man.macros
 .TH file n 8.3 Tcl "Tcl Built-In Commands"
@@ -393,9 +393,11 @@ not belong to any filesystem, an error is generated.
 .TP
 \fBfile tail \fIname\fR
 .
-Returns all of the characters in \fIname\fR after the last directory
-separator.  If \fIname\fR contains no separators then returns
-\fIname\fR.
+Returns all of the characters in the last filesystem component of
+\fIname\fR.  Any trailing directory separator in \fIname\fR is ignored.
+If \fIname\fR contains no separators then returns \fIname\fR.  So, 
+\fBfile tail a/b\fR, \fBfile tail a/b/\fR and \fBfile tail b\fR all
+return \fBb\fR.
 .TP
 \fBfile type \fIname\fR
 .
-- 
cgit v0.12