changeset 727:72443b44537e

Debug is part of the manual now. Template added for 'asm'
author roug
date Sun, 05 Jan 2003 11:17:50 +0000
parents a05075926716
children 4a267b967a5b
files docs/nitros9guide/chap7.chapter docs/nitros9guide/debug.refentry docs/nitros9guide/makefile
diffstat 3 files changed, 168 insertions(+), 72 deletions(-) [+]
line wrap: on
line diff
--- a/docs/nitros9guide/chap7.chapter	Sun Jan 05 11:17:50 2003 +0000
+++ b/docs/nitros9guide/chap7.chapter	Sun Jan 05 11:17:50 2003 +0000
@@ -90,6 +90,7 @@
 &copyref;
 &dateref;
 &dcheckref;
+&debugref;
 &delref;
 &deldirref;
 &dirref;
--- a/docs/nitros9guide/debug.refentry	Sun Jan 05 11:17:50 2003 +0000
+++ b/docs/nitros9guide/debug.refentry	Sun Jan 05 11:17:50 2003 +0000
@@ -14,76 +14,109 @@
 <para>
 Interactive Debugger.
 </para>
-<para>
-Command Summary:
-[SPACEBAR]expression
-Evaluate; display in hexadecimal and decimal form
-
-.
-Display dot address and contents
-
-..
-Restore last dot address; display address and contents
-
-.expression
-set dot to result of expression; display address and contents
-
-=expressoin
-Set memory at dot to result of expression
-
--
-Decrement dot; display address and contents
-
-[ENTER]
-Increment dot; display address and contents
-
-:
-Display all registers' contents
-
-:register
-Display the specified register's contents
-
-:register expression
-Set register to the result of expression
-
-E module-name
-Prepare for execution
+</refsect1>
+<refsect1><title>Command Summary</title>
 
-G
-Go to the program
-
-G expression
-Goto the program at the address specified by the result of expression
-
-L module-name
-Link to the module named; display address
-
-B
-Display all breakpoints
-
-B expression
-Set a breakpoint at the result of the expression
-
-K
-Kill all breakpoints
-
-K expression
-Kill the breakpoint at address specified by expression
-
-M expression1 expression2
-Display memory dump in tabular form
-
-C expression1 expression2
-Clear and test memory
-
-S expression1 expression2
-Search memory for pattern
-
-$ command
-Call OS-9 shell with optional command
-
-Q
-Quit (exit) Debug
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="2in"/>
+<colspec colwidth="3.0in"/>
+<tbody>
+<row>
+<entry>[SPACEBAR]expression</entry>
+<entry>Evaluate; display in hexadecimal and decimal form</entry>
+</row>
+<row>
+<entry>.</entry>
+<entry>Display dot address and contents</entry>
+</row>
+<row>
+<entry>..</entry>
+<entry>Restore last dot address; display address and contents</entry>
+</row>
+<row>
+<entry>.expression</entry>
+<entry>set dot to result of expression; display address and contents</entry>
+</row>
+<row>
+<entry>=expression</entry>
+<entry>Set memory at dot to result of expression</entry>
+</row>
+<row>
+<entry>-</entry>
+<entry>Decrement dot; display address and contents</entry>
+</row>
+<row>
+<entry>[ENTER]</entry>
+<entry>Increment dot; display address and contents</entry>
+</row>
+<row>
+<entry>:</entry>
+<entry>Display all registers' contents</entry>
+</row>
+<row>
+<entry>:register</entry>
+<entry>Display the specified register's contents</entry>
+</row>
+<row>
+<entry>:register expression</entry>
+<entry>Set register to the result of expression</entry>
+</row>
+<row>
+<entry>E module-name</entry>
+<entry>Prepare for execution</entry>
+</row>
+<row>
+<entry>G</entry>
+<entry>Go to the program</entry>
+</row>
+<row>
+<entry>G expression</entry>
+<entry>Goto the program at the address specified by the result of expression</entry>
+</row>
+<row>
+<entry>L module-name</entry>
+<entry>Link to the module named; display address</entry>
+</row>
+<row>
+<entry>B</entry>
+<entry>Display all breakpoints</entry>
+</row>
+<row>
+<entry>B expression</entry>
+<entry>Set a breakpoint at the result of the expression</entry>
+</row>
+<row>
+<entry>K</entry>
+<entry>Kill all breakpoints</entry>
+</row>
+<row>
+<entry>K expression</entry>
+<entry>Kill the breakpoint at address specified by expression</entry>
+</row>
+<row>
+<entry>M expression1 expression2</entry>
+<entry>Display memory dump in tabular form</entry>
+</row>
+<row>
+<entry>C expression1 expression2</entry>
+<entry>Clear and test memory</entry>
+</row>
+<row>
+<entry>S expression1 expression2</entry>
+<entry>Search memory for pattern</entry>
+</row>
+<row>
+<entry>$ command</entry>
+<entry>Call OS-9 shell with optional command</entry>
+</row>
+<row>
+<entry>Q</entry>
+<entry>Quit (exit) Debug</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
 </refsect1>
 </refentry>
 
