| 1 | This is the README for PuTTY, a free Win32 Telnet and SSH client. |
| 2 | |
| 3 | The provided Makefile is for MS Visual C++ systems. Type `nmake' to |
| 4 | build both putty.exe (the main program) and pscp.exe (an SCP |
| 5 | client). The comment at the top of the Makefile gives extra build |
| 6 | options you can use to build in limited Win32s compatibility, a hack |
| 7 | to pass SSH through some types of firewall, and `official' version |
| 8 | numbers. |
| 9 | |
| 10 | MS Visual Studio version 6 falls over on the nasty macros in ssh.c. |
| 11 | This is a bug in Visual Studio. The culprit is the /ZI compiler |
| 12 | option (debug info generation: Edit and Continue). To avoid this |
| 13 | problem while compiling PuTTY under VS6, you should: |
| 14 | - right-click ssh.c in the FileView |
| 15 | - click Settings |
| 16 | - select the C/C++ tab and the General category |
| 17 | - under `Debug info:', select anything _other_ than `Program |
| 18 | Database for Edit and Continue'. |
| 19 | Alternatively disable the /ZI option, replacing it with a saner |
| 20 | value, such as /Zi. |
| 21 | |
| 22 | For other compilers, some alternative Makefiles are provided. These |
| 23 | Makefiles are generated automatically from the master `Makefile' by |
| 24 | the Perl script `mkfiles.pl'. Additions and corrections to the |
| 25 | script are more useful than additions and corrections to the |
| 26 | alternative Makefiles themselves. |
| 27 | |
| 28 | The PuTTY home web site is |
| 29 | |
| 30 | http://www.chiark.greenend.org.uk/~sgtatham/putty/ |
| 31 | |
| 32 | Bug reports and feature requests should be sent to |
| 33 | <putty-bugs@lists.tartarus.org>. PLEASE read the section on the web |
| 34 | site about how to report bugs effectively. Do NOT send one-line |
| 35 | reports saying `it doesn't work'! |
| 36 | |
| 37 | See the file LICENCE for the licence conditions. |