From c745383b31a30ada8db79c653e9c3bf7d062cbe1 Mon Sep 17 00:00:00 2001
From: Ryan <ry@tinyclouds.org>
Date: Fri, 31 Jul 2009 19:56:53 +0200
Subject: [PATCH] Add examples of reading a file to documentation.

---
 website/api.txt | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/website/api.txt b/website/api.txt
index fdd5649295f..90c0d1db75e 100644
--- a/website/api.txt
+++ b/website/api.txt
@@ -482,6 +482,19 @@ or +node.RAW+.
 - on success: returns +data, bytes_read+, what was read from the file.
 - on error: no parameters.
 
++node.fs.cat(filename, encoding)+::
+
+Outputs the entire contents of a file. Example:
++
+--------------------------------
+node.fs.cat("/etc/passwd", "utf8").addCallback(function (content) {
+  puts(content);
+});
+--------------------------------
++
+- on success: returns +data+, what was read from the file.
+- on error: no parameters.
+
 
 ==== +node.fs.File+
 
@@ -498,6 +511,18 @@ file.write("world");
 file.close();
 ----------------------------------------
 
+Here is an example of reading the first 10 bytes from +/etc/passwd+ and
+outputting it to +stdout+.
+
+----------------------------------------
+var file = new node.fs.File({encoding: "utf8"});
+file.open("/etc/passwd", "r");
+file.read(10).addCallback(function (chunk) {
+  puts(chunk);
+});
+file.close();
+----------------------------------------
+
 [cols="1,2,10",options="header"]
 |=========================================================
 |Event      |Parameters | Notes