Add description of workaround for Visual Studio 6 problem
[u/mdw/putty] / README
1 This is the README for PuTTY, a free Win32 Telnet and SSH client.
2
3 The provided Makefile is for MS Visual C++ systems. Type `nmake' to
4 build both putty.exe (the main program) and pscp.exe (an SCP
5 client). The comment at the top of the Makefile gives extra build
6 options you can use to build in limited Win32s compatibility, a hack
7 to pass SSH through some types of firewall, and `official' version
8 numbers.
9
10 MS Visual Studio version 6 falls over on the nasty macros in ssh.c.
11 This is a bug in Visual Studio. The culprit is the /ZI compiler
12 option (debug info generation: Edit and Continue). To avoid this
13 problem while compiling PuTTY under VS6, you should:
14 - right-click ssh.c in the FileView
15 - click Settings
16 - select the C/C++ tab and the General category
17 - under `Debug info:', select anything _other_ than `Program
18 Database for Edit and Continue'.
19 Alternatively disable the /ZI option, replacing it with a saner
20 value, such as /Zi.
21
22 The PuTTY home web site is
23
24 http://www.chiark.greenend.org.uk/~sgtatham/putty.html
25
26 Bug reports and feature requests should be sent to
27 <putty-bugs@lists.tartarus.org>. PLEASE read the section on the web
28 site about how to report bugs effectively. Do NOT send one-line
29 reports saying `it doesn't work'!
30
31 See the file LICENCE for the licence conditions.