X-Git-Url: https://asedeno.scripts.mit.edu/gitweb/?a=blobdiff_plain;f=README;h=63cae839033d2b3bb78d5a03fc86fb999420ae33;hb=d5e66f6098c9a49a4ee66f2e1139375de81354be;hp=7a52661773058d3dc46a334af9ba68c1e107fc62;hpb=f1f2aafbfc1d03950709c2dbc51a27e2b0f30464;p=PuTTY.git diff --git a/README b/README index 7a526617..63cae839 100644 --- a/README +++ b/README @@ -1,23 +1,47 @@ This is the README for PuTTY, a free Win32 Telnet and SSH client. -The provided Makefile is for MS Visual C++ systems. Type `nmake' to -build both putty.exe (the main program) and pscp.exe (an SCP -client). The comment at the top of the Makefile gives extra build -options you can use to build in limited Win32s compatibility, a hack -to pass SSH through some types of firewall, and `official' version -numbers. - -Setting up a project file in the Visual C++ IDE sometimes fails to -work. In particular, Visual Studio 6 falls over on the odd macro -usage in ssh.c. This is a bug in Visual Studio, since the VC++6 -command line compiler works fine. If in doubt, just use `nmake'. +If you want to rebuild PuTTY from source, we provide three +Makefiles: + + - Makefile.vc is for MS Visual C++ systems. Type `nmake -f + Makefile.vc' to build all the PuTTY binaries. + + - Makefile.bor is for the Borland C compiler. Type `make -f + Makefile.bor' to build all the PuTTY binaries. + + - Makefile.cyg is for Cygwin / mingw32 installations. Type `make -f + Makefile.cyg' to build all the PuTTY binaries. Note that by + default the Pageant WinNT security features and the multiple + monitor support are excluded from the Cygwin build, since at the + time of writing this Cygwin doesn't include the necessary + headers. + +If you have MS Visual Studio version 6 and you want to build a +DevStudio project for GUI editing and debugging, you should be aware +that the default GUI configuration of the compiler falls over on the +nasty macros in ssh.c. This is a bug in Visual Studio. The culprit +is the /ZI compiler option (debug info generation: Edit and +Continue). To avoid this problem while compiling PuTTY under VS6, +you should: + - right-click ssh.c in the FileView + - click Settings + - select the C/C++ tab and the General category + - under `Debug info:', select anything _other_ than `Program + Database for Edit and Continue'. +Alternatively disable the /ZI option, replacing it with a saner +value, such as /Zi. + +All of the Makefiles are generated automatically from the file +`Recipe' by the Perl script `mkfiles.pl'. Additions and corrections +to Recipe and the mkfiles.pl are much more useful than additions and +corrections to the alternative Makefiles themselves. The PuTTY home web site is - http://www.chiark.greenend.org.uk/~sgtatham/putty.html + http://www.chiark.greenend.org.uk/~sgtatham/putty/ Bug reports and feature requests should be sent to -. PLEASE read the section on the web +. PLEASE read the section on the web site about how to report bugs effectively. Do NOT send one-line reports saying `it doesn't work'!