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

   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-bugs@lists.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.