Skip to content

Commit b717434

Browse files
committed
README: clarify that you need to run vcvars32 first.
The source-code README file claims that you can start by just running 'cmake .'. But on Windows, that's not literally true. cmake will expect to find a compiler on your path, and if it doesn't, will fail to configure. I'd always taken this for granted, assuming that anyone who was reading this README and trying to compile PuTTY was already familiar with how Windows compiler toolchains work, and only needed the part of the instructions that were specific to PuTTY. But of course there's no reason that should be true. PuTTY's primary target audience, even from before it was called PuTTY, has been Unix expats: people who like to do nearly everything on Unix but for some reason have a Windows machine in front of them. Such a person might very well be familiar with _Unix_ compilation, where the C compiler is installed in /usr/bin and on your PATH already. And then if they want to try to tweak PuTTY, that will be the first time they have to engage with a Windows compiler! So we do need to at least _say_ that the user needs to start by running vcvars32.bat or one of its friends. Even if we don't give full details of where to find it (because I've known it to change now and then), we at least need to remind people to go and look for it.
1 parent 807ed08 commit b717434

File tree

1 file changed

+14
-5
lines changed

1 file changed

+14
-5
lines changed

README

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,23 @@
1-
This is the README for PuTTY, a free Windows and Unix Telnet and SSH
2-
client.
1+
PuTTY source code README
2+
========================
3+
4+
This is the README for the source code of PuTTY, a free Windows and
5+
Unix Telnet and SSH client.
36

47
PuTTY is built using CMake <https://cmake.org/>. To compile in the
5-
simplest way (on any of Linux, Windows or Mac), run these commands in
6-
the source directory:
8+
simplest way (on any of Linux, Windows or Mac), the general method is
9+
to run these commands in the source directory:
710

811
cmake .
912
cmake --build .
1013

11-
Then, to install in the simplest way on Linux or Mac:
14+
These commands will expect to find a usable compile toolchain on your
15+
path. So if you're building on Windows with MSVC, you'll need to make
16+
sure that the MSVC compiler (cl.exe) is on your path, by running one
17+
of the 'vcvars32.bat' setup scripts provided with the tools. Then the
18+
cmake commands above should work.
19+
20+
To install in the simplest way on Linux or Mac:
1221

1322
cmake --build . --target install
1423

0 commit comments

Comments
 (0)