From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Fri, 27 Jan 2006 19:36:14 +0000 (+0000)
Subject: Document new --label-break option
X-Git-Tag: V2.12.0~155
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=ceffc4e090a948e6e03ee70422d9e5c7e845e429;p=cc65

Document new --label-break option


git-svn-id: svn://svn.cc65.org/cc65/trunk@3698 b7a2c559-68d2-44c3-8de9-860c34a00d81
---

diff --git a/doc/da65.sgml b/doc/da65.sgml
index 4dea35268..235b2755f 100644
--- a/doc/da65.sgml
+++ b/doc/da65.sgml
@@ -61,6 +61,7 @@ Long options:
   --formfeeds           Add formfeeds to the output
   --help                Help (this text)
   --info name           Specify an info file
+  --label-break n       Add newline if label exceeds length n
   --pagelength n        Set the page length for the listing
   --start-addr addr     Set the start/load address
   --verbose             Increase verbosity
@@ -132,6 +133,17 @@ Here is a description of all the command line options:
   the output will go to the terminal.
 
 
+  <label id="option--label-break">
+  <tag><tt>--label-break n</tt></tag>
+
+  Adds a newline if the length of a label exceeds the given length.
+  Note: If the label would run into the code in the mid column, a
+  linefeed is always inserted regardless of this setting.
+
+  This option overrides the <ref id="global-options" name="global option">
+  <tt><ref id="LABELBREAK" name="LABELBREAK"></tt>.
+
+
   <label id="option--pagelength">
   <tag><tt>--pagelength n</tt></tag>
 
@@ -277,6 +289,17 @@ following attributes are recognized:
   is ignored.
 
 
+  <label id="LABELBREAK">
+  <tag><tt>LABELBREAK</tt></tag>
+  <tt/LABELBREAK/ is followed by a numerical value that specifies the label
+  length that will force a newline. To have all labels on their own lines,
+  you may set this value to zero.
+
+  See also the <tt><ref id="option--label-break" name="--label-break"></tt>
+  command line option. A <tt/LABELBREAK/ statement in the info file will
+  override any value given on the command line.
+
+
   <label id="OUTPUTNAME">
   <tag><tt>OUTPUTNAME</tt></tag>
   The attribute is followed by string value, which gives the name of the