From d07558b610bcd4c1e092daf70777ba5008b118fb Mon Sep 17 00:00:00 2001 From: tomcw Date: Fri, 31 Jan 2020 20:16:01 +0000 Subject: [PATCH] Updated compiler.txt with F12 info; & removed old cvs/svn docs --- docs/compiling.txt | 23 +++++++ docs/cvs_setup.txt | 165 --------------------------------------------- docs/svn_setup.txt | 28 -------- 3 files changed, 23 insertions(+), 193 deletions(-) delete mode 100644 docs/cvs_setup.txt delete mode 100644 docs/svn_setup.txt diff --git a/docs/compiling.txt b/docs/compiling.txt index ed4bf3cf..fa90a88a 100644 --- a/docs/compiling.txt +++ b/docs/compiling.txt @@ -98,3 +98,26 @@ N/A 5. Clean & build: devenv AppleWinExpress2008.sln /clean cov-build --dir cov-int devenv AppleWinExpress2008.sln /build release + + + + +How to disable F12 so it doesn't trigger a breakpoint +===================================================== + +When running AppleWin from Visual Studio (eg. F5), then F12 will trigger a breakpoint. + +This is undesirable, since F12 is used to load a save-state. + +AppleWin doesn't support CTRL+F12 to load a save-state too (for this very reason), but it's possible to disable F12 triggering the breakpoint. + +Background: +F12 is the OS's default UserDebuggerHotKey: +https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2003/cc786263(v=ws.10) + +Fix: +. Change this Registry key: "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug" to 0x07 (*) +. And restart the PC for it to take effect. + +(*) Where 0x07 = Undefined +(See: https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes) \ No newline at end of file diff --git a/docs/cvs_setup.txt b/docs/cvs_setup.txt deleted file mode 100644 index afaa9854..00000000 --- a/docs/cvs_setup.txt +++ /dev/null @@ -1,165 +0,0 @@ -Setting up CVS for AppleWin -Revision 3 -+ Added pass-phrase, pageant, putty info -Revision 2 -+ Added diff/merge - - -This is the step-by-step tutorial in getting CVS setup for AppleWin. -There are a few steps, but each one is quick and easy to do. - - -1. Create an account BerliOS -http://developer.berlios.de/ - - -2. Download and install TortoiseCVS. -a) http://www.tortoisecvs.org/ -b) Reboot Windows (Grr...) - -You can find a tutorial on how to use TortoiseCVS here: -http://cedric.babault.free.fr/TortoiseCVSDoc/UserGuide_en.html - -If you don't want to use TortoiseCVs, you have a few options: - -i) WinCVS (which also has a Mac OS X port, called MacCVS) -http://www.wincvs.org/ - -ii) cvsnt: -http://www.march-hare.com/cvspro/ - - -3. Generate a SSH2 key, using "puttygen" -Recommend: using a pass-phrase -Recommend: using comment: - @shell.berlios.de - -If you installed TortoiseCVS, you will notice it includes an older version of puttygen.exe: -i.e. - \Program Files\TortoiseCVS\puttygen.exe - \Programs\VersionControl\TortoiseCVS\puttygen.exe - -You can find the latest PuTTY here: -http://www.chiark.greenend.org.uk/~sgtatham/putty/ - -And depending on where you installed it to: - C:\Program Files\Putty\puttgygen.exe - P:\Programs\Util\Shell\PuTTY\puttygen.exe - -4. In your home directory, make a sub-directory called: .ssh -i.e. - C:\Document and Settings\\.ssh - \users\\.ssh - - -5. Save your public key into your home directory -i.e. - \.ssh\identity.pub - - -6. Save your private key into your home directory -i.e. - \.ssh\identity - - -7. Upload your Public SSH key to BerliOS -a) http://developer.berlios.de/ -b) Account Options -c) Edit Keys (at bottom of webpage) -d) copy from puttygen, and paste into web form -e) Verify: CVS/SVN/SSH Shared Keys: 1 <-- was zero - -You will have to use your pass-phrase (may be up to a few hours), -until BerliOS recognizes the uploaded ssh2 key. - - -8. Using Windows Explorer, navigate to the parent directory where you will download AppleWin -i.e. - \Projects\ - P:\\Projects\ - - -9. (Optional) Specify a home folder. - -If you have TortoiseCVS installed: -a) right Click on any directory -b) select CVS -c) Preferences. - TortoiseCVS should appear. -d) Select "Advanced" Tab -e) Home Folder: uncheck, always recalculate home folder -f) Enter your home directory, for "Custom Home folder" - - -10. (Optional) Set CVS environment variable: CVS_RSH -If you are using TortoiseCVS you can skip this step. -(TortoiseCVS uses 'plink' -- command line wrapper for ssh.) - -For other cvs clients, you may need to set CVS_RSH: -To set the environment variable "CVS_RSH" to "ssh" (without the quotes): -Right-click the My Computer icon on your desktop, Properties, Advanced, Environment variables button. - - -11. Setting CVSROOT. -If you use TortoiseCVS -a) right click on the AppleWin Parent directory (the folder where AppleWin will be downloaded to) -b) CVS Checkout, -and set CVSROOT to: - :ext:@cvs.applewin.berlios.de:/cvsroot/applewin - -c) set Module (case sensitive!) to: - AppleWin -d) select OK, and wait to fetch the complete AppleWin directory. - -Troubleshooting: -* You can delete "Previous CVSROOTs": - Right click on folder, CVS, Checkout, select appropiate, delete key - You will have to press OK for the old entries to be deleted. - When you do, a fetch attempt will also be made. -* If you enter the wrong init param, you may have to rename / delete your local AppleWin folder! -* If you still have problems, you may have to remove the SSH (host) entry from the registry: - i.e. - HKEY_CURRENT_USER\Software\SimonTatham\Putty\SshHostKeys - -* You shouldn't have to edit, but if you need to, this CVS config file is plain text: - AppleWin\CVS\Root - -If you use another cvs client, such as WinCVS, or CVSNT, this may work: - :ssh:@cvs.applewin.berlios.de:/cvsroot/applewin - - -12. You can download a free source-code 'diff' & 'merge' app for win32 -(which integrates into TortoiseCVS) from here: -http://winmerge.sourceforge.net/ - -Alternatively you can download a free source-code 'diff' for Win32 here: -http://www.prestosoft.com/ps.asp?page=edp_examdiff - - -13. Start hacking the code! - - -14. Automatically use your SSH2 key, instead of manually typing your pass-phrase. -If you generated a SSH2 private/public key, and have uploaded it to BerliOS, -you can tell TortoiseCVS to use your SSH2 key-pair instead of asking for your pass-phrase on every CVS action. - -If you have PuTTY (pageant) installed: -a) Run pageant - C:\Program Files\PuTTY\pageant.exe - -If you get a configuration error when starting pageant.exe on Win XP, this provides a workaround: -http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist/xp-wont-run - -b) Right Click on pageant in the system tool bar -c) Add key -d) Select your private key - \.ssh\identity.ppk - -If you have TortoiseCVS installed: -a) right Click on any directory -b) select CVS -c) Preferences. - TortoiseCVS should appear. -d) Select "Tools" Tab -e) To the SSH paramaters, add: -2 - diff --git a/docs/svn_setup.txt b/docs/svn_setup.txt deleted file mode 100644 index 35570d2f..00000000 --- a/docs/svn_setup.txt +++ /dev/null @@ -1,28 +0,0 @@ -Setting up SVN for AppleWin -=========================== - -(This doc assumes you started with cvs_setup.txt) - - -1. Download and install TortoiseSVN. -a) http://tortoisesvn.sourceforge.net/ -b) Reboot Windows (Grr...) - -========== - -Start by reading the TortoiseSVN help... or just dive right in :) - - -To browse the svn repository using: -a) Web browser (WebSVN) : http://svn.berlios.de/wsvn/applewin -b) Windows Explorer: TortoiseSVN -> Repro-browser - - -Use 'SVN Checkout...' off the right-context menu in a Windows folder. - -URL of repository: -http://svn.berlios.de/svnroot/repos/applewin/trunk -(to get trunk) - -http://svn.berlios.de/svnroot/repos/applewin -(to get everything! Or use [...] to browse for your specific branch) \ No newline at end of file