Skip to content

Commit 19d6173

Browse files
sorenrougsorenroug
committed
Added c.opt
1 parent f629cb1 commit 19d6173

File tree

6 files changed

+69
-7
lines changed

6 files changed

+69
-7
lines changed

‎manuals/os9guide/src/chap5.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -348,7 +348,7 @@ Level Two system load modules contiguously on memory block boundaries. The block
348348
usually 2K per block for systems equipped with MC6829 MMUs, or 4K bytes for
349349
most SS-50 bus systems.
350350
Free memory to be used for <emphasis>user data area</emphasis> need not be contiguous
351-
because the MMU can map scattered free blocks th be logically contiguous.
351+
because the MMU can map scattered free blocks to be logically contiguous.
352352
Since OS-9 will request the largest physically contiguous memory block available
353353
(up to 56K) to load program modules, load operations can fail even if sufficient
354354
total free memory exists. Any of this memory not used by the load operation is

‎manuals/os9guide/src/chap7.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ command line before it is passed to the program being called.
102102
<xi:include href="refentry-deldir.xml"/>
103103
<xi:include href="refentry-devs.xml"/>
104104
<xi:include href="refentry-dir.xml"/>
105-
<xi:include href="refentry-disasm.xml"/>
105+
<!-- <xi:include href="refentry-disasm.xml"/> -->
106106
<xi:include href="refentry-display.xml"/>
107107
<xi:include href="refentry-dmode.xml"/>
108108
<xi:include href="refentry-dsave.xml"/>

‎manuals/os9guide/src/refentry-c.opt.xml

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
<refentry xml:id="c.opt" xmlns="http://docbook.org/ns/docbook">
2+
<refnamediv>
3+
<refname>c.opt<indexterm><primary>c.opt</primary></indexterm></refname>
4+
<refpurpose>Assembly code optimizer</refpurpose>
5+
</refnamediv>
6+
7+
<refsynopsisdiv>
8+
<cmdsynopsis>
9+
<command>c.opt</command>
10+
<arg choice="opt">
11+
<option>-i</option>
12+
{=<replaceable>num</replaceable>}
13+
</arg>
14+
<arg choice="plain">
15+
<replaceable>path</replaceable>
16+
</arg>
17+
<arg choice="plain">
18+
{<replaceable>path</replaceable>}
19+
</arg>
20+
<arg choice="opt">
21+
<option>-</option>
22+
</arg>
23+
</cmdsynopsis>
24+
</refsynopsisdiv>
25+
26+
<refsect1><title>Description</title>
27+
<para>
28+
The optimizer reads the assembler source code text and removes
29+
redundant code and searches for code sequences that can be replaced
30+
by shorter and faster equivalents. The optimizer will shorten object
31+
code by about 11% with a significant increase in program execution
32+
speed. The optimizer is recommended for production versions of
33+
debugged programs.
34+
</para>
35+
<para>The '-' option will cause the optimizer to output statistics about its operation.
36+
</para>
37+
<para>
38+
The -i=<replaceable>num</replaceable> option determines how many instructions to look behind or ahead to find matching sequences.
39+
</para>
40+
</refsect1>
41+
<refsect1><title>Examples</title>
42+
<screen>
43+
c.opt source.asm output.asm
44+
45+
c.opt - ctmp.3.a ctmp.3.o
46+
47+
statistics:
48+
total instructions : 431
49+
long branches : 78, 16, 16%
50+
removed : 15, 3%
51+
total bytes : 1120, 71, 6%
52+
</screen>
53+
</refsect1>
54+
</refentry>
55+

‎manuals/os9guide/src/refentry-cobbler.xml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,12 +21,12 @@ from which OS-9 is to be bootstrapped. The boot file will consist
2121
of the <emphasis>same modules which were loaded into memory during the most recent bootstrap.</emphasis>
2222
To add modules to the bootstrap file use the
2323
<command>OS9Gen</command> command.
24-
<!--
25-
<command>Cobbler</command> also writes the OS-9 kernel on the first
26-
fifteen sectors of track 34, and excludes these sectors from the
27-
disk allocation map. If any files are present on these sectors
24+
25+
If the system is not booting from ROM, then <command>cobbler</command> also writes the OS-9 kernel on the boot track<footnote>
26+
<para>On the TRS-80 Color Computer, this is the first fifteen sectors of track 34. On Dragon 64, it is sectors 2-15 on track 0.</para>
27+
</footnote>, and excludes these sectors from the disk allocation map. If any files are present on these sectors
2828
<command>cobbler</command> will display an error message.
29-
-->
29+
3030
Level Two systems <emphasis>must</emphasis> use <command>OS9Gen</command> to create bootstrap files.
3131
</para>
3232
<para>

‎manuals/os9guide/src/refentry-dmode.xml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
<refnamediv>
33
<refname>DMODE<indexterm><primary>DMODE</primary></indexterm></refname>
44
<refpurpose>Disk descriptor Editor</refpurpose>
5+
<refclass>OS-9 Level Two</refclass>
56
</refnamediv>
67

78
<refsynopsisdiv>

‎manuals/os9guide/src/style.xslt

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,4 +70,10 @@
7070
<xsl:call-template name="inline.keycapseq"/>
7171
</xsl:template>
7272

73+
<xsl:template match="d:refentry">
74+
<fo:block break-before='page'>
75+
<xsl:apply-templates/>
76+
</fo:block>
77+
</xsl:template>
78+
7379
</xsl:stylesheet>

0 commit comments

Comments
 (0)