--- a/docs/nitros9guide/makefile	Sun Jan 05 11:17:50 2003 +0000
+++ b/docs/nitros9guide/makefile	Sun Jan 05 11:17:50 2003 +0000
@@ -3,14 +3,14 @@
 
 all:	$(BOOK).pdf
 
-$(BOOK).pdf: $(BOOK).docbook
+$(BOOK).pdf: $(BOOK).docbook $(SRCS)
 	 docbook2pdf -d docbook-utils-a4.dsl#print $(BOOK).docbook
 
-$(BOOK).ps: $(BOOK).docbook
+$(BOOK).ps: $(BOOK).docbook $(SRCS)
 	 docbook2ps -d docbook-utils-a4.dsl#print $(BOOK).docbook
 #	 docbook2ps -d $(STYLESHEET) $(BOOK).docbook
 
-$(BOOK).html: $(BOOK).docbook
+$(BOOK).html: $(BOOK).docbook $(SRCS)
 	$(RM) *.htm *.html
 #	jade -t sgml -V html-index -d /usr/share/sgml/docbook/dsssl-stylesheets-1.64/html/docbook.dsl $(BOOK).docbook
 #	collateindex.pl -p -o index.docbook HTML.index
@@ -21,3 +21,65 @@
 
 clean:
 	$(RM) *.htm *.html $(BOOK).pdf $(BOOK).ps
+SRCS          = $(CHAPS) $(APXS) $(REFS)
+CHAPS         = intro.preface \
+                chap1.chapter chap2.chapter chap3.chapter chap4.chapter \
+                chap5.chapter chap6.chapter chap7.chapter
+APXS          = acia51.appendix display.appendix errorcodes.appendix keys.appendix
+REFS          = asm.refentry \
+                attr.refentry \
+                backup.refentry \
+                binex.refentry \
+                build.refentry \
+                chd.refentry \
+                cmp.refentry \
+                cobbler.refentry \
+                config.refentry \
+                copy.refentry \
+                date.refentry \
+                dcheck.refentry \
+                debug.refentry \
+                deiniz.refentry \
+                deldir.refentry \
+                del.refentry \
+                dir.refentry \
+                display.refentry \
+                dsave.refentry \
+                dump.refentry \
+                echo.refentry \
+                error.refentry \
+                ex.refentry \
+                format.refentry \
+                free.refentry \
+                go51.appendix \
+                go51.refentry \
+                help.refentry \
+                ident.refentry \
+                iniz.refentry \
+                kill.refentry \
+                link.refentry \
+                list.refentry \
+                load.refentry \
+                login.refentry \
+                makdir.refentry \
+                mdir.refentry \
+                merge.refentry \
+                mfree.refentry \
+                os9gen.refentry \
+                park.refentry \
+                printerr.refentry \
+                procs.refentry \
+                pwd.refentry \
+                rename.refentry \
+                save.refentry \
+                setime.refentry \
+                setpr.refentry \
+                shell.refentry \
+                sleep.refentry \
+                tee.refentry \
+                tmode.refentry \
+                tsmon.refentry \
+                tuneport.refentry \
+                unlink.refentry \
+                verify.refentry \
+                xmode.refentry