annotate docs/nitros9guide/dmode.refentry @ 2524:50b13fe0ceac

Fixed up comments... still needs better commenting though
author boisy
date Fri, 09 Apr 2010 14:56:40 +0000
parents bc28c3bc3769
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
971
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
1 <refentry id="dmode">
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
2 <refnamediv>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
3 <refname>DMODE</refname>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
4 <refpurpose>Disk descriptor Editor</refpurpose>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
5 </refnamediv>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
6
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
7 <refsynopsisdiv>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>dmode</command>
971
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
10 <group>
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 971
diff changeset
11 <arg choice="plain"><replaceable>devicename</replaceable></arg>
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 971
diff changeset
12 <arg choice="plain">-<replaceable>filename</replaceable></arg>
971
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
13 </group>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
14 <arg choice="opt">options</arg>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
15 </cmdsynopsis>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
16 </refsynopsisdiv>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
17
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
18 <refsect1><title>Description</title>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
19 <para>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
20 This new version allows any combination of upper or lower
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
21 case options to be specified.
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
22 </para><para>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
23 Also, current parameters are displayed with a "$" preceding
1148
bc28c3bc3769 Put all stylesheets in one central location
roug
parents: 1093
diff changeset
24 to remind the user that the values are <emphasis>hexadecimal</emphasis>.
971
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
25 </para><para>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
26 Options may be prefixed with a "$". It is simply ignored.
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
27 </para>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
28 </refsect1>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
29 <refsect1><title>Examples</title>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
30 <para>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
31 Typical <command>dmode</command> output:
971
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
32 <screen>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
33 OS9: dmode /dd {enter}
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
34
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
35 drv=$00 stp=$00 typ=$80 dns=$01 cyl=$0334 sid=$06
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
36 vfy=$00 sct=$0021 tos=$0021 ilv=$00 sas=$20
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
37 </screen>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
38
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
39 Now, let's say we want to change the number of cylinders
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
40 this descripter shows. The following command lines would
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
41 all be valid and accepted by the new <command>dmode</command>:
971
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
42
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
43 <screen>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
44 OS9: dmode /dd CYL=276
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
45 -or- dmode /dd Cyl=$276
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
46 -or- dmode /dd cYL=276
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
47 </screen>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
48
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
49 Lastly, you may now specify either "TOS" or "T0S" to setup
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
50 the number of sectors per track in track zero. Example:
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
51
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
52 <screen>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
53 OS9: dmode /dd tos=21
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
54 -or- dmode /dd t0s=21
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
55 </screen>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
56 </para>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
57 </refsect1>
425b8a051c58 Reference pages for new commands
roug
parents:
diff changeset
58 </refentry>