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

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
7603011f	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.
3d541627	38
b9c299bb	39	The PuTTY home web site is
b9c299bb	40
df96b74b	41	http://www.chiark.greenend.org.uk/~sgtatham/putty/
b9c299bb	42
6e9a74eb	43	If you want to send bug reports or feature requests, please read the
	44	Feedback section of the web site before doing so. Sending one-line
	45	reports saying `it doesn't work' will waste your time as much as
	46	ours.
b9c299bb	47
b9c299bb	48	See the file LICENCE for the licence conditions.