2010-06-11 15:38:22 +00:00
/*
AppleWin : An Apple //e emulator for Windows
Copyright ( C ) 1994 - 1996 , Michael O ' Brien
Copyright ( C ) 1999 - 2001 , Oliver Schmidt
Copyright ( C ) 2002 - 2005 , Tom Charlesworth
2014-08-28 18:13:02 +00:00
Copyright ( C ) 2006 - 2014 , Tom Charlesworth , Michael Pohoreski
2010-06-11 15:38:22 +00:00
AppleWin is free software ; you can redistribute it and / or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation ; either version 2 of the License , or
( at your option ) any later version .
AppleWin is distributed in the hope that it will be useful ,
but WITHOUT ANY WARRANTY ; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE . See the
GNU General Public License for more details .
You should have received a copy of the GNU General Public License
along with AppleWin ; if not , write to the Free Software
Foundation , Inc . , 59 Temple Place , Suite 330 , Boston , MA 02111 - 1307 USA
*/
/* Description: Debugger
*
2010-12-18 15:00:04 +00:00
* Author : Copyright ( C ) 2006 - 2010 Michael Pohoreski
2010-06-11 15:38:22 +00:00
*/
# include "StdAfx.h"
2016-09-10 12:46:09 +00:00
# include <cstdarg>
2014-08-13 20:30:35 +00:00
# include "Debug.h"
2020-11-26 21:50:06 +00:00
# include "../Core.h"
2014-08-13 20:30:35 +00:00
2010-06-11 15:38:22 +00:00
# define DEBUG_COLOR_CONSOLE 0
// Utility ________________________________________________________________________________________
/*
String types :
http : //www.codeproject.com/cpp/unicode.asp
TEXT ( ) _tcsrev
_UNICODE Unicode _wcsrev
_MBCS Multi - byte _mbsrev
n / a ASCII strrev
*/
// tests if pSrc fits into pDst
// returns true if pSrc safely fits into pDst, else false (pSrc would of overflowed pDst)
//===========================================================================
bool TestStringCat ( TCHAR * pDst , LPCSTR pSrc , const int nDstSize )
{
int nLenDst = _tcslen ( pDst ) ;
int nLenSrc = _tcslen ( pSrc ) ;
int nSpcDst = nDstSize - nLenDst ;
bool bOverflow = ( nSpcDst < = nLenSrc ) ; // 2.5.6.25 BUGFIX
if ( bOverflow )
{
return false ;
}
return true ;
}
// tests if pSrc fits into pDst
// returns true if pSrc safely fits into pDst, else false (pSrc would of overflowed pDst)
//===========================================================================
bool TryStringCat ( TCHAR * pDst , LPCSTR pSrc , const int nDstSize )
{
int nLenDst = _tcslen ( pDst ) ;
int nLenSrc = _tcslen ( pSrc ) ;
int nSpcDst = nDstSize - nLenDst ;
int nChars = MIN ( nLenSrc , nSpcDst ) ;
bool bOverflow = ( nSpcDst < nLenSrc ) ;
if ( bOverflow )
{
return false ;
}
_tcsncat ( pDst , pSrc , nChars ) ;
return true ;
}
// cats string as much as possible
// returns true if pSrc safely fits into pDst, else false (pSrc would of overflowed pDst)
//===========================================================================
int StringCat ( TCHAR * pDst , LPCSTR pSrc , const int nDstSize )
{
int nLenDst = _tcslen ( pDst ) ;
int nLenSrc = _tcslen ( pSrc ) ;
int nSpcDst = nDstSize - nLenDst ;
int nChars = MIN ( nLenSrc , nSpcDst ) ;
_tcsncat ( pDst , pSrc , nChars ) ;
bool bOverflow = ( nSpcDst < nLenSrc ) ;
if ( bOverflow )
return 0 ;
return nChars ;
}
// Help ___________________________________________________________________________________________
//===========================================================================
Update_t HelpLastCommand ( )
{
return Help_Arg_1 ( g_iCommand ) ;
}
// Loads the arguments with the command to get help on and call display help.
//===========================================================================
Update_t Help_Arg_1 ( int iCommandHelp )
{
_Arg_1 ( iCommandHelp ) ;
2015-07-30 15:20:27 +00:00
wsprintf ( g_aArgs [ 1 ] . sArg , " %s " , g_aCommands [ iCommandHelp ] . m_sName ) ; // .3 Fixed: Help_Arg_1() now copies command name into arg.name
2010-06-11 15:38:22 +00:00
return CmdHelpSpecific ( 1 ) ;
}
//===========================================================================
void Help_Categories ( )
{
const int nBuf = CONSOLE_WIDTH * 2 ;
char sText [ nBuf ] = " " ;
int nLen = 0 ;
// TODO/FIXME: Colorize( sText, ... )
// Colorize("Usage:")
nLen + = StringCat ( sText , CHC_USAGE , nBuf ) ;
nLen + = StringCat ( sText , " Usage " , nBuf ) ;
nLen + = StringCat ( sText , CHC_DEFAULT , nBuf ) ;
nLen + = StringCat ( sText , " : " , nBuf ) ;
nLen + = StringCat ( sText , CHC_ARG_OPT , nBuf ) ;
nLen + = StringCat ( sText , " [ " , nBuf ) ;
nLen + = StringCat ( sText , CHC_ARG_MAND , nBuf ) ;
nLen + = StringCat ( sText , " < " , nBuf ) ;
for ( int iCategory = _PARAM_HELPCATEGORIES_BEGIN ; iCategory < _PARAM_HELPCATEGORIES_END ; iCategory + + )
{
char * pName = g_aParameters [ iCategory ] . m_sName ;
if ( nLen + strlen ( pName ) > = ( CONSOLE_WIDTH - 1 ) )
{
ConsolePrint ( sText ) ;
sText [ 0 ] = 0 ;
nLen = StringCat ( sText , " " , nBuf ) ; // indent
}
StringCat ( sText , CHC_COMMAND , nBuf ) ;
nLen + = StringCat ( sText , pName , nBuf ) ;
if ( iCategory < ( _PARAM_HELPCATEGORIES_END - 1 ) )
{
char sSep [ ] = " | " ;
if ( nLen + strlen ( sSep ) > = ( CONSOLE_WIDTH - 1 ) )
{
ConsolePrint ( sText ) ;
sText [ 0 ] = 0 ;
nLen = StringCat ( sText , " " , nBuf ) ; // indent
}
StringCat ( sText , CHC_ARG_SEP , nBuf ) ;
nLen + = StringCat ( sText , sSep , nBuf ) ;
}
}
StringCat ( sText , CHC_ARG_MAND , nBuf ) ;
StringCat ( sText , " > " , nBuf ) ;
StringCat ( sText , CHC_ARG_OPT , nBuf ) ;
StringCat ( sText , " ] " , nBuf ) ;
// ConsoleBufferPush( sText );
ConsolePrint ( sText ) ; // Transcode colored text to native console color text
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %sNotes%s: %s<>%s = mandatory, %s[]%s = optional, %s|%s argument option "
2010-06-11 15:38:22 +00:00
, CHC_USAGE
, CHC_DEFAULT
, CHC_ARG_MAND
, CHC_DEFAULT
, CHC_ARG_OPT
, CHC_DEFAULT
, CHC_ARG_SEP
, CHC_DEFAULT
) ;
// ConsoleBufferPush( sText );
}
void Help_Examples ( )
{
char sText [ CONSOLE_WIDTH ] ;
2017-08-24 19:36:46 +00:00
ConsolePrintFormat ( sText , " %sExamples%s:%s "
2010-06-11 15:38:22 +00:00
, CHC_USAGE
2017-08-24 19:36:46 +00:00
, CHC_ARG_SEP
2010-06-11 15:38:22 +00:00
, CHC_DEFAULT
) ;
}
//===========================================================================
void Help_Range ( )
{
ConsoleBufferPush ( " Where <range> is of the form: " ) ;
ConsoleBufferPush ( " address , length [address,address+length) " ) ;
ConsoleBufferPush ( " address : end [address,end] " ) ;
}
//===========================================================================
void Help_Operators ( )
{
char sText [ CONSOLE_WIDTH ] ;
2016-09-10 12:46:09 +00:00
// ConsolePrintFormat( sText," %sOperators%s:" , CHC_USAGE, CHC_DEFAULT );
// ConsolePrintFormat( sText," Operators: (Math)" );
ConsolePrintFormat ( sText , " Operators: (%sMath%s) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s+%s Addition " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s-%s Subtraction " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s*%s Multiplication " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s/%s Division " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s%%%s Modulas or Remainder " , CHC_USAGE , CHC_DEFAULT ) ;
2010-06-11 15:38:22 +00:00
//ConsoleBufferPush( " Operators: (Bit Wise)" );
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " Operators: (%sBit Wise%s) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s&%s Bit-wise and (AND) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s|%s Bit-wise or (OR ) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s^%s Bit-wise exclusive-or (EOR/XOR) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s!%s Bit-wise negation (NOT) " , CHC_USAGE , CHC_DEFAULT ) ;
2010-06-11 15:38:22 +00:00
//ConsoleBufferPush( " Operators: (Input)" );
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " Operators: (%sInput%s) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s@%s next number refers to search results " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s \" %s Designate string in ASCII format " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s \' %s Desginate string in High-Bit apple format " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s$%s Designate number/symbol " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s#%s Designate number in hex " , CHC_USAGE , CHC_DEFAULT ) ;
2010-06-11 15:38:22 +00:00
//ConsoleBufferPush( " Operators: (Range)" );
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " Operators: (%sRange%s) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s,%s range seperator (2nd address is relative) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s:%s range seperator (2nd address is absolute) " , CHC_USAGE , CHC_DEFAULT ) ;
// ConsolePrintFormat( sText," Operators: (Misc)" );
ConsolePrintFormat ( sText , " Operators: (%sMisc%s) " , CHC_USAGE , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s//%s comment until end of line " , CHC_USAGE , CHC_DEFAULT ) ;
2010-06-11 15:38:22 +00:00
//ConsoleBufferPush( " Operators: (Breakpoint)" );
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " Operators: (%sBreakpoint%s) " , CHC_USAGE , CHC_DEFAULT ) ;
2010-06-11 15:38:22 +00:00
_tcscpy ( sText , " " ) ;
2021-04-23 19:39:24 +00:00
strcat ( sText , CHC_USAGE ) ;
2010-06-11 15:38:22 +00:00
int iBreakOp = 0 ;
for ( iBreakOp = 0 ; iBreakOp < NUM_BREAKPOINT_OPERATORS ; iBreakOp + + )
{
if ( ( iBreakOp > = PARAM_BP_LESS_EQUAL ) & &
( iBreakOp < = PARAM_BP_GREATER_EQUAL ) )
{
2021-04-23 19:39:24 +00:00
strcat ( sText , g_aBreakpointSymbols [ iBreakOp ] ) ;
strcat ( sText , " " ) ;
2010-06-11 15:38:22 +00:00
}
}
2021-04-23 19:39:24 +00:00
strcat ( sText , CHC_DEFAULT ) ;
2010-06-11 15:38:22 +00:00
ConsolePrint ( sText ) ;
}
void Help_KeyboardShortcuts ( )
{
ConsoleBufferPush ( " Scrolling: " ) ;
ConsoleBufferPush ( " Up Arrow " ) ;
ConsoleBufferPush ( " Down Arrow " ) ;
ConsoleBufferPush ( " Shift + Up Arrow " ) ;
ConsoleBufferPush ( " Shift + Down Arrow " ) ;
ConsoleBufferPush ( " Page Up " ) ;
ConsoleBufferPush ( " Page Down " ) ;
ConsoleBufferPush ( " Shift + Page Up " ) ;
ConsoleBufferPush ( " Shift + Page Down " ) ;
ConsoleBufferPush ( " Bookmarks: " ) ;
ConsoleBufferPush ( " Ctrl-Shift-# " ) ;
ConsoleBufferPush ( " Ctrl-# " ) ;
}
void _ColorizeHeader (
char * & pDst , const char * & pSrc ,
const char * pHeader , const int nHeaderLen )
{
int nLen ;
nLen = strlen ( CHC_USAGE ) ;
strcpy ( pDst , CHC_USAGE ) ;
pDst + = nLen ;
nLen = nHeaderLen - 1 ;
strncpy ( pDst , pHeader , nLen ) ;
pDst + = nLen ;
pSrc + = nHeaderLen ;
nLen = strlen ( CHC_ARG_SEP ) ;
strcpy ( pDst , CHC_ARG_SEP ) ;
pDst + = nLen ;
* pDst = ' : ' ;
pDst + + ;
nLen = strlen ( CHC_DEFAULT ) ;
strcpy ( pDst , CHC_DEFAULT ) ;
pDst + = nLen ;
}
2017-08-24 19:36:46 +00:00
void _ColorizeString (
char * & pDst ,
const char * pSrc , const size_t nLen )
{
strcpy ( pDst , pSrc ) ;
pDst + = nLen ;
}
// pOperator is one of CHC_*
2010-06-11 15:38:22 +00:00
void _ColorizeOperator (
char * & pDst , const char * & pSrc ,
2021-02-10 21:05:00 +00:00
const char * pOperator )
2010-06-11 15:38:22 +00:00
{
int nLen ;
nLen = strlen ( pOperator ) ;
strcpy ( pDst , pOperator ) ;
pDst + = nLen ;
* pDst = * pSrc ;
pDst + + ;
nLen = strlen ( CHC_DEFAULT ) ;
strcpy ( pDst , CHC_DEFAULT ) ;
pDst + = nLen ;
pSrc + + ;
}
2017-08-24 19:36:46 +00:00
bool isHexDigit ( char c )
{
if ( ( c > = ' 0 ' ) & & ( c < = ' 9 ' ) ) return true ;
if ( ( c > = ' A ' ) & & ( c < = ' F ' ) ) return true ;
if ( ( c > = ' a ' ) & & ( c < = ' f ' ) ) return true ;
return false ;
}
2010-06-11 15:38:22 +00:00
bool Colorize ( char * pDst , const char * pSrc )
{
if ( ! pSrc )
return false ;
if ( ! pDst )
return false ;
const char sNote [ ] = " Note: " ;
const int nNote = sizeof ( sNote ) - 1 ;
const char sSeeAlso [ ] = " See also: " ;
const char nSeeAlso = sizeof ( sSeeAlso ) - 1 ;
const char sUsage [ ] = " Usage: " ;
const int nUsage = sizeof ( sUsage ) - 1 ;
const char sTotal [ ] = " Total: " ;
const int nTotal = sizeof ( sTotal ) - 1 ;
2017-08-24 19:36:46 +00:00
const char sExamples [ ] = " Examples: " ;
const int nExamples = sizeof ( sExamples ) - 1 ;
2010-06-11 15:38:22 +00:00
while ( * pSrc )
{
if ( strncmp ( sUsage , pSrc , nUsage ) = = 0 )
{
_ColorizeHeader ( pDst , pSrc , sUsage , nUsage ) ;
}
else
if ( strncmp ( sSeeAlso , pSrc , nSeeAlso ) = = 0 )
{
_ColorizeHeader ( pDst , pSrc , sSeeAlso , nSeeAlso ) ;
}
else
if ( strncmp ( sNote , pSrc , nNote ) = = 0 )
{
_ColorizeHeader ( pDst , pSrc , sNote , nNote ) ;
}
else
if ( strncmp ( sTotal , pSrc , nNote ) = = 0 )
{
_ColorizeHeader ( pDst , pSrc , sTotal , nTotal ) ;
}
else
2017-08-24 19:36:46 +00:00
if ( strncmp ( sExamples , pSrc , nExamples ) = = 0 )
{
_ColorizeHeader ( pDst , pSrc , sExamples , nExamples ) ;
}
else
2010-06-11 15:38:22 +00:00
if ( * pSrc = = ' [ ' )
{
_ColorizeOperator ( pDst , pSrc , CHC_ARG_OPT ) ;
}
else
if ( * pSrc = = ' ] ' )
{
_ColorizeOperator ( pDst , pSrc , CHC_ARG_OPT ) ;
}
else
if ( * pSrc = = ' < ' )
{
_ColorizeOperator ( pDst , pSrc , CHC_ARG_MAND ) ;
}
else
if ( * pSrc = = ' > ' )
{
_ColorizeOperator ( pDst , pSrc , CHC_ARG_MAND ) ;
}
else
if ( * pSrc = = ' | ' )
{
_ColorizeOperator ( pDst , pSrc , CHC_ARG_SEP ) ;
}
else
if ( * pSrc = = ' \' ' )
{
_ColorizeOperator ( pDst , pSrc , CHC_ARG_SEP ) ;
}
else
2017-08-24 19:36:46 +00:00
if ( ( * pSrc = = ' $ ' ) & & isHexDigit ( pSrc [ 1 ] ) ) // Hex Number
{
_ColorizeOperator ( pDst , pSrc , CHC_ARG_SEP ) ;
const char * start = pSrc ;
const char * end = pSrc ;
while ( isHexDigit ( * end ) )
end + + ;
size_t nDigits = end - start ;
_ColorizeString ( pDst , CHC_NUM_HEX , strlen ( CHC_NUM_HEX ) ) ;
_ColorizeString ( pDst , start , nDigits ) ;
_ColorizeString ( pDst , CHC_DEFAULT , strlen ( CHC_DEFAULT ) ) ;
pSrc + = nDigits ;
}
else
2010-06-11 15:38:22 +00:00
{
* pDst = * pSrc ;
pDst + + ;
pSrc + + ;
}
}
* pDst = 0 ;
return true ;
}
2017-08-24 19:36:46 +00:00
// NOTE: This appends a new line
2016-09-10 12:46:09 +00:00
inline bool ConsoleColorizePrint ( char * colorizeBuf , size_t /*colorizeBufSz*/ ,
const char * pText )
{
if ( ! Colorize ( colorizeBuf , pText ) ) return false ;
return ConsolePrint ( colorizeBuf ) ;
}
template < size_t _ColorizeBufSz >
inline bool ConsoleColorizePrint ( char ( & colorizeBuf ) [ _ColorizeBufSz ] ,
const char * pText )
{
return ConsoleColorizePrint ( colorizeBuf , _ColorizeBufSz , pText ) ;
}
inline bool ConsoleColorizePrintVa ( char * colorizeBuf , size_t colorizeBufSz ,
char * buf , size_t bufsz ,
const char * format , va_list va )
{
vsnprintf_s ( buf , bufsz , _TRUNCATE , format , va ) ;
return ConsoleColorizePrint ( colorizeBuf , colorizeBufSz , buf ) ;
}
template < size_t _ColorizeBufSz , size_t _BufSz >
inline bool ConsoleColorizePrintVa ( char ( & colorizeBuf ) [ _ColorizeBufSz ] ,
char ( & buf ) [ _BufSz ] ,
const char * format , va_list va )
{
return ConsoleColorizePrintVa ( colorizeBuf , _ColorizeBufSz , buf , _BufSz , format , va ) ;
}
inline bool ConsoleColorizePrintFormat ( char * colorizeBuf , size_t colorizeBufSz ,
char * buf , size_t bufsz ,
const char * format , . . . )
{
va_list va ;
va_start ( va , format ) ;
bool const r = ConsoleColorizePrintVa ( colorizeBuf , colorizeBufSz , buf , bufsz , format , va ) ;
va_end ( va ) ;
return r ;
}
template < size_t _ColorizeBufSz , size_t _BufSz >
inline bool ConsoleColorizePrintFormat ( char ( & colorizeBuf ) [ _ColorizeBufSz ] ,
char ( & buf ) [ _BufSz ] ,
const char * format , . . . )
{
va_list va ;
va_start ( va , format ) ;
bool const r = ConsoleColorizePrintVa ( colorizeBuf , buf , format , va ) ;
va_end ( va ) ;
return r ;
}
2010-06-11 15:38:22 +00:00
//===========================================================================
2012-12-29 14:53:52 +00:00
Update_t CmdMOTD ( int nArgs ) // Message Of The Day
2010-06-11 15:38:22 +00:00
{
char sText [ CONSOLE_WIDTH * 2 ] ;
char sTemp [ CONSOLE_WIDTH * 2 ] ;
# if DEBUG_COLOR_CONSOLE
ConsolePrint ( " ` " ) ;
ConsolePrint ( " `A " ) ;
ConsolePrint ( " `2`A " ) ;
# endif
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " `9`A`7 Apple `9][ ][+ //e `7Emulator for Windows (TM) `9`@ " ) ;
2010-06-11 15:38:22 +00:00
CmdVersion ( 0 ) ;
CmdSymbols ( 0 ) ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " '%sCtrl ~'%s console, '%s%s'%s (specific), '%s%s'%s (all) "
2010-06-11 15:38:22 +00:00
, CHC_KEY
, CHC_DEFAULT
, CHC_COMMAND
, g_aCommands [ CMD_HELP_SPECIFIC ] . m_sName
, CHC_DEFAULT
// , g_aCommands[ CMD_HELP_SPECIFIC ].pHelpSummary
, CHC_COMMAND
, g_aCommands [ CMD_HELP_LIST ] . m_sName
, CHC_DEFAULT
// , g_aCommands[ CMD_HELP_LIST ].pHelpSummary
) ;
ConsoleUpdate ( ) ;
return UPDATE_ALL ;
}
// Help on specific command
//===========================================================================
Update_t CmdHelpSpecific ( int nArgs )
{
int iArg ;
char sText [ CONSOLE_WIDTH * 2 ] ;
char sTemp [ CONSOLE_WIDTH * 2 ] ;
2020-12-10 21:08:15 +00:00
memset ( sText , 0 , CONSOLE_WIDTH * 2 ) ;
memset ( sTemp , 0 , CONSOLE_WIDTH * 2 ) ;
2010-06-11 15:38:22 +00:00
if ( ! nArgs )
{
Help_Categories ( ) ;
return ConsoleUpdate ( ) ;
}
CmdFuncPtr_t pFunction = NULL ;
bool bAllCommands = false ;
bool bCategory = false ;
bool bDisplayCategory = true ;
if ( ( ! _tcscmp ( g_aArgs [ 1 ] . sArg , g_aParameters [ PARAM_WILDSTAR ] . m_sName ) ) | |
( ! _tcscmp ( g_aArgs [ 1 ] . sArg , g_aParameters [ PARAM_MEM_SEARCH_WILD ] . m_sName ) ) )
{
bAllCommands = true ;
nArgs = NUM_COMMANDS ;
}
// If Help on category, push command name as arg
// Mame has categories:
// General, Memory, Execution, Breakpoints, Watchpoints, Expressions, Comments
int iParam = 0 ;
int nNewArgs = 0 ;
int iCmdBegin = 0 ;
int iCmdEnd = 0 ;
int nFound = 0 ;
int iCommand = 0 ;
if ( ! bAllCommands )
{
for ( iArg = 1 ; iArg < = nArgs ; iArg + + )
{
// int nFoundCategory = FindParam( g_aArgs[ iArg ].sArg, MATCH_EXACT, iParam, _PARAM_HELPCATEGORIES_BEGIN, _PARAM_HELPCATEGORIES_END );
int nFoundCategory = FindParam ( g_aArgs [ iArg ] . sArg , MATCH_FUZZY , iParam , _PARAM_HELPCATEGORIES_BEGIN , _PARAM_HELPCATEGORIES_END ) ;
2011-02-20 23:29:30 +00:00
if ( nFoundCategory )
bCategory = true ;
else
bCategory = false ;
2010-06-11 15:38:22 +00:00
switch ( iParam )
{
case PARAM_CAT_BOOKMARKS : iCmdBegin = CMD_BOOKMARK ; iCmdEnd = CMD_BOOKMARK_SAVE ; break ;
2011-02-21 23:54:09 +00:00
case PARAM_CAT_BREAKPOINTS : iCmdBegin = CMD_BREAK_INVALID ; iCmdEnd = CMD_BREAKPOINT_SAVE ; break ;
2017-02-25 22:32:46 +00:00
case PARAM_CAT_CONFIG : iCmdBegin = CMD_BENCHMARK ; iCmdEnd = CMD_CONFIG_SET_DEBUG_DIR ; break ;
2010-06-11 15:38:22 +00:00
case PARAM_CAT_CPU : iCmdBegin = CMD_ASSEMBLE ; iCmdEnd = CMD_UNASSEMBLE ; break ;
case PARAM_CAT_FLAGS :
2011-02-20 23:29:30 +00:00
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ; // check if we have an exact command match first
if ( nFound ) // && (iCommand != CMD_MEMORY_FILL))
bCategory = false ;
else if ( nFoundCategory )
2010-06-11 15:38:22 +00:00
{
iCmdBegin = CMD_FLAG_CLEAR ; iCmdEnd = CMD_FLAG_SET_N ;
}
break ;
case PARAM_CAT_HELP : iCmdBegin = CMD_HELP_LIST ; iCmdEnd = CMD_MOTD ; break ;
case PARAM_CAT_KEYBOARD :
2011-02-20 23:29:30 +00:00
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ; // check if we have an exact command match first
2010-06-11 15:38:22 +00:00
if ( ( ! nFound ) | | ( iCommand ! = CMD_INPUT_KEY ) )
{
nArgs = 0 ;
Help_KeyboardShortcuts ( ) ;
}
bCategory = false ;
break ;
case PARAM_CAT_MEMORY :
2011-02-20 23:29:30 +00:00
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ; // check if we have an exact command match first
if ( nFound ) // && (iCommand != CMD_MEMORY_MOVE))
bCategory = false ;
else if ( nFoundCategory )
2010-06-11 15:38:22 +00:00
{
2011-02-20 23:29:30 +00:00
iCmdBegin = CMD_MEMORY_COMPARE ; iCmdEnd = CMD_MEMORY_FILL ;
2010-06-11 15:38:22 +00:00
}
break ;
case PARAM_CAT_OUTPUT :
2011-02-20 23:29:30 +00:00
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ; // check if we have an exact command match first
if ( nFound ) // && (iCommand != CMD_OUT))
bCategory = false ;
else if ( nFoundCategory )
2010-06-11 15:38:22 +00:00
{
2011-02-20 23:29:30 +00:00
iCmdBegin = CMD_OUTPUT_CALC ; iCmdEnd = CMD_OUTPUT_RUN ;
2010-06-11 15:38:22 +00:00
}
break ;
case PARAM_CAT_SYMBOLS :
2011-02-20 23:29:30 +00:00
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ; // check if we have an exact command match first
if ( nFound ) // && (iCommand != CMD_SYMBOLS_LOOKUP) && (iCommand != CMD_MEMORY_SEARCH))
bCategory = false ;
else if ( nFoundCategory )
2010-06-11 15:38:22 +00:00
{
2011-02-20 23:29:30 +00:00
iCmdBegin = CMD_SYMBOLS_LOOKUP ; iCmdEnd = CMD_SYMBOLS_LIST ;
2010-06-11 15:38:22 +00:00
}
break ;
case PARAM_CAT_VIEW :
{
2011-02-20 23:29:30 +00:00
iCmdBegin = CMD_VIEW_TEXT4X ; iCmdEnd = CMD_VIEW_DHGR2 ;
2010-06-11 15:38:22 +00:00
}
break ;
case PARAM_CAT_WATCHES :
2011-02-20 23:29:30 +00:00
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ; // check if we have an exact command match first
if ( nFound ) {
bCategory = false ;
2011-02-20 23:30:04 +00:00
} else // 2.7.0.17: HELP <category> wasn't displaying when category was one of: FLAGS, OUTPUT, WATCHES
2011-02-20 23:29:30 +00:00
if ( nFoundCategory )
{
iCmdBegin = CMD_WATCH_ADD ; iCmdEnd = CMD_WATCH_LIST ;
}
2010-06-11 15:38:22 +00:00
break ;
case PARAM_CAT_WINDOW : iCmdBegin = CMD_WINDOW ; iCmdEnd = CMD_WINDOW_OUTPUT ; break ;
2011-02-20 23:29:30 +00:00
case PARAM_CAT_ZEROPAGE : iCmdBegin = CMD_ZEROPAGE_POINTER ; iCmdEnd = CMD_ZEROPAGE_POINTER_SAVE ; break ;
2010-06-11 15:38:22 +00:00
// case PARAM_CAT_EXPRESSION : // fall-through
case PARAM_CAT_OPERATORS : nArgs = 0 ; Help_Operators ( ) ; break ;
case PARAM_CAT_RANGE :
// HACK: check if we have an exact command match first
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ;
if ( ( ! nFound ) | | ( iCommand ! = CMD_REGISTER_SET ) )
{
nArgs = 0 ;
Help_Range ( ) ;
}
bCategory = false ;
break ;
default :
bCategory = false ;
break ;
}
if ( iCmdEnd )
iCmdEnd + + ;
nNewArgs = ( iCmdEnd - iCmdBegin ) ;
if ( nNewArgs > 0 )
break ;
}
}
if ( nNewArgs > 0 )
{
nArgs = nNewArgs ;
for ( iArg = 1 ; iArg < = nArgs ; iArg + + )
{
# if DEBUG_VAL_2
g_aArgs [ iArg ] . nVal2 = iCmdBegin + iArg - 1 ;
# endif
g_aArgs [ iArg ] . nValue = iCmdBegin + iArg - 1 ;
}
}
for ( iArg = 1 ; iArg < = nArgs ; iArg + + )
{
iCommand = 0 ;
nFound = 0 ;
if ( bCategory )
{
# if DEBUG_VAL_2
iCommand = g_aArgs [ iArg ] . nVal2 ;
# endif
iCommand = g_aArgs [ iArg ] . nValue ;
nFound = 1 ;
}
else
if ( bAllCommands )
{
iCommand = iArg ;
if ( iCommand = = NUM_COMMANDS ) // skip: Internal Consistency Check __COMMANDS_VERIFY_TXT__
continue ;
nFound = 1 ;
}
else
nFound = FindCommand ( g_aArgs [ iArg ] . sArg , pFunction , & iCommand ) ;
if ( nFound > 1 )
{
DisplayAmbigiousCommands ( nFound ) ;
}
if ( iCommand > NUM_COMMANDS )
continue ;
if ( ( nArgs = = 1 ) & & ( ! nFound ) )
iCommand = g_aArgs [ iArg ] . nValue ;
Command_t * pCommand = & g_aCommands [ iCommand ] ;
if ( ! nFound )
{
iCommand = NUM_COMMANDS ;
pCommand = NULL ;
}
// if (nFound && (! bAllCommands) && (! bCategory))
if ( nFound & & ( ! bAllCommands ) & & bDisplayCategory )
{
char sCategory [ CONSOLE_WIDTH ] ;
int iCmd = g_aCommands [ iCommand ] . iCommand ; // Unaliased command
// HACK: Major kludge to display category!!!
if ( iCmd < = CMD_UNASSEMBLE )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_CPU ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_BOOKMARK_SAVE )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_BOOKMARKS ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_BREAKPOINT_SAVE )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_BREAKPOINTS ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
2017-02-25 22:32:46 +00:00
if ( iCmd < = CMD_CONFIG_SET_DEBUG_DIR )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_CONFIG ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_CURSOR_PAGE_DOWN_4K )
wsprintf ( sCategory , " Scrolling " ) ;
else
if ( iCmd < = CMD_FLAG_SET_N )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_FLAGS ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_MOTD )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_HELP ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_MEMORY_FILL )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_MEMORY ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_OUTPUT_RUN )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_OUTPUT ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_SYNC )
wsprintf ( sCategory , " Source " ) ;
else
if ( iCmd < = CMD_SYMBOLS_LIST )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_SYMBOLS ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_VIEW_DHGR2 )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_VIEW ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_WATCH_SAVE )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_WATCHES ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_WINDOW_OUTPUT )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_WINDOW ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
if ( iCmd < = CMD_ZEROPAGE_POINTER_SAVE )
2015-07-30 15:20:27 +00:00
wsprintf ( sCategory , " %s " , g_aParameters [ PARAM_CAT_ZEROPAGE ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
else
wsprintf ( sCategory , " Unknown! " ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %sCategory%s: %s%s "
2010-06-11 15:38:22 +00:00
, CHC_USAGE
, CHC_DEFAULT
, CHC_CATEGORY
, sCategory ) ;
if ( bCategory )
if ( bDisplayCategory )
bDisplayCategory = false ;
}
if ( pCommand )
{
2021-02-10 21:05:00 +00:00
const char * pHelp = pCommand - > pHelpSummary ;
2010-06-11 15:38:22 +00:00
if ( pHelp )
{
if ( bCategory )
sprintf ( sText , " %s%8s%s, "
, CHC_COMMAND
, pCommand - > m_sName
, CHC_ARG_SEP
) ;
else
sprintf ( sText , " %s%s%s, "
, CHC_COMMAND
, pCommand - > m_sName
, CHC_ARG_SEP
) ;
// if (! TryStringCat( sText, pHelp, g_nConsoleDisplayWidth ))
// {
// if (! TryStringCat( sText, pHelp, CONSOLE_WIDTH-1 ))
// {
strncat ( sText , CHC_DEFAULT , CONSOLE_WIDTH ) ;
strncat ( sText , pHelp , CONSOLE_WIDTH ) ;
// ConsoleBufferPush( sText );
// }
// }
ConsolePrint ( sText ) ;
}
else
{
# if _DEBUG
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " %s <-- Missing " , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
# if DEBUG_COMMAND_HELP
if ( ! bAllCommands ) // Release version doesn't display message
{
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " Missing Summary Help: %s " , g_aCommands [ iCommand ] . aName ) ;
2010-06-11 15:38:22 +00:00
}
# endif
# endif
}
if ( bCategory )
continue ;
}
// MASTER HELP
switch ( iCommand )
{
// CPU / General
case CMD_ASSEMBLE :
2020-10-11 16:14:03 +00:00
ConsoleColorizePrint ( sText , " Usage: [address | symbol] " ) ;
ConsoleBufferPush ( " Enter mini-assembler mode [starting at optional address or symbol]. " ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_UNASSEMBLE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [address | symbol] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Disassembles memory. " ) ;
break ;
2017-02-25 22:32:46 +00:00
case CMD_GO_NORMAL_SPEED :
case CMD_GO_FULL_SPEED :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: address | symbol [Skip,Length] " ) ;
ConsoleColorizePrint ( sText , " Usage: address | symbol [Start:End] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Skip : Start address to skip stepping " ) ;
ConsoleBufferPush ( " Length: Range of bytes past start address to skip stepping " ) ;
ConsoleBufferPush ( " End : Inclusive end address to skip stepping " ) ;
ConsoleBufferPush ( " If the Program Counter is outside the skip range, resumes single-stepping. " ) ;
ConsoleBufferPush ( " Can be used to skip ROM/OS/user code. " ) ;
Help_Examples ( ) ;
2017-02-25 22:32:46 +00:00
ConsolePrintFormat ( sText , " %s G[G] C600 FA00,600 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s G[G] C600 F000:FFFF " , CHC_EXAMPLE ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_JSR :
2018-04-17 14:16:21 +00:00
ConsoleColorizePrint ( sText , " Usage: [symbol | address] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Pushes PC on stack; calls the named subroutine. " ) ;
break ;
case CMD_NOP :
ConsoleBufferPush ( TEXT ( " Puts a NOP opcode at current instruction " ) ) ;
break ;
case CMD_OUT :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [address8 | address16 | symbol] ## [##] " ) ;
2017-02-25 22:32:46 +00:00
ConsoleBufferPush ( TEXT ( " Output a byte or word to the IO address $C0xx " ) ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_PROFILE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: [%s | %s | %s] "
2010-06-11 15:38:22 +00:00
, g_aParameters [ PARAM_RESET ] . m_sName
, g_aParameters [ PARAM_SAVE ] . m_sName
, g_aParameters [ PARAM_LIST ] . m_sName
) ;
ConsoleBufferPush ( " No arguments resets the profile. " ) ;
break ;
// Registers
case CMD_REGISTER_SET :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: <reg> <value | expression | symbol> " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Where <reg> is one of: A X Y PC SP " ) ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " See also: %s%s "
2010-06-11 15:38:22 +00:00
, CHC_CATEGORY
, g_aParameters [ PARAM_CAT_OPERATORS ] . m_sName ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s R PC RESET + 1 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s R PC $FC58 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s R A A1 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s R A $A1 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s R A #A1 " , CHC_EXAMPLE ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_SOURCE :
// ConsoleBufferPush( TEXT(" Reads assembler source file." ) );
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: [ %s | %s ] \" filename \" " , g_aParameters [ PARAM_SRC_MEMORY ] . m_sName , g_aParameters [ PARAM_SRC_SYMBOLS ] . m_sName ) ;
ConsoleBufferPushFormat ( sText , " %s: read source bytes into memory. " , g_aParameters [ PARAM_SRC_MEMORY ] . m_sName ) ;
ConsoleBufferPushFormat ( sText , " %s: read symbols into Source symbol table. " , g_aParameters [ PARAM_SRC_SYMBOLS ] . m_sName ) ;
ConsoleBufferPushFormat ( sText , " Supports: %s. " , g_aParameters [ PARAM_SRC_MERLIN ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_STEP_OUT :
ConsoleBufferPush ( " Steps out of current subroutine " ) ;
ConsoleBufferPush ( " Hotkey: Ctrl-Space " ) ; // TODO: FIXME
break ;
case CMD_STEP_OVER : // Bad name? FIXME/TODO: do we need to rename?
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [#] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Steps, # times, thru current instruction " ) ;
ConsoleBufferPush ( " JSR will be stepped into AND out of. " ) ;
ConsoleBufferPush ( " Hotkey: Ctrl-Space " ) ; // TODO: FIXME
break ;
case CMD_TRACE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [#] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Traces, # times, current instruction(s) " ) ;
ConsoleBufferPush ( " JSR will be stepped into " ) ;
ConsoleBufferPush ( " Hotkey: Shift-Space " ) ;
2016-09-10 12:46:09 +00:00
break ;
2010-06-11 15:38:22 +00:00
case CMD_TRACE_FILE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: \" [filename] \" [v] " ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_TRACE_LINE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [#] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Traces into current instruction " ) ;
ConsoleBufferPush ( " with cycle counting. " ) ;
break ;
// Bookmarks
case CMD_BOOKMARK :
case CMD_BOOKMARK_ADD :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [address | symbol] " ) ;
ConsoleColorizePrint ( sText , " Usage: # <address | symbol> " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " If no address or symbol is specified, lists the current bookmarks. " ) ;
ConsoleBufferPush ( " Updates the specified bookmark (#) " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s RESET " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s 1 HOME " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_BOOKMARK_CLEAR :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [# | *] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Clears specified bookmark, or all. " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s 1 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_BOOKMARK_LIST :
// case CMD_BOOKMARK_LOAD:
case CMD_BOOKMARK_SAVE :
break ;
// Breakpoints
2011-02-21 23:54:09 +00:00
case CMD_BREAK_INVALID :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , TEXT ( " Usage: [%s%s | %s%s] | [ # | # %s%s | # %s%s ] " )
2011-02-21 23:54:09 +00:00
, CHC_COMMAND
, g_aParameters [ PARAM_ON ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_OFF ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_ON ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_OFF ] . m_sName
) ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , TEXT ( " Where: # is 0=BRK, 1=Invalid Opcode_1, 2=Invalid Opcode_2, 3=Invalid Opcode_3 " ) ) ;
2011-02-21 23:54:09 +00:00
break ;
// case CMD_BREAK_OPCODE:
2010-06-11 15:38:22 +00:00
case CMD_BREAKPOINT :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , TEXT ( " Usage: [%s%s | %s%s | %s%s] " )
2010-06-11 15:38:22 +00:00
, CHC_COMMAND
, g_aParameters [ PARAM_LOAD ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_SAVE ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_RESET ] . m_sName ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " Maximum breakpoints: %s%d " , CHC_NUM_DEC , MAX_BREAKPOINTS ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Set breakpoint at PC if no args. " ) ;
ConsoleBufferPush ( " Loading/Saving not yet implemented. " ) ;
break ;
case CMD_BREAKPOINT_ADD_REG :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [A|X|Y|PC|S] [op] <range | value> " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Set breakpoint when reg is [op] value " ) ;
ConsoleBufferPush ( " Default operator is '=' " ) ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " See also: %s%s "
2010-06-11 15:38:22 +00:00
, CHC_CATEGORY
, g_aParameters [ PARAM_CAT_OPERATORS ] . m_sName ) ;
// ConsoleBufferPush( " Examples:" );
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s PC < D000 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s PC = F000:FFFF PC < D000,1000 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s A <= D5 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s A != 01:FF " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s X = A5 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_BREAKPOINT_ADD_SMART :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [address | register] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " If address, sets two breakpoints " ) ;
ConsoleBufferPush ( " 1. one memory access at address " ) ;
ConsoleBufferPush ( " 2. if PC reaches address " ) ;
// "Sets a breakpoint at the current PC or specified address." );
ConsoleBufferPush ( " If an IO address, sets breakpoint on IO access. " ) ;
ConsoleBufferPush ( " If register, sets a breakpoint on memory access at address of register. " ) ;
break ;
case CMD_BREAKPOINT_ADD_PC :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [address] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Sets a breakpoint at the current PC or at the specified address. " ) ;
break ;
case CMD_BREAKPOINT_CLEAR :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [# | *] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Clears specified breakpoint, or all. " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s 1 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_BREAKPOINT_DISABLE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [# [,#] | *] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Disable breakpoint previously set, or all. " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s 1 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_BREAKPOINT_ENABLE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [# [,#] | *] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Re-enables breakpoint previously set, or all. " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s 1 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_BREAKPOINT_LIST :
break ;
2019-10-22 20:31:53 +00:00
case CMD_BREAKPOINT_ADD_MEM :
case CMD_BREAKPOINT_ADD_MEMR :
case CMD_BREAKPOINT_ADD_MEMW :
ConsoleColorizePrint ( sText , " Usage: <range> " ) ;
Help_Range ( ) ;
break ;
2010-06-11 15:38:22 +00:00
// Config - Load / Save
case CMD_CONFIG_LOAD :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [ \" filename \" ] " ) ;
2021-10-18 19:23:46 +00:00
ConsoleBufferPushFormat ( sText , " Load debugger configuration from '%s', or the specificed file. " , g_sFileNameConfig . c_str ( ) ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_CONFIG_SAVE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [ \" filename \" ] " ) ;
2021-10-18 19:23:46 +00:00
ConsoleBufferPushFormat ( sText , " Save debugger configuration to '%s', or the specificed file. " , g_sFileNameConfig . c_str ( ) ) ;
2010-06-11 15:38:22 +00:00
break ;
// Config - Color
case CMD_CONFIG_COLOR :
ConsoleBufferPush ( TEXT ( " Usage: [<#> | <# RR GG BB>] " ) ) ;
ConsoleBufferPush ( TEXT ( " 0 params: switch to 'color' scheme " ) ) ;
ConsoleBufferPush ( TEXT ( " 1 param : dumps R G B for scheme 'color' " ) ) ;
ConsoleBufferPush ( TEXT ( " 4 params: sets R G B for scheme 'color' " ) ) ;
break ;
case CMD_CONFIG_MONOCHROME :
ConsoleBufferPush ( TEXT ( " Usage: [<#> | <# RR GG BB>] " ) ) ;
ConsoleBufferPush ( TEXT ( " 0 params: switch to 'monochrome' scheme " ) ) ;
ConsoleBufferPush ( TEXT ( " 1 param : dumps R G B for scheme 'monochrome' " ) ) ;
ConsoleBufferPush ( TEXT ( " 4 params: sets R G B for scheme 'monochrome' " ) ) ;
break ;
// Config - Diasm
case CMD_CONFIG_DISASM :
{
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Note: All arguments effect the disassembly view " ) ;
2010-06-11 15:38:22 +00:00
2017-08-25 14:36:31 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: [%s%s | %s | %s%s | %s%s | %s%s | %s%s] "
2010-06-11 15:38:22 +00:00
, CHC_COMMAND
, g_aParameters [ PARAM_CONFIG_BRANCH ] . m_sName
, CHC_COMMAND
2017-08-25 14:36:31 +00:00
, g_aParameters [ PARAM_CONFIG_CLICK ] . m_sName
, CHC_COMMAND
2010-06-11 15:38:22 +00:00
, g_aParameters [ PARAM_CONFIG_COLON ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_CONFIG_OPCODE ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_CONFIG_SPACES ] . m_sName
, CHC_COMMAND
, g_aParameters [ PARAM_CONFIG_TARGET ] . m_sName ) ;
ConsoleBufferPush ( " Display current settings if no args. " ) ;
iParam = PARAM_CONFIG_BRANCH ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s [#] " , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Set the type of branch character: " ) ;
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " %d off, %d plain, %d fancy " ,
2010-06-11 15:38:22 +00:00
DISASM_BRANCH_OFF , DISASM_BRANCH_PLAIN , DISASM_BRANCH_FANCY ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " i.e. %s%s %s 1 " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
2017-08-25 14:36:31 +00:00
iParam = PARAM_CONFIG_CLICK ;
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s [#] " , g_aParameters [ iParam ] . m_sName ) ;
ConsoleBufferPush ( " Set required key combo. (Alt, Control, or Shift) when left clicking " ) ;
ConsoleBufferPushFormat ( sText , " 0 Left-Click (no Alt, Ctrl, Shift) " ) ;
ConsoleBufferPushFormat ( sText , " 1 Alt Left-click " ) ;
ConsoleBufferPushFormat ( sText , " 2 Ctrl Left-click " ) ;
ConsoleBufferPushFormat ( sText , " 3 Alt+Ctrl Left-click " ) ;
ConsoleBufferPushFormat ( sText , " 4 Shift Left-click " ) ;
ConsoleBufferPushFormat ( sText , " 5 Shift+Alt Left-click " ) ;
ConsoleBufferPushFormat ( sText , " 6 Shift+Ctrl Left-click " ) ;
ConsoleBufferPushFormat ( sText , " 7 Shift+Ctrl+Alt Left-click " ) ;
Help_Examples ( ) ;
ConsolePrintFormat ( sText , " %s%s %s 0 // Plain Left-click " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
ConsolePrintFormat ( sText , " %s%s %s 1 // Require Alt Left-click " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
ConsolePrintFormat ( sText , " %s%s %s 2 // Require Ctrl Left-click " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
ConsolePrintFormat ( sText , " %s%s %s 3 // Require Alt+Ctrl Left-click " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
iParam = PARAM_CONFIG_COLON ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s [0|1] " , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Display a colon after the address " ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " i.e. %s%s %s 0 " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
iParam = PARAM_CONFIG_OPCODE ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s [0|1] " , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Display opcode(s) after colon " ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " i.e. %s%s %s 1 " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
iParam = PARAM_CONFIG_SPACES ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s [0|1] " , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Display spaces between opcodes " ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " i.e. %s%s %s 0 " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
iParam = PARAM_CONFIG_TARGET ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s [#] " , g_aParameters [ iParam ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Set the type of target address/value displayed: " ) ;
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " %d off, %d value only, %d address only, %d both " ,
2010-06-11 15:38:22 +00:00
DISASM_TARGET_OFF , DISASM_TARGET_VAL , DISASM_TARGET_ADDR , DISASM_TARGET_BOTH ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " i.e. %s%s %s %d " , CHC_EXAMPLE , pCommand - > m_sName , g_aParameters [ iParam ] . m_sName , DISASM_TARGET_VAL ) ;
2010-06-11 15:38:22 +00:00
break ;
}
// Config - Font
case CMD_CONFIG_FONT :
2016-09-10 12:46:09 +00:00
ConsolePrint ( " No longer applicable with new debugger font " ) ;
2010-06-11 15:38:22 +00:00
/*
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , TEXT ( " Usage: [%s | %s] \" FontName \" [Height] " ) ,
2010-06-11 15:38:22 +00:00
g_aParameters [ PARAM_FONT_MODE ] . m_sName , g_aParameters [ PARAM_DISASM ] . m_sName ) ;
ConsoleBufferPush ( TEXT ( " i.e. FONT \" Courier \" 12 " ) ) ;
ConsoleBufferPush ( TEXT ( " i.e. FONT \" Lucida Console \" 12 " ) ) ;
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , TEXT ( " %s Controls line spacing. " ) , g_aParameters [ PARAM_FONT_MODE ] . m_sName ) ;
ConsoleBufferPushFormat ( sText , TEXT ( " Valid values are: %d, %d, %d. " ) ,
2010-06-11 15:38:22 +00:00
FONT_SPACING_CLASSIC , FONT_SPACING_CLEAN , FONT_SPACING_COMPRESSED ) ;
*/
break ;
2014-08-28 18:13:02 +00:00
// Disasm
case CMD_DEFINE_DATA_BYTE1 :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s <address> | <symbol address> | <symbol range> " , pCommand - > m_sName ) ;
2014-08-28 18:13:02 +00:00
ConsoleBufferPush ( TEXT ( " Tell the diassembler to treat the BYTES as data instead of code. " ) ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s WNDTOP 22 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s WNDBTM 23 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s WNDTOP // treat as code again " , CHC_EXAMPLE , g_aCommands [ CMD_DISASM_CODE ] . m_sName ) ;
ConsolePrintFormat ( sText , " %s %s // list all addresses viewed as data " , CHC_EXAMPLE , g_aCommands [ CMD_DISASM_LIST ] . m_sName ) ;
2014-08-28 18:13:02 +00:00
break ;
case CMD_DEFINE_DATA_WORD1 :
// DW // use current debug line
// DW symbol
// DW symbol address
// DW symbol range:range
// DW address
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Usage: %s <address> | <symbol address> | <symbol range> " , pCommand - > m_sName ) ;
2014-08-28 18:13:02 +00:00
ConsoleBufferPush ( TEXT ( " Tell the diassembler to treat the WORDS as data instead of code. " ) ) ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " The data is a range of 2-byte pointer data. " ) ;
2014-08-28 18:13:02 +00:00
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s NEXT1 801 // AppleSoft Basic Line#1 Pointer to Next line " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s LINE1 803 // Applesoft Basic Line#1 Line Number " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s NEXT1 // treat as code again " , CHC_EXAMPLE , g_aCommands [ CMD_DISASM_CODE ] . m_sName ) ;
ConsolePrintFormat ( sText , " %s %s // list all addresses viewed as data " , CHC_EXAMPLE , g_aCommands [ CMD_DISASM_LIST ] . m_sName ) ;
2014-08-28 18:13:02 +00:00
break ;
2010-06-11 15:38:22 +00:00
// Memory
case CMD_MEMORY_ENTER_BYTE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: <address | symbol> ## [## ... ##] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( TEXT ( " Sets memory to the specified 8-Bit Values (bytes) " ) ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s 00 4C FF69 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s 00:4C FF69 " , CHC_EXAMPLE ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_MEMORY_ENTER_WORD :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: <address | symbol> #### [#### ... ####] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( TEXT ( " Sets memory to the specified 16-Bit Values (words) " ) ) ;
break ;
case CMD_MEMORY_FILL :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: <address | symbol> <address | symbol> ## " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( TEXT ( " Fills the memory range with the specified byte " ) ) ;
2016-09-10 12:46:09 +00:00
ConsoleColorizePrintFormat ( sTemp , sText , " Note: Can't fill IO addresses %s$%sC0xx " , CHC_ARG_SEP , CHC_ADDRESS ) ;
2010-06-11 15:38:22 +00:00
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s 2000:3FFF 00 // Clear HGR page 1 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s 4000,2000 00 // Clear HGR page 2 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s 2000 3FFF 00 // Clear HGR page 1 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_MEMORY_MOVE :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: destination range " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( TEXT ( " Copies bytes specified by the range to the destination starting address. " ) ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s 4000 2000:3FFF // move HGR page 1 to page 2 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s 2001 2000:3FFF // clear $2000-$3FFF with the byte at $2000 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s 2001<2000:3FFFM " , CHC_EXAMPLE ) ;
2010-06-11 15:38:22 +00:00
break ;
// case CMD_MEM_MINI_DUMP_ASC_1:
// case CMD_MEM_MINI_DUMP_ASC_2:
case CMD_MEM_MINI_DUMP_ASCII_1 :
case CMD_MEM_MINI_DUMP_ASCII_2 :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: <address | symbol> " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( TEXT ( " Displays ASCII text in the Mini-Memory area " ) ) ;
ConsoleBufferPush ( TEXT ( " ASCII control chars are hilighted " ) ) ;
ConsoleBufferPush ( TEXT ( " ASCII hi-bit chars are normal " ) ) ;
// break;
// case CMD_MEM_MINI_DUMP_TXT_LO_1:
// case CMD_MEM_MINI_DUMP_TXT_LO_2:
case CMD_MEM_MINI_DUMP_APPLE_1 :
case CMD_MEM_MINI_DUMP_APPLE_2 :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: <address | symbol> " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Displays APPLE text in the Mini-Memory area " ) ;
ConsoleBufferPush ( " APPLE control chars are inverse " ) ;
ConsoleBufferPush ( " APPLE hi-bit chars are normal " ) ;
break ;
// case CMD_MEM_MINI_DUMP_TXT_HI_1:
// case CMD_MEM_MINI_DUMP_TXT_HI_2:
// ConsoleBufferPush( TEXT(" Usage: <address | symbol>") );
// ConsoleBufferPush( TEXT(" Displays text in the Memory Mini-Dump area") );
// ConsoleBufferPush( TEXT(" ASCII chars with the hi-bit set, is inverse") );
break ;
case CMD_MEMORY_LOAD :
case CMD_MEMORY_SAVE :
if ( iCommand = = CMD_MEMORY_LOAD )
{
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: [ \" Filename \" ],[bank:]address[,length] " ) ;
ConsoleColorizePrint ( sTemp , " Usage: [ \" Filename \" ],[bank:]range " ) ;
2010-06-11 15:38:22 +00:00
Help_Range ( ) ;
ConsoleBufferPush ( " Notes: If no filename specified, defaults to the last filename (if possible) " ) ;
}
if ( iCommand = = CMD_MEMORY_SAVE )
{
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sTemp , " Usage: [ \" Filename \" ],[bank:]address,length " ) ;
ConsoleColorizePrint ( sTemp , " Usage: [ \" Filename \" ],[bank:]range " ) ;
2010-06-11 15:38:22 +00:00
Help_Range ( ) ;
2013-09-14 21:46:39 +00:00
ConsoleBufferPush ( " Notes: If no filename specified, defaults to: '####.####.[bank##].bin' " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Where the form is <address>.<length>.bin " ) ;
}
// ConsoleBufferPush( TEXT(" Examples:" ) );
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s BSAVE \" test \" ,FF00,100 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s BLOAD \" test \" ,2000:2010 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s BSAVE \" test \" ,F000:FFFF " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s BLOAD \" test \" ,4000 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s BLOAD \" main.bin \" ,0:2000 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s BSAVE \" aux2.bin \" ,1:2000 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s BSAVE \" main.bin \" ,0:2000,2000 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s BSAVE \" aux2.bin \" ,1:2000:3FFF " , CHC_EXAMPLE ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_MEMORY_SEARCH :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: range < \" ASCII text \" | 'apple text' | hex> " ) ;
2010-06-11 15:38:22 +00:00
Help_Range ( ) ;
ConsoleBufferPush ( " Where text is of the form: " ) ;
ConsoleBufferPush ( " \" ... \" designate ASCII text " ) ;
ConsoleBufferPush ( " '...' designate Apple High-Bit text " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s F000,1000 'Apple' // search High-Bit " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s MT1 @2 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s %s D000:FFFF \" FLAS \" // search ASCII " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s MA1 @1 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s %s D000,4000 \" EN \" 'D' // Mixed text " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s MT1 @1 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s %s D000,4000 'Apple' ? ']' " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_MEMORY_SEARCH_HEX :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: range [text | byte1 [byte2 ...]] " ) ;
2010-06-11 15:38:22 +00:00
Help_Range ( ) ;
ConsoleBufferPush ( " Where <byte> is of the form: " ) ;
ConsoleBufferPush ( " ## match specific byte " ) ;
ConsoleBufferPush ( " #### match specific 16-bit value " ) ;
ConsoleBufferPush ( " ? match any byte " ) ;
ConsoleBufferPush ( " ?# match any high nibble, match low nibble to specific number " ) ;
ConsoleBufferPush ( " #? match specific high nibble, match any low nibble " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s F000,1000 AD ? C0 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s U @1 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s %s F000,1000 ?1 C0 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s F000,1000 5? C0 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s F000,1000 10 C? " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s U @2 - 1 " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s %s F000:FFFF C030 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s U @1 - 1 " , CHC_EXAMPLE ) ;
2010-06-11 15:38:22 +00:00
break ;
// case CMD_MEMORY_SEARCH_APPLE:
2016-09-10 12:46:09 +00:00
// ConsoleBufferPushFormat( sText, TEXT("Deprecated. Use: %s" ), g_aCommands[ CMD_MEMORY_SEARCH ].m_sName );
2010-06-11 15:38:22 +00:00
// break;
// case CMD_MEMORY_SEARCH_ASCII:
2016-09-10 12:46:09 +00:00
// ConsoleBufferPushFormat( sText, TEXT("Deprecated. Use: %s" ), g_aCommands[ CMD_MEMORY_SEARCH ].m_sName );
2010-06-11 15:38:22 +00:00
// break;
// Output
case CMD_OUTPUT_CALC :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: <address | symbol | expression > " ) ;
2018-04-17 16:33:56 +00:00
ConsoleBufferPush ( " Operator is one of: + - * / % ^ ~ " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Output order is: Hex Bin Dec Char " ) ;
2018-04-17 16:30:59 +00:00
ConsoleBufferPush ( " Note: symbols take priority. " ) ;
2018-04-17 16:32:11 +00:00
ConsoleBufferPush ( " Note: #A (if you don't want the accumulator value) " ) ;
ConsoleBufferPush ( " Note: #F (if you don't want the flags value) " ) ;
2010-06-11 15:38:22 +00:00
Help_Examples ( ) ;
2018-04-17 16:32:58 +00:00
ConsolePrintFormat ( sText , " %s CALC 5 + #A " , CHC_EXAMPLE ) ;
ConsolePrintFormat ( sText , " %s CALC 80 * 2 " , CHC_EXAMPLE ) ;
2018-04-17 16:43:06 +00:00
ConsoleColorizePrint ( sText , " See also: " CHC_COMMAND " HELP OP " ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_OUTPUT_ECHO :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: string " ) ;
2010-06-11 15:38:22 +00:00
// ConsoleBufferPush( TEXT(" Examples:" ) );
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s Checkpoint " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s PC " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
// ConsoleBufferPush( TEXT(" Echo the string to the console" ) );
break ;
case CMD_OUTPUT_PRINT :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: <string | expression> [, string | expression]* " ) ;
ConsoleColorizePrint ( sText , " Note: To print Register values, they must be in upper case " ) ;
2010-06-11 15:38:22 +00:00
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s \" A: \" ,A, \" X: \" ,X " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s A, \" \" ,X, \" \" ,Y " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s PC " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_OUTPUT_PRINTF :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: <string> [, expression, ...] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " The string may contain c-style printf formatting flags: %d %x %z %c " ) ;
ConsoleBufferPush ( " Where: %d decimal, %x hex, %z binary, %c char, %% percent " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s \" Dec: %%d Hex: %%x Bin: %%z Char: %%c \" ,A,A,A,A " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s \" %%x %%x %%x \" ,A,X,Y " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
// Symbols
case CMD_SYMBOLS_LOOKUP :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: symbol [= <address>] " ) ;
2017-08-24 19:36:46 +00:00
ConsolePrintFormat ( sText , " %s \" %ssymbol%s \" = %saddress "
, CHC_ARG_MAND
, CHC_SYMBOL
, CHC_ARG_MAND
, CHC_ADDRESS
) ;
ConsoleColorizePrint ( sText , " Note: Valid characters are any characters above ASCII space ($20). " ) ;
ConsolePrintFormat ( sText , " You %sMUST%s double-quote names containing special characters to be recognized. "
, CHC_WARNING
, CHC_DEFAULT
) ;
2010-06-11 15:38:22 +00:00
Help_Examples ( ) ;
2017-08-24 19:36:46 +00:00
ConsolePrintFormat ( sText , " %s %s HOME " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s LIFE = 2000 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s LIFE " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s \" PR# \" = FE95 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s \" PR# \" " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_SYMBOLS_ROM :
case CMD_SYMBOLS_APPLESOFT :
case CMD_SYMBOLS_ASSEMBLY :
case CMD_SYMBOLS_USER_1 :
case CMD_SYMBOLS_USER_2 :
case CMD_SYMBOLS_SRC_1 :
case CMD_SYMBOLS_SRC_2 :
// ConsoleBufferPush( TEXT(" Usage: [ ON | OFF | symbol | address ]" ) );
// ConsoleBufferPush( TEXT(" Usage: [ LOAD [\"filename\"] | SAVE \"filename\"]" ) );
// ConsoleBufferPush( TEXT(" ON : Turns symbols on in the disasm window" ) );
// ConsoleBufferPush( TEXT(" OFF : Turns symbols off in the disasm window" ) );
// ConsoleBufferPush( TEXT(" LOAD: Loads symbols from last/default filename" ) );
// ConsoleBufferPush( TEXT(" SAVE: Saves symbol table to file" ) );
// ConsoleBufferPush( TEXT(" CLEAR: Clears the symbol table" ) );
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [ <cmd> | symbol | address ] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Where <cmd> is one of: " ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s%-5s%s: Turns symbols on in the disasm window " , CHC_STRING , g_aParameters [ PARAM_ON ] . m_sName , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s%-5s%s: Turns symbols off in the disasm window " , CHC_STRING , g_aParameters [ PARAM_OFF ] . m_sName , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s%-5s%s: Loads symbols from last/default \" filename \" " , CHC_STRING , g_aParameters [ PARAM_LOAD ] . m_sName , CHC_DEFAULT ) ; // 2.6.2.14 Fixed: Save/Load Param help was swapped.
ConsolePrintFormat ( sText , " %s%-5s%s: Saves symbol table to \" filename \" " , CHC_STRING , g_aParameters [ PARAM_SAVE ] . m_sName , CHC_DEFAULT ) ; // 2.6.2.14 Fixed: Save/Load Param help was swapped.
ConsolePrintFormat ( sText , " %s%-5s%s: Clears the symbol table " , CHC_STRING , g_aParameters [ PARAM_CLEAR ] . m_sName , CHC_DEFAULT ) ;
ConsolePrintFormat ( sText , " %s%-5s%s: Remove symbol " , CHC_STRING , g_aTokens [ TOKEN_EXCLAMATION ] . sToken , CHC_DEFAULT ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_SYMBOLS_LIST :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: symbol " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Looks up symbol in all 3 symbol tables: main, user, source " ) ;
break ;
2020-01-11 17:38:00 +00:00
// Cycles
case CMD_CYCLES_INFO :
2020-05-23 17:40:12 +00:00
ConsoleColorizePrint ( sText , " Usage: <abs|rel|part> " ) ;
2020-01-11 17:38:00 +00:00
ConsoleBufferPush ( " Where: " ) ;
2020-05-23 17:40:12 +00:00
ConsoleBufferPush ( " abs = absolute number of cycles since power-on " ) ;
ConsoleBufferPush ( " rel = number of cycles since last step or breakpoint " ) ;
ConsoleBufferPush ( " part= number of cycles relative to current instruction " ) ;
break ;
case CMD_CYCLES_RESET :
ConsoleBufferPush ( " Use in conjunctioned with 'cycles part' to reset to current instruction " ) ;
2020-01-11 17:38:00 +00:00
break ;
2019-09-22 15:53:38 +00:00
// Video-Scanner
2020-05-23 17:40:12 +00:00
2019-09-22 15:53:38 +00:00
case CMD_VIDEO_SCANNER_INFO :
2020-01-11 17:38:00 +00:00
ConsoleColorizePrint ( sText , " Usage: <dec|hex|real|apple> " ) ;
2019-09-22 15:53:38 +00:00
ConsoleBufferPush ( " Where: " ) ;
ConsoleBufferPush ( " <dec|hex> changes output to dec/hex " ) ;
ConsoleBufferPush ( " <real|apple> alters horz value to hbl-l,visible,hbl-r or hbl-r+l,visible " ) ;
{
2019-09-23 00:50:18 +00:00
char sText2 [ CONSOLE_WIDTH ] ;
2019-11-03 09:36:33 +00:00
ConsolePrintFormat ( sText2 , " %sYellow%s=invisible (hbl or vbl active) / %sGreen%s=visible "
, CHC_INFO , CHC_DEFAULT // yellow
2019-09-22 15:53:38 +00:00
, CHC_COMMAND , CHC_DEFAULT // green
) ;
}
break ;
// View
2010-06-11 15:38:22 +00:00
case CMD_VIEW_TEXT4X :
case CMD_VIEW_TEXT41 :
case CMD_VIEW_TEXT42 :
case CMD_VIEW_TEXT8X :
case CMD_VIEW_TEXT81 :
case CMD_VIEW_TEXT82 :
case CMD_VIEW_GRX :
case CMD_VIEW_GR1 :
case CMD_VIEW_GR2 :
case CMD_VIEW_DGRX :
case CMD_VIEW_DGR1 :
case CMD_VIEW_DGR2 :
case CMD_VIEW_HGRX :
case CMD_VIEW_HGR1 :
case CMD_VIEW_HGR2 :
case CMD_VIEW_DHGRX :
case CMD_VIEW_DHGR1 :
case CMD_VIEW_DHGR2 :
2016-09-10 12:46:09 +00:00
ConsolePrint ( " Show the video output in the specified format. " ) ;
2010-06-11 15:38:22 +00:00
break ;
// Watches
case CMD_WATCH_ADD :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: <address | symbol> " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Adds the specified memory location to the watch window. " ) ;
break ;
// Window
case CMD_WINDOW_CODE : // summary is good enough
case CMD_WINDOW_CODE_2 : // summary is good enough
case CMD_WINDOW_SOURCE_2 : // summary is good enough
break ;
// Zero Page pointers
case CMD_ZEROPAGE_POINTER :
case CMD_ZEROPAGE_POINTER_ADD :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: <address | symbol> " ) ;
ConsoleColorizePrint ( sText , " Usage: # <address | symbol> [address...] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Adds the specified memory location to the zero page pointer window. " ) ;
ConsoleBufferPush ( " Update the specified zero page pointer (#) with the address. " ) ;
ConsoleBufferPush ( " Note: Displayed as symbol name (if possible) and the 16-bit target pointer " ) ;
Help_Examples ( ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " %s %s CH " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s 0 CV " , CHC_EXAMPLE , pCommand - > m_sName ) ;
ConsolePrintFormat ( sText , " %s %s 0 CV CH " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_ZEROPAGE_POINTER_CLEAR :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [# | *] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " Clears specified zero page pointer, or all. " ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " i.e. %s%s 1 " , CHC_EXAMPLE , pCommand - > m_sName ) ;
2010-06-11 15:38:22 +00:00
break ;
case CMD_ZEROPAGE_POINTER_0 :
case CMD_ZEROPAGE_POINTER_1 :
case CMD_ZEROPAGE_POINTER_2 :
case CMD_ZEROPAGE_POINTER_3 :
case CMD_ZEROPAGE_POINTER_4 :
case CMD_ZEROPAGE_POINTER_5 :
case CMD_ZEROPAGE_POINTER_6 :
case CMD_ZEROPAGE_POINTER_7 :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [<address | symbol>] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " If no address specified, will remove watching the zero page pointer. " ) ;
break ;
// Misc
case CMD_VERSION :
2016-09-10 12:46:09 +00:00
ConsoleColorizePrint ( sText , " Usage: [*] " ) ;
2010-06-11 15:38:22 +00:00
ConsoleBufferPush ( " * Display extra internal stats " ) ;
break ;
default :
if ( bAllCommands )
break ;
if ( ( ! nFound ) | | ( ! pCommand ) )
{
2016-09-10 12:46:09 +00:00
ConsoleBufferPush ( " Invalid command. " ) ;
2010-06-11 15:38:22 +00:00
}
else
{
//#if DEBUG_COMMAND_HELP
# if _DEBUG
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " Command help not done yet!: %s " , g_aCommands [ iCommand ] . m_sName ) ;
2010-06-11 15:38:22 +00:00
# endif
}
break ;
}
}
return ConsoleUpdate ( ) ;
}
//===========================================================================
Update_t CmdHelpList ( int nArgs )
{
const int nBuf = CONSOLE_WIDTH * 2 ;
char sText [ nBuf ] = " " ;
int nMaxWidth = g_nConsoleDisplayWidth - 1 ;
int iCommand ;
2014-08-14 19:29:01 +00:00
extern std : : vector < Command_t > g_vSortedCommands ;
2010-06-11 15:38:22 +00:00
if ( ! g_vSortedCommands . size ( ) )
{
for ( iCommand = 0 ; iCommand < NUM_COMMANDS_WITH_ALIASES ; iCommand + + )
{
g_vSortedCommands . push_back ( g_aCommands [ iCommand ] ) ;
}
std : : sort ( g_vSortedCommands . begin ( ) , g_vSortedCommands . end ( ) , commands_functor_compare ( ) ) ;
}
int nLen = 0 ;
// Colorize( sText, "Commands: " );
StringCat ( sText , CHC_USAGE , nBuf ) ;
nLen + = StringCat ( sText , " Commands " , nBuf ) ;
StringCat ( sText , CHC_DEFAULT , nBuf ) ;
nLen + = StringCat ( sText , " : " , nBuf ) ;
for ( iCommand = 0 ; iCommand < NUM_COMMANDS_WITH_ALIASES ; iCommand + + ) // aliases are not printed
{
Command_t * pCommand = & g_vSortedCommands . at ( iCommand ) ;
// Command_t *pCommand = & g_aCommands[ iCommand ];
char * pName = pCommand - > m_sName ;
if ( ! pCommand - > pFunction )
continue ; // not implemented function
int nLenCmd = strlen ( pName ) ;
if ( ( nLen + nLenCmd ) < ( nMaxWidth ) )
{
StringCat ( sText , CHC_COMMAND , nBuf ) ;
nLen + = StringCat ( sText , pName , nBuf ) ;
}
else
{
ConsolePrint ( sText ) ;
nLen = 1 ;
strcpy ( sText , " " ) ;
StringCat ( sText , CHC_COMMAND , nBuf ) ;
nLen + = StringCat ( sText , pName , nBuf ) ;
}
strcat ( sText , " " ) ;
nLen + + ;
}
//ConsoleBufferPush( sText );
ConsolePrint ( sText ) ;
ConsoleUpdate ( ) ;
return UPDATE_CONSOLE_DISPLAY ;
}
//===========================================================================
Update_t CmdVersion ( int nArgs )
{
TCHAR sText [ CONSOLE_WIDTH ] ;
unsigned int nVersion = DEBUGGER_VERSION ;
int nMajor ;
int nMinor ;
int nFixMajor ;
int nFixMinor ;
UnpackVersion ( nVersion , nMajor , nMinor , nFixMajor , nFixMinor ) ;
2016-09-10 12:46:09 +00:00
ConsolePrintFormat ( sText , " Emulator: %s%s%s Debugger: %s%d.%d.%d.%d%s "
2010-06-11 15:38:22 +00:00
, CHC_SYMBOL
, VERSIONSTRING
, CHC_DEFAULT
, CHC_SYMBOL
, nMajor , nMinor , nFixMajor , nFixMinor
, CHC_DEFAULT
) ;
if ( nArgs )
{
for ( int iArg = 1 ; iArg < = g_nArgRaw ; iArg + + )
{
// * PARAM_WILDSTAR -> ? PARAM_MEM_SEARCH_WILD
if ( ( ! _tcscmp ( g_aArgs [ iArg ] . sArg , g_aParameters [ PARAM_WILDSTAR ] . m_sName ) ) | |
( ! _tcscmp ( g_aArgs [ iArg ] . sArg , g_aParameters [ PARAM_MEM_SEARCH_WILD ] . m_sName ) ) )
{
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " Arg: %d bytes * %d = %d bytes " ,
2010-06-11 15:38:22 +00:00
sizeof ( Arg_t ) , MAX_ARGS , sizeof ( g_aArgs ) ) ;
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " Console: %d bytes * %d height = %d bytes " ,
2010-06-11 15:38:22 +00:00
sizeof ( g_aConsoleDisplay [ 0 ] ) , CONSOLE_HEIGHT , sizeof ( g_aConsoleDisplay ) ) ;
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " Commands: %d (Aliased: %d) Params: %d " ,
2010-06-11 15:38:22 +00:00
NUM_COMMANDS , NUM_COMMANDS_WITH_ALIASES , NUM_PARAMS ) ;
2016-09-10 12:46:09 +00:00
ConsoleBufferPushFormat ( sText , " Cursor(%d) T: %04X C: %04X B: %04X %c D: %02X " , // Top, Cur, Bot, Delta
2010-06-11 15:38:22 +00:00
g_nDisasmCurLine , g_nDisasmTopAddress , g_nDisasmCurAddress , g_nDisasmBotAddress ,
g_bDisasmCurBad ? TEXT ( ' * ' ) : TEXT ( ' ' )
, g_nDisasmBotAddress - g_nDisasmTopAddress
) ;
CmdConfigGetFont ( 0 ) ;
break ;
}
else
return Help_Arg_1 ( CMD_VERSION ) ;
}
}
return ConsoleUpdate ( ) ;
}