mirror of
https://git.tartarus.org/simon/putty.git
synced 2025-04-10 15:48:06 -05:00
b29758c1b6
This allows a couple more settings to be treated automatically on save, which are more complicated on load because they still honour older alternative save keywords. In particular, CONF_proxy_type and CONF_remote_qtitle_action now have explicit enum mappings. These were needed for the automated save code, but also, I've rewritten the custom load code to use them too. This decouples the storage format of those settings from the order of values in the internal enum, which is generally an advantage of specifying storage enums explicitly. Those two settings weren't already tested by test_conf, because I wasn't changing them in previous commits. Now I've added extra code that does test them, and verified it works when backported to commit b567c9b2b5e159f where I introduced test_conf before beginning the main refactoring. A setting can also be specified explicitly as not loaded and saved at all. There were quite a few commented that way, but now there's a machine-readable indication of it. test_conf will now check that all these settings make sense together - things shouldn't have a save keyword unless they use it, and should have one if they don't, and shouldn't specify combinations of options that conflict. (For that reason, test_conf is now also running the consistency check before the main test, so that a missing keyword will cause an error message _before_ it causes a segfault, saving some debugging!)
This is the README for PuTTY, a free Windows and Unix Telnet and SSH
client.
PuTTY is built using CMake <https://cmake.org/>. To compile in the
simplest way (on any of Linux, Windows or Mac), run these commands in
the source directory:
cmake .
cmake --build .
Then, to install in the simplest way on Linux or Mac:
cmake --build . --target install
On Unix, pterm would like to be setuid or setgid, as appropriate, to
permit it to write records of user logins to /var/run/utmp and
/var/log/wtmp. (Of course it will not use this privilege for
anything else, and in particular it will drop all privileges before
starting up complex subsystems like GTK.) The cmake install step
doesn't attempt to add these privileges, so if you want user login
recording to work, you should manually ch{own,grp} and chmod the
pterm binary yourself after installation. If you don't do this,
pterm will still work, but not update the user login databases.
Documentation (in various formats including Windows Help and Unix
`man' pages) is built from the Halibut (`.but') files in the `doc'
subdirectory. If you aren't using one of our source snapshots,
you'll need to do this yourself. Halibut can be found at
<https://www.chiark.greenend.org.uk/~sgtatham/halibut/>.
The PuTTY home web site is
https://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.