From 8774e2caae458a39fdc1e9a72fdae6fa05ae1104 Mon Sep 17 00:00:00 2001 From: uid20002 Date: Thu, 19 May 2005 20:24:31 +0000 Subject: Documentation update --- doc/us/examples.html | 9 ++- doc/us/index.html | 12 +-- doc/us/manual.html | 212 +++++++++++++++++++++++++++------------------------ 3 files changed, 125 insertions(+), 108 deletions(-) diff --git a/doc/us/examples.html b/doc/us/examples.html index 63a3f93..57eefbe 100644 --- a/doc/us/examples.html +++ b/doc/us/examples.html @@ -48,7 +48,12 @@
-

Example

+

Examples

+ +

Directory iterator

+ +

The following example iterates over a directory and recursively lists the +attributes for each file or directory inside it.

 require"lfs"
@@ -81,7 +86,7 @@ attrdir (".")
 

 	
Valid XHTML 1.0!

 	

-	$Id: examples.html,v 1.1 2005/05/04 02:28:51 tuler Exp $
+	$Id: examples.html,v 1.2 2005/05/19 20:24:31 uid20002 Exp $
 	

 
 
 
diff --git a/doc/us/index.html b/doc/us/index.html
index b7e6983..440182c 100644
--- a/doc/us/index.html
+++ b/doc/us/index.html
@@ -83,12 +83,14 @@ page.
 
History

 
 
    
-
  • [?/?/2005] Version 1.1 released
    • 
-
  • [21/Jan/2005] Version 1.0 released
    • 
-
  • [10/Nov/2004] Version 1.0 beta released
    • 
+    
  • [19/May/2005] Version 1.1 released
    
+        added function lfs.touch.
+    
    • 
+    
  • [21/Jan/2005] Version 1.0 released
    • 
+    
  • [10/Nov/2004] Version 1.0 beta released
    • 
 

 
-Version 1.1 adds function lfs.touch.
+
 
 
Credits

 
@@ -110,7 +112,7 @@ Comments are welcome!

 

 	
Valid XHTML 1.0!

 	

-	$Id: index.html,v 1.11 2005/05/04 02:28:51 tuler Exp $
+	$Id: index.html,v 1.12 2005/05/19 20:24:31 uid20002 Exp $
 	

 
 
 
diff --git a/doc/us/manual.html b/doc/us/manual.html
index 770b913..205e3f4 100644
--- a/doc/us/manual.html
+++ b/doc/us/manual.html
@@ -15,7 +15,7 @@
 	
-	
LuaFileSystem

+	
LuaFileSystem

 	
File System Library for the Lua Programming Language
@@ -61,8 +61,8 @@ systems offered by the standard Lua distribution.

LuaFileSystem is distributed as a pair of C source and header -files. The distribution provides a Makefile prepared to -compile the library and install it. The file config should +files. The distribution provides a Makefile prepared to +compile the library and install it. The file config should be edited to suit the needs of the aimed platform.

@@ -71,109 +71,119 @@ LuaFileSystem follows the package proposal for Lua 5.1, therefore this package should be "installed". In other words, -if you are using Lua 5.0, the files compat-5.1.c and -compat-5.1.h must be used in the compilation and the file -compat-5.1.lua must be installed in the LUA_PATH. +if you are using Lua 5.0, the files compat-5.1.c and +compat-5.1.h must be used in the compilation and the file +compat-5.1.lua must be installed in the LUA_PATH. If you are using Lua 5.1, nothing should be done.

Reference

LuaFileSystem offers the following functions:

- +
+
lfs.attributes (filepath)
+
Returns a table with the file attributes corresponding to filepath. + The attributes are: +
+
dev
+
device that the inode resides on
+ +
ino
+
inode's number
+ +
mode
+
inode protection mode (string, values could be file, + directory, link, socket, + named pipe, char device, block device or + other)
+ +
nlink
+
number of hard links to the file
+ +
uid
+
user-id of owner
gid +
group-id of owner
+ +
rdev
+
device type, for special file inode
+ +
access
+
time of last access
+ +
modification
+
time of last data modification
+ +
change
+
time of last file status change
+ +
size
+
file size, in bytes
+ +
blocks
+
block allocated for file; (Unix only)
+ +
blksize
+
optimal file system I/O blocksize; (Unix only)
+
+ + +
lfs.chdir (path)
+
Changes the current working directory to the given + path.
+ Returns true in case of success or nil plus an + error string.
+ + +
lfs.currentdir ()
+
Returns a string with the current working directory or nil + plus an error string.
+ +
lfs.dir (path)
+
Lua iterator over the entries of a given directory. Raises an + error if path is not a directory.
+ +
lfs.lock (filehandle, mode[, start[, length]])
+
Locks a file or a part of it. This function works on open files; the + file handle should be specified as the first argument. + The string mode could be either + r (for a read/shared lock) or w (for a + write/exclusive lock). The optional arguments start + and length can be used to specify a starting point and + its length; both should be numbers.
+ Returns a boolean indicating if the operation was successful; in + case of error, it returns false plus an error string. +
+ +
lfs.mkdir (dirname)
+
Creates a new directory. The argument is the name of the new + directory.
+ Returns a boolean indicating whether the operation succeeds or not + (in this case, an error string is returned too).
+ +
lfs.touch (filepath [, atime [, mtime]])
+
Set access and modification times of a file. This function is + a bind to utime function. The first argument is the + filename, the second argument is the access time, + and the third argument is the modification time. + Both times are provided in seconds (which should be generated with + Lua standard function os.date). + If the modifition time is omitted, the access time provided is used; + if both times are omitted, the current time is used.
+ Returns a boolean indicating whethet the operation succeeds or not + (followed by an error string in case it fails).
+ +
lfs.unlock (filehandle[, start[, length]])
+
Unlocks a file or a part of it. This function works on + open files; the file handle should be specified as the first + argument. The optional arguments start and + length can be used to specify a starting point and its + length; both should be numbers.
+ Returns a boolean indicating if the operation was successful; in + case of error, it returns false plus a string + describing the error.
+
@@ -182,7 +192,7 @@ describing the error.

Valid XHTML 1.0!

- $Id: manual.html,v 1.10 2005/05/04 02:28:51 tuler Exp $ + $Id: manual.html,v 1.11 2005/05/19 20:24:31 uid20002 Exp $

-- cgit v1.2.3-55-g6feb