changeset 604:1d37d3a84a7c

All refentries finished.
author roug
date Fri, 15 Nov 2002 21:49:51 +0000
parents e9578f62b346
children 96ad5be1860b
files docs/ccguide/read.refentry docs/ccguide/sbrk.refentry
diffstat 2 files changed, 35 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/docs/ccguide/read.refentry	Fri Nov 15 21:49:51 2002 +0000
+++ b/docs/ccguide/read.refentry	Fri Nov 15 21:49:51 2002 +0000
@@ -34,7 +34,28 @@
 
 <refsect1><title>Description</title>
 <para>
-Placeholder
+The path number, "pn" is an integer which is one of the
+standard path numbers 0, 1, or 2, or the path number should
+have been returned by a successful call to "open", "creat", or
+"dup". "Buffer" is a pointer to space with at least "count"
+bytes of memory into which read will put the data from the
+file.
+</para>
+<para>
+It is guaranteed that at most "count" bytes will be read, but
+often less will be, either because, for <function>readln</function>, the file
+represents a terminal and input stops at the end of a line, or
+for both, end-of-file has been reached.
+</para>
+<para>
+Readln causes "line-editing" such as echoin to take place and
+returns once the first "\n" is encountered in the input or the
+number of bytes requested has been read. Readln is the
+preferred call for reading from the user's terminal.
+</para>
+<para>
+Read does not cause any such editing. See the OS-9 manual for
+a fuller description of the actions of these calls.
 </para>
 </refsect1>
 
--- a/docs/ccguide/sbrk.refentry	Fri Nov 15 21:49:51 2002 +0000
+++ b/docs/ccguide/sbrk.refentry	Fri Nov 15 21:49:51 2002 +0000
@@ -21,7 +21,19 @@
 
 <refsect1><title>Description</title>
 <para>
-Placeholder
+Sbrk requests an allocation from free memory and returns a
+pointer to its base.
+</para>
+<para>
+"Sbrk()" requests the system to allocate "new" memory from
+outside the initial allocation.
+</para>
+<para>
+Users should read the Memory Management section of this manual
+for a fuller explanation of the arrangement.
+</para>
+<para>
+Ibrk requests memory from inside the initial memory allocation.
 </para>
 </refsect1>