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