From 0d000bb629ce67386d39a880c0a9e1fdb1fff1a3 Mon Sep 17 00:00:00 2001 From: Brad Smith Date: Tue, 14 May 2019 19:33:55 -0400 Subject: [PATCH] Document --debug-opt-output and --debug-opt --- doc/cc65.sgml | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/doc/cc65.sgml b/doc/cc65.sgml index ed3386294..60b60861b 100644 --- a/doc/cc65.sgml +++ b/doc/cc65.sgml @@ -84,7 +84,8 @@ Long options: --data-name seg Set the name of the DATA segment --debug Debug mode --debug-info Add debug info to object file - --debug-opt name Debug optimization steps + --debug-opt name Configure optimizations with a file + --debug-opt-output Debug output of each optimization step --dep-target target Use this dependency target --disable-opt name Disable an optimization step --eagerly-inline-funcs Eagerly inline some known functions @@ -193,8 +194,26 @@ Here is a description of all the command line options: -d, --debug - Enables debug mode, something that should not be needed for mere - mortals:-) + Enables debug mode, for debugging the behavior of CC65. + + + --debug-opt name + + The named file contains a list of specific optimization steps to enable or disable. + Each line contains the name of an optimization step with either a + + (enable) or - (disable) prefix. + The name all can be used to enable or disable all optimizations. + Comment lines may begin with # or ;. + + Use --list-opt-steps to generate a complete list of available optimization steps. + + Use --debug to see a list of optimizations applied during compilation. + + + --debug-opt-output + + For debugging the output of each optimization pass, step by step. + Generates a name.opt output listing for each optimized function name.