Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/list.refentry @ 3116:174eb9eda7b1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
New port "mc09" for Multicomp09, an FPGA-based 6809 machine Include new commands/descriptor for mc09 clock and SD controller
author Neal Crook <foofoobedoo@gmail.com>
date Sat, 17 Oct 2015 21:21:11 +0100
parents b00cf13c9f61
children
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>
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
36 list /d0/startup &gt;/p &amp; (output is redirected to printer)
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
38 list /d1/user5/document /d0/myfile /d0/Bob/text
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
40 list /term &gt;/p (copy keyboard to printer - use
138
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