annotate docs/ccguide/puts.refentry @ 1892:77d83b367eba

reduced labeltab size so os9boot would link
author robert
date Fri, 14 Oct 2005 01:56:25 +0000
parents d9ab3688bb71
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
1 <refentry id="puts">
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
2 <refnamediv>
573
d9ab3688bb71 All function prototypes are added.
roug
parents: 542
diff changeset
3 <refname>Puts</refname>
d9ab3688bb71 All function prototypes are added.
roug
parents: 542
diff changeset
4 <refname>Fputs</refname>
d9ab3688bb71 All function prototypes are added.
roug
parents: 542
diff changeset
5 <refpurpose>put a string on a file</refpurpose>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
6 </refnamediv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
7
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
8 <refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
9 <funcsynopsis>
468
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
10 <funcsynopsisinfo>
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
11 #include &lt;stdio.h&gt;
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
12 </funcsynopsisinfo>
542
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
13
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
14 <funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
15 <funcdef><function>puts</function></funcdef>
542
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
16 <paramdef>char *<parameter>s</parameter></paramdef>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
17 </funcprototype>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
18
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
19 <funcprototype>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
20 <funcdef><function>fputs</function></funcdef>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
21 <paramdef>char *<parameter>s</parameter></paramdef>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
22 <paramdef>FILE *<parameter>fp</parameter></paramdef>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
23 </funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
24 </funcsynopsis>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
25
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
26 </refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
27
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
28 <refsect1><title>Description</title>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
29 <para>
542
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
30 Fputs copies the (null-terminated) string pointed to by "s"
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
31 onto the file "fp".
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
32 </para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
33 <para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
34 Puts copies the string "s" onto the standard output and
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
35 appends "\n".
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
36 </para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
37 <para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
38 The terminating null is not copied by either function.
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
39 </para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
40 </refsect1>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
41
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
42 <refsect1><title>Caveats</title>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
43 <para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
44 The inconsistency of the new-line being appended by puts and
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
45 not by fputs is dictated by history and the desire for
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
46 compatibility.
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
47 </para>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
48 </refsect1>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
49 </refentry>