Add multi-makefile management system
[sgt/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 For other compilers, some alternative Makefiles are provided. These
23 Makefiles are generated automatically from the master `Makefile' by
24 the Perl script `mkfiles.pl'. Additions and corrections to the
25 script are more useful than additions and corrections to the
26 alternative Makefiles themselves.
27
28 The PuTTY home web site is
29
30 http://www.chiark.greenend.org.uk/~sgtatham/putty.html
31
32 Bug reports and feature requests should be sent to
33 <putty-bugs@lists.tartarus.org>. PLEASE read the section on the web
34 site about how to report bugs effectively. Do NOT send one-line
35 reports saying `it doesn't work'!
36
37 See the file LICENCE for the licence conditions.