Initial checkin of PuTTY installer script and associated files.
[u/mdw/putty] / README
CommitLineData
b9c299bb 1This is the README for PuTTY, a free Win32 Telnet and SSH client.
2
7603011f 3If you want to rebuild PuTTY from source, we provide three
4Makefiles:
5
6 - Makefile.vc is for MS Visual C++ systems. Type `nmake -f
7 Makefile.vc' to build all the PuTTY binaries.
8
9 - Makefile.bor is for the Borland C compiler. Type `make -f
10 Makefile.bor' to build all the PuTTY binaries.
11
12 - Makefile.cyg is for Cygwin / mingw32 installations. Type `make -f
13 Makefile.cyg' to build all the PuTTY binaries. Note that by
14 default the Pageant WinNT security features and the multiple
15 monitor support are excluded from the Cygwin build, since at the
16 time of writing this Cygwin doesn't include the necessary
17 headers.
18
19If you have MS Visual Studio version 6 and you want to build a
20DevStudio project for GUI editing and debugging, you should be aware
21that the default GUI configuration of the compiler falls over on the
22nasty macros in ssh.c. This is a bug in Visual Studio. The culprit
23is the /ZI compiler option (debug info generation: Edit and
24Continue). To avoid this problem while compiling PuTTY under VS6,
25you should:
b8c98f3c 26 - right-click ssh.c in the FileView
27 - click Settings
28 - select the C/C++ tab and the General category
29 - under `Debug info:', select anything _other_ than `Program
30 Database for Edit and Continue'.
31Alternatively disable the /ZI option, replacing it with a saner
32value, such as /Zi.
b9c299bb 33
7603011f 34All of the Makefiles are generated automatically from the file
35`Recipe' by the Perl script `mkfiles.pl'. Additions and corrections
36to Recipe and the mkfiles.pl are much more useful than additions and
37corrections to the alternative Makefiles themselves.
3d541627 38
b9c299bb 39The PuTTY home web site is
40
df96b74b 41 http://www.chiark.greenend.org.uk/~sgtatham/putty/
b9c299bb 42
43Bug reports and feature requests should be sent to
6a4abb53 44<putty@projects.tartarus.org>. PLEASE read the section on the web
b9c299bb 45site about how to report bugs effectively. Do NOT send one-line
46reports saying `it doesn't work'!
47
48See the file LICENCE for the licence conditions.