Updated compiler.txt with F12 info; & removed old cvs/svn docs

This commit is contained in:
tomcw 2020-01-31 20:16:01 +00:00
parent 41efaad92f
commit d07558b610
3 changed files with 23 additions and 193 deletions

View File

@ -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)

View File

@ -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:
<username>@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\<username>\.ssh
\users\<username>\.ssh
5. Save your public key into your home directory
i.e.
<username>\.ssh\identity.pub
6. Save your private key into your home directory
i.e.
<username>\.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.
<username>\Projects\
P:\<username>\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:<username>@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:<username>@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
<username>\.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

View File

@ -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)