svn commit: r282560 - head/lib/libc/gen

[John Baldwin]

Author: jhb
Date: Wed May  6 17:23:42 2015
New Revision: 282560
URL: https://svnweb.freebsd.org/changeset/base/282560

Log:
  Tweak the comment here some more.  In particular, the previous opening
  sentence was a bit confusing.
  
  Noted by:	kib

Modified:
  head/lib/libc/gen/telldir.c

Modified: head/lib/libc/gen/telldir.c
==============================================================================
--- head/lib/libc/gen/telldir.c	Wed May  6 16:43:44 2015	(r282559)
+++ head/lib/libc/gen/telldir.c	Wed May  6 17:23:42 2015	(r282560)
@@ -125,13 +125,13 @@ _seekdir(dirp, loc)
 }
 
 /*
- * A call to telldir after readdir returns the last entry in a block
- * returns a location that is after the end of the last entry in that
- * block.  However, that location doesn't refer to a valid directory
- * entry.  Instead, these locations should refer to the first entry in
- * the next block.  That location is not known until the next block is
- * read, so readdir calls this function after fetching a new block to
- * fix any such telldir locations.
+ * After readdir returns the last entry in a block, a call to telldir
+ * returns a location that is after the end of that last entry.
+ * However, that location doesn't refer to a valid directory entry.
+ * Ideally, the call to telldir would return a location that refers to
+ * the first entry in the next block.  That location is not known
+ * until the next block is read, so readdir calls this function after
+ * fetching a new block to fix any such telldir locations.
  */
 void
 _fixtelldir(DIR *dirp, long oldseek, long oldloc)