Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/build.refentry @ 1093:4dae346c4969

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added crossreferences and lowercased synopsises
author roug
date Mon, 07 Apr 2003 21:01:46 +0000
parents b5ff125a1d60
children b00cf13c9f61
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="build">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname id="buildname">BUILD</refname>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Build a text file from standard input</refpurpose>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
6
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>build</command>
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
10 <arg choice="plain"><replaceable>path</replaceable></arg>
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
11 </cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
12 </refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
13
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
14 <refsect1><title>Description</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
15 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
16 This command is used to build short text files by copying the
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
17 standard input path into the file specified by
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
18 <replaceable>path</replaceable>. <command>Build</command> creates a file according to the pathlist parameter,
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
19 then displays a &quot;?&quot;
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
20 prompt to request an input line. Each line entered is written to
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
21 the output path (file). Entering a line consisting of a carriage
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
22 return only causes <command>build</command> to terminate.
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
23 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
24
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
25 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
26 <refsect1><title>Example:</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
27
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
28 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
29 build small_file
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
30 build /p (copies keyboard to printer)
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
31 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
32 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
33 The standard input path may also be redirected to a file. Below is
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
34 an example:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
35 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
36 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
37 build &lt;mytext /T2 (copies file &quot;mytext&quot; to terminal T2)
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
38
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
39
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
40 OS9: build newfile
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
41
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
42 ? The powers of the OS-9
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
43 ? operating system are truly
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
44 ? fantastic.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
45 ? [RETURN]
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
46
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
47 OS9: list newfile
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
48
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
49 The powers of the OS-9
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
50 operating system are truly
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
51 fantastic.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
52 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
53 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
54 </refentry>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
55