From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Thu, 24 May 2001 08:26:43 +0000 (+0000)
Subject: Added explanation for --codesize
X-Git-Tag: V2.12.0~2811
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=dfeefd6f790e9917b03ab444d033cb5d652a13be;p=cc65

Added explanation for --codesize


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

diff --git a/doc/Makefile b/doc/Makefile
index 85b9885bd..86bcfab38 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -31,7 +31,7 @@ TEX   = $(SGML:.sgml=.tex)
 	sgml2txt $<
 
 %.html:	%.sgml
-      	sgml2html --split=1 $<
+	sgml2html --split=1 $<
 
 %.info:	%.sgml
 	sgml2info $<
diff --git a/doc/cc65.sgml b/doc/cc65.sgml
index e25c2db83..b4c9146b1 100644
--- a/doc/cc65.sgml
+++ b/doc/cc65.sgml
@@ -78,6 +78,7 @@ Long options:
   --bss-name seg        Set the name of the BSS segment
   --check-stack         Generate stack overflow checks
   --code-name seg       Set the name of the CODE segment
+  --codesize x          Accept larger code by factor x
   --cpu type            Set cpu type
   --data-name seg       Set the name of the DATA segment
   --debug               Debug mode
@@ -114,7 +115,7 @@ Here is a description of all the command line options:
 
 
   <tag><tt>--check-stack</tt></tag>
-			
+
   Tells the compiler to generate code that checks for stack overflows. See
   <tt><ref id="pragma-checkstack" name="#pragma checkstack"></tt> for an
   explanation of this feature.
@@ -125,8 +126,16 @@ Here is a description of all the command line options:
   Set the name of the code segment.
 
 
-  <tag><tt>--cpu CPU</tt></tag>
+  <tag><tt>--codesize x</tt></tag>
+
+  This options allows finer control about speed vs. size decisions in the
+  code generation phase. It gives the allowed size increase factor (in 
+  percent). The default is 100 when not using <tt/-Oi/ and 200 when using
+  <tt/-Oi/ (<tt/-Oi/ is the same as <tt/--codesize 200/).
 
+
+  <tag><tt>--cpu CPU</tt></tag>
+		      
   A new, still experimental option. You may specify "6502" or "65C02" as
   the CPU. 6502 is the default, so this will not change anything.
   Specifying 65C02 will use a few 65C02 instructions when generating code.
@@ -254,7 +263,8 @@ Here is a description of all the command line options:
   Using <tt/-Oi/, the code generator will inline some code where otherwise a
   runtime functions would have been called, even if the generated code is
   larger. This will not only remove the overhead for a function call, but will
-  make the code visible for the optimizer.
+  make the code visible for the optimizer. <tt/-Oi/ is an alias for
+  <tt/--codesize 200/.
 
   <tt/-Or/ will make the compiler honor the <tt/register/ keyword. Local
   variables may be placed in registers (which are actually zero page