changeset 542:73319ee6a57e

All "See Also" implemented
author roug
date Mon, 14 Oct 2002 19:08:32 +0000
parents 7a7bf9925e42
children 03d745f92340
files docs/ccguide/exit.refentry docs/ccguide/feof.refentry docs/ccguide/findstr.refentry docs/ccguide/fopen.refentry docs/ccguide/fread.refentry docs/ccguide/fseek.refentry docs/ccguide/getc.refentry docs/ccguide/getpid.refentry docs/ccguide/gets.refentry docs/ccguide/getstat.refentry docs/ccguide/getuid.refentry docs/ccguide/intercept.refentry docs/ccguide/kill.refentry docs/ccguide/lseek.refentry docs/ccguide/mknod.refentry docs/ccguide/mktemp.refentry docs/ccguide/modload.refentry docs/ccguide/munlink.refentry docs/ccguide/open.refentry docs/ccguide/os9fork.refentry docs/ccguide/pause.refentry docs/ccguide/prerr.refentry docs/ccguide/printf.refentry docs/ccguide/putc.refentry docs/ccguide/puts.refentry docs/ccguide/read.refentry docs/ccguide/scanf.refentry
diffstat 27 files changed, 303 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/docs/ccguide/exit.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/exit.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -15,9 +15,21 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$EXIT
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="wait">wait()</link>
+</para>
+</refsect1>
 </refentry>
--- a/docs/ccguide/feof.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/feof.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,13 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+System call
+<link linkend="open">open()</link>,
+<link linkend="fopen">fopen()</link>.
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/findstr.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/findstr.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -19,4 +19,11 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="strcat">index(), rindex()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/fopen.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/fopen.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,13 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+System call
+<link linkend="open">open()</link>,
+<link linkend="fflush">fclose()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/fread.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/fread.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,17 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+System calls
+<link linkend="read">read()</link>,
+<link linkend="write">write()</link>.
+<link linkend="fopen">Fopen()</link>,
+<link linkend="getc">getc()</link>,
+<link linkend="putc">putc()</link>,
+<link linkend="printf">printf()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/fseek.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/fseek.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,12 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+System call
+<link linkend="lseek">lseek()</link>.
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/getc.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/getc.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,15 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="putc">Putc()</link>,
+<link linkend="fread">fread()</link>,
+<link linkend="fopen">fopen()</link>,
+<link linkend="gets">gets()</link>,
+<link linkend="ungetc">ungetc()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/getpid.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/getpid.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,9 +14,23 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$ID
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="os9fork">os9fork()</link>,
+Standard Library function
+<link linkend="mktemp">mktemp()</link>.
+</para>
+</refsect1>
 </refentry>
--- a/docs/ccguide/gets.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/gets.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,14 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="puts">puts()</link>,
+<link linkend="getc">getc()</link>,
+<link linkend="scanf">scanf()</link>,
+<link linkend="fread">fread()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/getstat.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/getstat.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -17,6 +17,12 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 I$GETSTT
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
--- a/docs/ccguide/getuid.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/getuid.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,6 +14,12 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$ID
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
--- a/docs/ccguide/intercept.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/intercept.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,9 +14,22 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$ICPT
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="signal">signal()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/kill.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/kill.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,12 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="signal">signal()</link>,
+OS-9 shell command "kill"
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/lseek.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/lseek.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,9 +14,25 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 I$SEEK
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="creat">creat()</link>,
+<link linkend="open">open()</link>,
+Standard Library function 
+<link linkend="fseek">"fseek"</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/mknod.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/mknod.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -17,6 +17,12 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 I$MAKDIR
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
--- a/docs/ccguide/mktemp.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/mktemp.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -19,4 +19,12 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+System call
+<link linkend="getpid">getpid()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/modload.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/modload.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -17,9 +17,25 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$LINK
+</para>
+<para>
+os9 F$LOAD
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="munlink">munlink()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/munlink.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/munlink.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -17,9 +17,22 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$UNLINK
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="modload">modlink(), modload()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/open.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/open.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,9 +14,26 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 I$OPEN
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="creat">creat()</link>,
+<link linkend="read">read()</link>,
+<link linkend="write">write()</link>,
+<link linkend="dup">dup()</link>,
+<link linkend="close">close()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/os9fork.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/os9fork.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,6 +14,12 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$FORK
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
--- a/docs/ccguide/pause.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/pause.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,9 +14,24 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 I$SLEEP (with a value of 0)
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="kill">kill()</link>,
+<link linkend="signal">signal()</link>,
+OS-9 shell command "kill"
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/prerr.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/prerr.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,6 +14,12 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 F$PERR
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
--- a/docs/ccguide/printf.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/printf.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -48,4 +48,13 @@
 that this buffer is large enough.
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+Kernighan &amp; Ritchie pages 145-147.
+<link linkend="Putc">putc()</link>,
+<link linkend="scanf">scanf()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/putc.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/putc.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,16 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="fopen">fopen()</link>,
+<link linkend="fflush">fclose(), fflush()</link>,
+<link linkend="getc">getc()</link>,
+<link linkend="puts">puts()</link>,
+<link linkend="printf">printf()</link>,
+<link linkend="fread">fread()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/puts.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/puts.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -9,9 +9,16 @@
 <funcsynopsisinfo>
 #include &lt;stdio.h&gt;
 </funcsynopsisinfo>
+
 <funcprototype>
   <funcdef><function>puts</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>char *<parameter>s</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>fputs</function></funcdef>
+  <paramdef>char *<parameter>s</parameter></paramdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
@@ -19,7 +26,23 @@
 
 <refsect1><title>Description</title>
 <para>
-Placeholder
+Fputs copies the (null-terminated) string pointed to by "s"
+onto the file "fp".
+</para>
+<para>
+Puts copies the string "s" onto the standard output and
+appends "\n".
+</para>
+<para>
+The terminating null is not copied by either function.
+</para>
+</refsect1>
+
+<refsect1><title>Caveats</title>
+<para>
+The inconsistency of the new-line being appended by puts and
+not by fputs is dictated by history and the desire for
+compatibility.
 </para>
 </refsect1>
 </refentry>
--- a/docs/ccguide/read.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/read.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -14,9 +14,27 @@
 
 </refsynopsisdiv>
 
+<refsect1><title>Assembler Equivalent</title>
+<para>
+os9 I$READ
+</para>
+<para>
+os9 I$READLN
+</para>
+</refsect1>
+
 <refsect1><title>Description</title>
 <para>
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="open">open()</link>,
+<link linkend="creat">creat()</link>,
+<link linkend="dup">dup()</link>
+</para>
+</refsect1>
+
 </refentry>
--- a/docs/ccguide/scanf.refentry	Mon Oct 14 19:08:28 2002 +0000
+++ b/docs/ccguide/scanf.refentry	Mon Oct 14 19:08:32 2002 +0000
@@ -22,4 +22,14 @@
 Placeholder
 </para>
 </refsect1>
+
+<refsect1><title>See Also</title>
+<para>
+<link linkend="atof">atoi(), atof()</link>,
+<link linkend="getc">getc()</link>,
+<link linkend="printf">printf()</link>
+Kernighan and Ritchie pp 147-150
+</para>
+</refsect1>
+
 </refentry>