added help-patches for fz's [freadln]/[fwriteln]

svn path=/trunk/externals/zexy/; revision=7705

3 files changed, 65 insertions, 0 deletions

diff --git a/reference/0.INTRO.txt b/reference/0.INTRO.txt
index 242fd54..6a2ada4 100644
--- a/reference/0.INTRO.txt
+++ b/reference/0.INTRO.txt
@@ -73,6 +73,8 @@ date		get system date
 time		get system time

 index		map symbols to indices

 msgfile		a powerful "textfile" derivative

+freadln		a simplified "textfile" derivative for reading line-wise

+fwriteln	a simplified "textfile" derivative for writing line-wise

 demultiplex	demultiplex the input to a specified outlet

 lpt		write to the (parallel) port

 operating_system      get the current OS

diff --git a/reference/freadln-help.pd b/reference/freadln-help.pd
new file mode 100644
index 0000000..662dfdd
--- /dev/null
+++ b/reference/freadln-help.pd
@@ -0,0 +1,33 @@
+#N canvas 94 78 859 363 10;
+#X obj 443 239 print done;
+#X text 72 260 see also:;
+#X msg 433 149 bang;
+#X text 334 293 this outlet gets the lines in sequence.;
+#X obj 130 281 textfile;
+#X text 482 150 output one line as a list and move to the next;
+#X text 508 222 This outlet gets a bang when you hit the end of the
+sequence \; it will also get the current position when using "when"
+;
+#X text 618 7 part of zexy;
+#X obj 406 267 print data;
+#X obj 73 9 freadln;
+#X text 127 9 read text-files line-by-line;
+#X text 18 57 The [freadln] object is a simplified version if [textfile].
+It only supports reading files.;
+#X text 15 95 features are :;
+#X text 60 108 the file is not read into the objects buffer. instead
+only the current line will be streamed from the file. this allows to
+read _large_ files (which need not fit into the main memory at all)
+;
+#X text 58 199 no random access!;
+#X text 9 183 drawbacks are :;
+#X obj 130 262 fwriteln;
+#X msg 433 178 close;
+#X text 548 117 open a file in 'cr' mode;
+#X obj 406 201 freadln;
+#X msg 435 116 open test.mtx cr;
+#X connect 2 0 19 0;
+#X connect 17 0 19 0;
+#X connect 19 0 8 0;
+#X connect 19 1 0 0;
+#X connect 20 0 19 0;
diff --git a/reference/fwriteln-help.pd b/reference/fwriteln-help.pd
new file mode 100644
index 0000000..c10d664
--- /dev/null
+++ b/reference/fwriteln-help.pd
@@ -0,0 +1,30 @@
+#N canvas 94 78 859 363 10;
+#X text 72 260 see also:;
+#X obj 130 281 textfile;
+#X text 482 150 output one line as a list and move to the next;
+#X text 618 7 part of zexy;
+#X text 15 95 features are :;
+#X text 58 199 no random access!;
+#X text 9 183 drawbacks are :;
+#X msg 433 248 close;
+#X text 578 117 open a file in 'cr' mode;
+#X obj 73 9 fwriteln;
+#X text 127 9 write text-files line-by-line;
+#X text 18 57 The [fwriteln] object is a simplified version if [textfile].
+It only supports writing files.;
+#X text 60 108 the file is not cached in the object's buffer. instead
+the current line will be streamed directly into the file. this allows
+to write _large_ files (which need not fit into the main memory at
+all);
+#X obj 130 262 freadln;
+#X obj 406 271 fwriteln;
+#X msg 441 172 1 2 3.666;
+#X msg 441 194 foo bar;
+#X msg 443 216 list is a list is a list;
+#X msg 435 116 open /tmp/test.txt cr;
+#X text 489 249 close the file (ensure that it gets written);
+#X connect 7 0 14 0;
+#X connect 15 0 14 0;
+#X connect 16 0 14 0;
+#X connect 17 0 14 0;
+#X connect 18 0 14 0;