[u/mdw/putty] / README

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 a variety of
Makefiles and equivalents:

 - 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.

 - 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.

 - Makefile.lcc is for lcc-win32. Type `make -f Makefile.lcc'. (You
   will probably need to specify COMPAT=-DNO_MULTIMON.)

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/

If you want to send bug reports or feature requests, please read the
Feedback section of the web site before doing so. Sending one-line
reports saying `it doesn't work' will waste your time as much as
ours.

See the file LICENCE for the licence conditions.
Commit	Line	Data
6e9a74eb	1	This is the README for the source archive of PuTTY, a free Win32
6e9a74eb	2	Telnet and SSH client.
b9c299bb	3
58de2f3c	4	If you want to rebuild PuTTY from source, we provide a variety of
58de2f3c	5	Makefiles and equivalents:
7603011f	6
58de2f3c	7	- Makefile.vc is for command-line builds on MS Visual C++ systems.
58de2f3c	8	Type `nmake -f Makefile.vc' to build all the PuTTY binaries.
7603011f	9
62793edf	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
58de2f3c	15	- Inside the MSVC subdirectory are MS Visual Studio project files
	16	for doing GUI-based builds of the various PuTTY utilities. These
	17	have been tested on Visual Studio 6.
	18
	19	You should be able to build each PuTTY utility by loading the
	20	corresponding .dsp file in Visual Studio. For example,
	21	MSVC/putty/putty.dsp builds PuTTY itself, MSVC/plink/plink.dsp
	22	builds Plink, and so on.
	23
7603011f	24	- Makefile.bor is for the Borland C compiler. Type `make -f
	25	Makefile.bor' to build all the PuTTY binaries.
	26
	27	- Makefile.cyg is for Cygwin / mingw32 installations. Type `make -f
	28	Makefile.cyg' to build all the PuTTY binaries. Note that by
	29	default the Pageant WinNT security features and the multiple
	30	monitor support are excluded from the Cygwin build, since at the
	31	time of writing this Cygwin doesn't include the necessary
	32	headers.
	33
2c228de6	34	- Makefile.lcc is for lcc-win32. Type `make -f Makefile.lcc'. (You
	35	will probably need to specify COMPAT=-DNO_MULTIMON.)
	36
7603011f	37	All of the Makefiles are generated automatically from the file
	38	`Recipe' by the Perl script `mkfiles.pl'. Additions and corrections
	39	to Recipe and the mkfiles.pl are much more useful than additions and
	40	corrections to the alternative Makefiles themselves.
3d541627	41
b9c299bb	42	The PuTTY home web site is
b9c299bb	43
df96b74b	44	http://www.chiark.greenend.org.uk/~sgtatham/putty/
b9c299bb	45
6e9a74eb	46	If you want to send bug reports or feature requests, please read the
	47	Feedback section of the web site before doing so. Sending one-line
	48	reports saying `it doesn't work' will waste your time as much as
	49	ours.
b9c299bb	50
b9c299bb	51	See the file LICENCE for the licence conditions.