git.distorted.org.uk Git - u/mdw/putty/blob - README

   1 This is the README for the source archive of PuTTY, a free Win32
   2 Telnet and SSH client.
   3
   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
  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
  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:
  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.
  39
  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.
  44
  45 The PuTTY home web site is
  46
  47     http://www.chiark.greenend.org.uk/~sgtatham/putty/
  48
  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.
  53
  54 See the file LICENCE for the licence conditions.