[u/mdw/putty] / README

This is the README for PuTTY, a free Win32 Telnet and SSH client.

The provided Makefile is for MS Visual C++ systems. Type `nmake' to
build both putty.exe (the main program) and pscp.exe (an SCP
client). The comment at the top of the Makefile gives extra build
options you can use to build in limited Win32s compatibility, a hack
to pass SSH through some types of firewall, and `official' version
numbers.

MS Visual Studio version 6 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.

For other compilers, some alternative Makefiles are provided. These
Makefiles are generated automatically from the master `Makefile' by
the Perl script `mkfiles.pl'. Additions and corrections to the
script are 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.html

Bug reports and feature requests should be sent to
<putty-bugs@lists.tartarus.org>. PLEASE read the section on the web
site about how to report bugs effectively. Do NOT send one-line
reports saying `it doesn't work'!

See the file LICENCE for the licence conditions.
Commit	Line	Data
b9c299bb	1	This is the README for PuTTY, a free Win32 Telnet and SSH client.
	2
	3	The provided Makefile is for MS Visual C++ systems. Type `nmake' to
	4	build both putty.exe (the main program) and pscp.exe (an SCP
df0b42a5	5	client). The comment at the top of the Makefile gives extra build
	6	options you can use to build in limited Win32s compatibility, a hack
	7	to pass SSH through some types of firewall, and `official' version
	8	numbers.
b9c299bb	9
b8c98f3c	10	MS Visual Studio version 6 falls over on the nasty macros in ssh.c.
	11	This is a bug in Visual Studio. The culprit is the /ZI compiler
	12	option (debug info generation: Edit and Continue). To avoid this
	13	problem while compiling PuTTY under VS6, you should:
	14	- right-click ssh.c in the FileView
	15	- click Settings
	16	- select the C/C++ tab and the General category
	17	- under `Debug info:', select anything _other_ than `Program
	18	Database for Edit and Continue'.
	19	Alternatively disable the /ZI option, replacing it with a saner
	20	value, such as /Zi.
b9c299bb	21
3d541627	22	For other compilers, some alternative Makefiles are provided. These
	23	Makefiles are generated automatically from the master `Makefile' by
	24	the Perl script `mkfiles.pl'. Additions and corrections to the
	25	script are more useful than additions and corrections to the
	26	alternative Makefiles themselves.
	27
b9c299bb	28	The PuTTY home web site is
	29
	30	http://www.chiark.greenend.org.uk/~sgtatham/putty.html
	31
	32	Bug reports and feature requests should be sent to
	33	<putty-bugs@lists.tartarus.org>. PLEASE read the section on the web
	34	site about how to report bugs effectively. Do NOT send one-line
	35	reports saying `it doesn't work'!
	36
	37	See the file LICENCE for the licence conditions.