| 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. |
projects / u / mdw / putty / blame