X-Git-Url: https://git.distorted.org.uk/u/mdw/putty/blobdiff_plain/b6b40d9bb2845ec2db90af4ca5c6eb561f0ce411..58de2f3c7d0312d782a9940c898399f473fb2a2b:/README diff --git a/README b/README index de698aa8..b9a7cc63 100644 --- a/README +++ b/README @@ -1,17 +1,26 @@ This is the README for the source archive of PuTTY, a free Win32 Telnet and SSH client. -If you want to rebuild PuTTY from source, we provide three -Makefiles: +If you want to rebuild PuTTY from source, we provide a variety of +Makefiles and equivalents: - - Makefile.vc is for MS Visual C++ systems. Type `nmake -f - Makefile.vc' to build all the PuTTY binaries. + - Makefile.vc is for command-line builds on MS Visual C++ systems. + Type `nmake -f Makefile.vc' to build all the PuTTY binaries. (We've also had one report of success building with the OpenWatcom compiler -- www.openwatcom.org -- using Makefile.vc with `wmake -ms -f makefile.vc' and NO_MULTIMON, although we haven't tried this ourselves.) + - Inside the MSVC subdirectory are MS Visual Studio project files + for doing GUI-based builds of the various PuTTY utilities. These + have been tested on Visual Studio 6. + + You should be able to build each PuTTY utility by loading the + corresponding .dsp file in Visual Studio. For example, + MSVC/putty/putty.dsp builds PuTTY itself, MSVC/plink/plink.dsp + builds Plink, and so on. + - Makefile.bor is for the Borland C compiler. Type `make -f Makefile.bor' to build all the PuTTY binaries. @@ -22,21 +31,6 @@ Makefiles: 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