Melhorias na documentacao.

2 files changed, 33 insertions, 15 deletions

diff --git a/doc/us/manual.html b/doc/us/manual.html
index 5ca685d..3afde68 100644
--- a/doc/us/manual.html
+++ b/doc/us/manual.html
@@ -56,24 +56,41 @@ LuaFileSystem offers the following functions:
 <ul>

   <a name="attributes"></a>

   <li> <b><tt>lfs.attributes (filepath)</tt></b> <br>

-    Returns a table with file attributes.

+    Obtains the file attributes.

+    The attributes are:

+    <ul>

+    <i>dev</i>, device inode resides on;<br>

+    <i>ino</i>, inode's number;<br>

+    <i>mode</i>, inode protection mode (<small>values could be

+      <tt>file</tt>, <tt>directory</tt>, <tt>link</tt>, <tt>socket</tt>, <tt>named pipe</tt>, <tt>char device</tt>, <tt>block device</tt> or <tt>other</tt></small>);<br>

+    <i>nlink</i>, number of hard links to the file;<br>

+    <i>uid</i>, user-id of owner;<br>

+    <i>gid</i>, group-id of owner;<br>

+    <i>rdev</i>, device type, for special file inode;<br>

+    <i>access</i>, time of last access;<br>

+    <i>modification</i>, time of last data modification;<br>

+    <i>change</i>, time of last file status change;<br>

+    <i>size</i>, file size, in bytes;<br>

+    <i>blocks</i>, block allocated for file;<br>

+    <i>blksize</i>, optimal file system I/O blocksize;<br>

+    </ul>

+    Returns a table with file attributes described above.

 

   <a name="chdir"></a>

   <li> <b><tt>lfs.chdir (path)</tt></b> <br>

-    Changes the current

-    working directory to the given <tt>path</tt>.

+    Changes the current working directory to the given <tt>path</tt>.<br>

     Returns <tt>true</tt> in case of success or <tt>nil</tt> plus an error

     string.

 

   <a name="getcwd"></a>

   <li> <b><tt>lfs.currentdir ()</tt></b> <br>

-    Returns the current

-    working directory or <code>nil</code> plus an error string.

+    Returns a string with the current working directory or

+    <code>nil</code> plus an error string.

 

   <a name="dir"></a>

   <li> <b><tt>lfs.dir (path)</tt></b> <br>

-    Lua iterator over the entries

-    of a given directory.

+    Lua iterator over the entries of a given directory.

+    Raises an error if <tt>path</tt> is not a directory.

 

   <a name="lock"></a>

   <li> <b><tt>lfs.lock (filehandle, mode[, start[, length]])</tt></b> <br>

@@ -84,15 +101,16 @@ LuaFileSystem offers the following functions:
     read/shared lock) or <code>w</code> (for a write/exclusive lock).

     The optional arguments <code>start</code> and <code>length</code> can be

     used to specify a starting point and its length;

-    both should be numbers.

+    both should be numbers.<br>

     Returns a boolean indicating if the operation was successful;

     in case of error, it returns <code>false</code> plus an error string.

 

   <a name="mkdir"></a>

   <li> <b><tt>lfs.mkdir (dirname)</tt></b> <br>

     Creates a new directory.

-    The argument is the name of the new directory.

-    Returns a boolean indicating whether the operation succeeds or not.

+    The argument is the name of the new directory.<br>

+    Returns a boolean indicating whether the operation succeeds or not

+    (in this case, an error string is returned too).

 

   <a name="unlock"></a>

   <li> <b><tt>lfs.unlock (filehandle[, start[, length]])</tt></b> <br>

@@ -101,8 +119,8 @@ LuaFileSystem offers the following functions:
     the file handle should be specified as the first argument.

     The optional arguments <code>start</code> and <code>length</code> can be

     used to specify a starting point and its length;

-    both should be numbers.

-    This function returns a boolean indicating if the operation was successful;

+    both should be numbers.<br>

+    Returns a boolean indicating if the operation was successful;

     in case of error, it returns <code>false</code> plus a string describing the

     error.

 

@@ -167,7 +185,7 @@ attrdir (".")
 

 <hr>

 <small>

-$Id: manual.html,v 1.5 2004/11/01 15:27:13 tomas Exp $

+$Id: manual.html,v 1.6 2004/11/05 10:37:29 tomas Exp $

 </small>

 

 </body>

diff --git a/src/lfs.c b/src/lfs.c
index d731377..a5c152a 100644
--- a/src/lfs.c
+++ b/src/lfs.c
@@ -9,7 +9,7 @@
 **   lfs.lock (fh, mode)
 **   lfs.unlock (fh)
 **
-** $Id: lfs.c,v 1.10 2004/11/04 22:21:28 tuler Exp $
+** $Id: lfs.c,v 1.11 2004/11/05 10:37:29 tomas Exp $
 */
 
 #include <errno.h>
@@ -403,7 +403,7 @@ static int file_info (lua_State *L) {
 	lua_pushliteral (L, "mode");
 	lua_pushstring (L, mode2string (info.st_mode));
 	lua_rawset (L, -3);
-	/* number or hard links to the file */
+	/* number of hard links to the file */
 	lua_pushliteral (L, "nlink");
 	lua_pushnumber (L, (lua_Number)info.st_nlink);
 	lua_rawset (L, -3);