annotate docs/nitros9guide/list.refentry @ 1299:1f0995cd0431

REL is now back-ported to OS-9 Level One
author boisy
date Mon, 01 Sep 2003 16:59:50 +0000
parents 4dae346c4969
children b00cf13c9f61
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="list">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>LIST</refname>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>List the contents of a text file</refpurpose>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
6
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 975
diff changeset
9 <command>list</command>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="plain">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
11 <replaceable>path</replaceable>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
13 <arg choice="plain">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
14 &repeatst; <replaceable>path</replaceable> &repeaten;
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
15 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
16 </cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
17 </refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
18
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
19 <refsect1><title>Description</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
20 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
21 This command copies text lines from the path(s) given as parameters
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
22 to the standard output path. The program terminates upon reaching
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
23 the end-of-file of the last input path. If more than one path is
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
24 specified, the first path will be copied to standard output, the
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
25 second path will be copied next, etc.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
26 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
27 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
28 This command is most commonly used to examine or print text files.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
29 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
30 <para>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 975
diff changeset
31 For more information see: <xref linkend="sec2.3"/>, <xref linkend="sec3.9.2"/>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
32 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
33 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
34 <refsect1><title>Examples</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
35 <literallayout>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
36 list /d0/startup &gt;/P &amp; (output is redirected to printer)
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
38 list /D1/user5/document /d0/myfile /d0/Bob/text
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
40 list /TERM &gt;/p (copy keyboard to printer - use
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
41 &quot;escape&quot; key to terminate input)
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
42 </literallayout>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
43 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
44
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
45 OS9: build animals
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
46 ? cat
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
47 ? cow
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
48 ? dog
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
49 ? elephant
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
50 ? bird
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
51 ? fish
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
52 ? [RETURN]
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
53
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
54 OS9: list animals
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
55 cat
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
56 cow
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
57 dog
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
58 elephant
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
59 bird
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
60 fish
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
61 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
62 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
63 </refentry>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
64