Document computed gotos

[cc65] / doc / od65.sgml

diff --git a/doc/od65.sgml b/doc/od65.sgml
index 51f44b0306a639daf38f1f5d1a4c13dfca358db7..633f7b164d3a4ec33d801dd0939f63389ae07ca0 100644 (file)
--- a/doc/od65.sgml
+++ b/doc/od65.sgml
@@ -2,12 +2,11 @@
 
 <article>
 <title>od65 Users Guide
-<author>Ullrich von Bassewitz, <htmlurl url="mailto:uz@cc65.org" name="uz@cc65.org">
-<date>2010-07-30
+<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">
 
 <abstract>
 od65 is the object file dump utility. It is able to output most parts of
-<htmlurl url="ca65.html" name="ca65"> generated object files in readable form.
+<htmlurl url="ca65.html" name="ca65-generated"> object files in readable form.
 </abstract>
 
 <!-- Table of contents -->
@@ -19,7 +18,7 @@ od65 is the object file dump utility. It is able to output most parts of
 <sect>Overview<p>
 
 od65 is an object file dump utility. It is able to output most parts of
-<htmlurl url="ca65.html" name="ca65"> generated object files in readable form.
+<htmlurl url="ca65.html" name="ca65-generated"> object files in readable form.
 Since the contents and format of the object files are not documented
 elsewhere and may change at any time, this tool is a portable way to look at
 the contents.
@@ -65,7 +64,7 @@ Long options:
 </verb></tscreen>
 
 
-<sect1>Command line options in detail<p>
+<sect1>Command line options in detail<label id="cmdline-opt-detail"><p>
 
 Here is a description of all the command line options:
 
@@ -73,7 +72,7 @@ Here is a description of all the command line options:
 
   <tag><tt>--dump-all</tt></tag>
 
-  This will output all information, od65 is able to process. The option is a 
+  This will output all information, od65 is able to process. The option is a
   shortcut for specifying all the other <tt/--dump/ options.
 
 
@@ -102,11 +101,21 @@ Here is a description of all the command line options:
   Dump the list of imported symbols contained in the object file.
 
 
+  <tag><tt>--dump-lineinfo</tt></tag>
+
+  Dump the line info contained in the object file.
+
+
   <tag><tt>--dump-segments</tt></tag>
 
   Dump the list of segments contained in the object file.
 
 
+  <tag><tt>--dump-scopes</tt></tag>
+
+  Dump the scope (lexical level) information contained in the object file.
+
+
   <tag><tt>-S, --dump-segsize</tt></tag>
 
   Dump the sizes of all segments contained in the object file. This option is
@@ -131,8 +140,8 @@ Here is a description of all the command line options:
 
 The converter will read one or more object files per invocation and write the
 contents in readable format to standard output. Please note that you need to
-specify and of the <tt/--dump/ options listed above, otherwise no useful
-output will be generated.
+specify any of the <tt/--dump/ options listed <ref id="cmdline-opt-detail"
+name="above">, otherwise no useful output will be generated.
 
 Example output for the command
 <tscreen><verb>
@@ -177,15 +186,6 @@ t.o:
 </verb></tscreen>
 
 
-<sect>Bugs/Feedback<p>
-
-If you have problems using the converter, if you find any bugs, or if you're
-doing something interesting with the code, I would be glad to hear from you.
-Feel free to contact me by email (<htmlurl url="mailto:uz@cc65.org"
-name="uz@cc65.org">).
-
-
-
 <sect>Copyright<p>
 
 od65 is (C) Copyright 2000-2009, Ullrich von Bassewitz. For usage of the
@@ -200,15 +200,14 @@ including commercial applications, and to alter it and redistribute it
 freely, subject to the following restrictions:
 
 <enum>
-<item>         The origin of this software must not be misrepresented; you must not
-               claim that you wrote the original software. If you use this software
-               in a product, an acknowledgment in the product documentation would be
-       appreciated but is not required.
-<item> Altered source versions must be plainly marked as such, and must not
-       be misrepresented as being the original software.
-<item> This notice may not be removed or altered from any source
-       distribution.
+<item>  The origin of this software must not be misrepresented; you must not
+        claim that you wrote the original software. If you use this software
+        in a product, an acknowledgment in the product documentation would be
+        appreciated but is not required.
+<item>  Altered source versions must be plainly marked as such, and must not
+        be misrepresented as being the original software.
+<item>  This notice may not be removed or altered from any source
+        distribution.
 </enum>
 
 </article>
-