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