From aba0b6b439b5e1c3cd168916c76230c19f368588 Mon Sep 17 00:00:00 2001
From: mrdudz <mrdudz@users.noreply.github.com>
Date: Fri, 11 Jul 2025 17:52:03 +0200
Subject: [PATCH] add missing command line details, sort options

---
 doc/ca65.sgml | 68 ++++++++++++++++++++++++++++++---------------------
 1 file changed, 40 insertions(+), 28 deletions(-)

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index c34b14398..5e53fb002 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -208,6 +208,16 @@ Here is a description of all the command line options:
   mortals:-)
 
 
+  <label id="option-D">
+  <tag><tt>-D</tt></tag>
+
+  This option allows you to define symbols on the command line. Without a
+  value, the symbol is defined with the value zero. When giving a value,
+  you may use the '&dollar;' prefix for hexadecimal symbols. Please note
+  that for some operating systems, '&dollar;' has a special meaning, so
+  you may have to quote the expression.
+
+
   <label id="option--feature">
   <tag><tt>--feature name</tt></tag>
 
@@ -237,6 +247,16 @@ Here is a description of all the command line options:
   Print the short option summary shown above.
 
 
+  <label id="option-I">
+  <tag><tt>-I dir, --include-dir dir</tt></tag>
+
+  Name a directory which is searched for include files. The option may be
+  used more than once to specify more than one directory to search. The
+  current directory is always searched first before considering any
+  additional directories. See also the section about <ref id="search-paths"
+  name="search paths">.
+
+
   <label id="option-i">
   <tag><tt>-i, --ignore-case</tt></tag>
 
@@ -316,6 +336,12 @@ Here is a description of all the command line options:
 </itemize>
 
 
+  <label id="option-S">
+  <tag><tt>-S, --segment-list</tt></tag>
+
+  Add the segment ID in front of each address in the listing file.
+
+
   <label id="option-s">
   <tag><tt>-s, --smart-mode</tt></tag>
 
@@ -345,34 +371,6 @@ Here is a description of all the command line options:
   overridden by using the <tt/<ref id="option--cpu" name="--cpu">/ option.
 
 
-  <label id="option-v">
-  <tag><tt>-v, --verbose</tt></tag>
-
-  Increase the assembler verbosity. Usually only needed for debugging
-  purposes. You may use this option more than one time for even more
-  verbose output.
-
-
-  <label id="option-D">
-  <tag><tt>-D</tt></tag>
-
-  This option allows you to define symbols on the command line. Without a
-  value, the symbol is defined with the value zero. When giving a value,
-  you may use the '&dollar;' prefix for hexadecimal symbols. Please note
-  that for some operating systems, '&dollar;' has a special meaning, so
-  you may have to quote the expression.
-
-
-  <label id="option-I">
-  <tag><tt>-I dir, --include-dir dir</tt></tag>
-
-  Name a directory which is searched for include files. The option may be
-  used more than once to specify more than one directory to search. The
-  current directory is always searched first before considering any
-  additional directories. See also the section about <ref id="search-paths"
-  name="search paths">.
-
-
   <label id="option-U">
   <tag><tt>-U, --auto-import</tt></tag>
 
@@ -385,6 +383,14 @@ Here is a description of all the command line options:
   which is not always true for assembler programmers.
 
 
+  <label id="option-v">
+  <tag><tt>-v, --verbose</tt></tag>
+
+  Increase the assembler verbosity. Usually only needed for debugging
+  purposes. You may use this option more than one time for even more
+  verbose output.
+
+
   <label id="option-V">
   <tag><tt>-V, --version</tt></tag>
 
@@ -407,6 +413,12 @@ Here is a description of all the command line options:
   An error will be generated if any warnings were produced.
 
 
+  <label id="option-x">
+  <tag><tt>-x, --expand-macros</tt></tag>
+
+  In the listing file, show exactly how macros were expanded. Use twice for
+  more verbose output.
+
 </descrip>
 <p>