134
|
1 <refentry id="build">
|
|
2 <refnamediv>
|
|
3 <refname id="buildname">BUILD</refname>
|
|
4 <refpurpose>Build a text file from standard input</refpurpose>
|
|
5 </refnamediv>
|
|
6
|
|
7 <refsynopsisdiv>
|
|
8 <cmdsynopsis>
|
|
9 <command>BUILD</command>
|
|
10 <arg choice="plain">&replstart;path&replend;</arg>
|
|
11 </cmdsynopsis>
|
|
12 </refsynopsisdiv>
|
|
13
|
|
14 <refsect1><title>Description</title>
|
|
15 <para>
|
|
16 This command is used to build short text files by copying the
|
|
17 standard input path into the file specified by
|
|
18 &replstart;path&replend;. BUILD creates a file according to the pathlist parameter,
|
|
19 then displays a "?"
|
|
20 prompt to request an input line. Each line entered is written to
|
|
21 the output path (file). Entering a line consisting of a carriage
|
|
22 return only causes BUILD to terminate.
|
|
23 </para>
|
|
24
|
|
25 </refsect1>
|
|
26 <refsect1><title>Example:</title>
|
|
27
|
|
28 <screen>
|
|
29 build small_file
|
|
30 build /p (copies keyboard to printer)
|
|
31 </screen>
|
|
32 <para>
|
|
33 The standard input path may also be redirected to a file. Below is
|
|
34 an example:
|
|
35 </para>
|
|
36 <screen>
|
|
37 build <mytext /T2 (copies file "mytext" to terminal T2)
|
|
38
|
|
39
|
|
40 OS9: build newfile
|
|
41
|
|
42 ? The powers of the OS-9
|
|
43 ? operating system are truly
|
|
44 ? fantastic.
|
|
45 ? [RETURN]
|
|
46
|
|
47 OS9: list newfile
|
|
48
|
|
49 The powers of the OS-9
|
|
50 operating system are truly
|
|
51 fantastic.
|
|
52 </screen>
|
|
53 </refsect1>
|
|
54 </refentry>
|
|
55
|