From 5fd89724d36c0df4e59cf572c2ca4c28069d4644 Mon Sep 17 00:00:00 2001 From: Jacob Nevins Date: Fri, 19 Apr 2019 12:06:30 +0100 Subject: [PATCH] Rewrite "Getting started / Logging in". - Mention public key authentication - Define and describe the "terminal window" - Mention trust sigils - Describe here the lack of feedback in password prompts, as well as in the FAQ --- doc/faq.but | 2 +- doc/gs.but | 24 ++++++++++++++++++++---- doc/index.but | 4 ++++ 3 files changed, 25 insertions(+), 5 deletions(-) diff --git a/doc/faq.but b/doc/faq.but index 009ba850..44a2fcf5 100644 --- a/doc/faq.but +++ b/doc/faq.but @@ -424,7 +424,7 @@ You can ask PuTTY to delete all this data; see \k{faq-cleanup}. On Unix, PuTTY stores all of this data in a directory \cw{~/.putty} by default. -\S{faq-trust-sigils} Why do small PuTTY icons appear next to the login +\S{faq-trust-sigils} Why do small \i{PuTTY icon}s appear next to the login prompts? As of PuTTY 0.71, some lines of text in the terminal window are marked diff --git a/doc/gs.but b/doc/gs.but index 56ab282a..fb33f3d7 100644 --- a/doc/gs.but +++ b/doc/gs.but @@ -113,10 +113,26 @@ changes to this section! After you have connected, and perhaps verified the server's host key, you will be asked to log in, probably using a \i{username} and a \i{password}. Your system administrator should have provided you -with these. Enter the username and the password, and the server -should grant you access and begin your session. If you have -\I{mistyping a password}mistyped your password, most servers will -give you several chances to get it right. +with these. (If, instead, your system administrator has asked you to +provide, or provided you with, a \q{public key} or \q{key file}, see +\k{pubkey}.) + +PuTTY will display a text window (the \q{\i{terminal window}} \dash it +will have a black background unless you've changed the defaults), and +prompt you to type your username and password into that window. (These +prompts will include the \i{PuTTY icon}, to distinguish them from any +text sent by the server in the same window.) + +Enter the username and the password, and the server should grant you +access and begin your session. If you have +\I{mistyping a password}mistyped your password, most servers will give +you several chances to get it right. + +While you are typing your password, you will not usually see the +cursor moving in the window, but PuTTY \e{is} registering what you +type, and will send it when you press Return. (It works this way to +avoid revealing the length of your password to anyone watching your +screen.) If you are using SSH, be careful not to type your username wrongly, because you will not have a chance to correct it after you press diff --git a/doc/index.but b/doc/index.but index debd2ab2..cd68d504 100644 --- a/doc/index.but +++ b/doc/index.but @@ -893,3 +893,7 @@ saved sessions from \IM{proxy logging} logging, proxy \IM{proxy logging} diagnostic, proxy \IM{proxy logging} standard error, proxy + +\IM{PuTTY icon} PuTTY icon +\IM{PuTTY icon} icon, PuTTY's +\IM{PuTTY icon} logo, PuTTY's