| 1 | This is the README for PuTTY, a free Win32 Telnet and SSH client. |
| 2 | |
| 3 | If you want to rebuild PuTTY from source, we provide three |
| 4 | Makefiles: |
| 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 | |
| 19 | If you have MS Visual Studio version 6 and you want to build a |
| 20 | DevStudio project for GUI editing and debugging, you should be aware |
| 21 | that the default GUI configuration of the compiler falls over on the |
| 22 | nasty macros in ssh.c. This is a bug in Visual Studio. The culprit |
| 23 | is the /ZI compiler option (debug info generation: Edit and |
| 24 | Continue). To avoid this problem while compiling PuTTY under VS6, |
| 25 | you should: |
| 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'. |
| 31 | Alternatively disable the /ZI option, replacing it with a saner |
| 32 | value, such as /Zi. |
| 33 | |
| 34 | All of the Makefiles are generated automatically from the file |
| 35 | `Recipe' by the Perl script `mkfiles.pl'. Additions and corrections |
| 36 | to Recipe and the mkfiles.pl are much more useful than additions and |
| 37 | corrections to the alternative Makefiles themselves. |
| 38 | |
| 39 | The PuTTY home web site is |
| 40 | |
| 41 | http://www.chiark.greenend.org.uk/~sgtatham/putty/ |
| 42 | |
| 43 | Bug reports and feature requests should be sent to |
| 44 | <putty@projects.tartarus.org>. PLEASE read the section on the web |
| 45 | site about how to report bugs effectively. Do NOT send one-line |
| 46 | reports saying `it doesn't work'! |
| 47 | |
| 48 | See the file LICENCE for the licence conditions. |