Added indexing for the first three chapters of the manual. This is a

big job :-/

[originally from svn r4041]

doc/gs.but

@@ -1,11 +1,11 @@
-\versionid $Id: gs.but,v 1.6 2001/12/06 20:05:39 simon Exp $
+\versionid $Id: gs.but,v 1.7 2004/04/08 12:38:53 simon Exp $
 
 \C{gs} Getting started with PuTTY
 
 This chapter gives a quick guide to the simplest types of
 interactive login session using PuTTY.
 
-\H{gs-insecure} Starting a session
+\H{gs-insecure} \ii{Starting a session}
 
 When you start PuTTY, you will see a dialog box. This dialog box
 allows you to control everything PuTTY can do. See \k{config} for
@@ -19,12 +19,13 @@ In the \q{Host Name} box, enter the Internet host name of the server
 you want to connect to. You should have been told this by the
 provider of your login account.
 
-Now select a login protocol to use, from the \q{Protocol} buttons.
-For a login session, you should select Telnet, Rlogin or SSH. See
-\k{which-one} for a description of the differences between the three
-protocols, and advice on which one to use. The fourth protocol,
-\e{Raw}, is not used for interactive login sessions; you would
-usually use this for debugging other Internet services.
+Now select a login \i{protocol} to use, from the \q{Protocol}
+buttons. For a login session, you should select \i{Telnet},
+\i{Rlogin} or \i{SSH}. See \k{which-one} for a description of the
+differences between the three protocols, and advice on which one to
+use. The fourth protocol, \I{raw protocol}\e{Raw}, is not used for
+interactive login sessions; you would usually use this for debugging
+other Internet services.
 
 When you change the selected protocol, the number in the \q{Port}
 box will change. This is normal: it happens because the various
@@ -33,16 +34,17 @@ the server machine. Most servers will use the standard port numbers,
 so you will not need to change the port setting. If your server
 provides login services on a non-standard port, your system
 administrator should have told you which one. (For example, many
-MUDs run Telnet service on a port other than 23.)
+\i{MUDs} run Telnet service on a port other than 23.)
 
 Once you have filled in the \q{Host Name}, \q{Protocol}, and
 possibly \q{Port} settings, you are ready to connect. Press the
 \q{Open} button at the bottom of the dialog box, and PuTTY will
 begin trying to connect you to the server.
 
-\H{gs-hostkey} Verifying the Host Key (SSH only)
+\H{gs-hostkey} \i{Verifying the host key} (SSH only)
 
-If you are not using the SSH protocol, you can skip this section.
+If you are not using the \i{SSH} protocol, you can skip this
+section.
 
 If you are using SSH to connect to a server for the first time, you
 will probably see a message looking something like this:
@@ -60,12 +62,12 @@ will probably see a message looking something like this:
 \c connection.
 
 This is a feature of the SSH protocol. It is designed to protect you
-against a network attack known as \e{spoofing}: secretly redirecting
-your connection to a different computer, so that you send your
-password to the wrong machine. Using this technique, an attacker
-would be able to learn the password that guards your login account,
-and could then log in as if they were you and use the account for
-their own purposes.
+against a network attack known as \i\e{spoofing}: secretly
+redirecting your connection to a different computer, so that you
+send your password to the wrong machine. Using this technique, an
+attacker would be able to learn the password that guards your login
+account, and could then log in as if they were you and use the
+account for their own purposes.
 
 To prevent this attack, each server has a unique identifying code,
 called a \e{host key}. These keys are created in a way that prevents
@@ -75,16 +77,18 @@ expecting, PuTTY can warn you that the server may have been switched
 and that a spoofing attack might be in progress.
 
 PuTTY records the host key for each server you connect to, in the
-Windows Registry. Every time you connect to a server, it checks that
-the host key presented by the server is the same host key as it was
-the last time you connected. If it is not, you will see a warning,
-and you will have the chance to abandon your connection before you
-type any private information (such as a password) into it.
+Windows \i{Registry}. Every time you connect to a server, it checks
+that the host key presented by the server is the same host key as it
+was the last time you connected. If it is not, you will see a
+warning, and you will have the chance to abandon your connection
+before you type any private information (such as a password) into
+it.
 
 However, when you connect to a server you have not connected to
 before, PuTTY has no way of telling whether the host key is the
 right one or not. So it gives the warning shown above, and asks you
-whether you want to trust this host key or not.
+whether you want to \I{trusting host keys}trust this host key or
+not.
 
 Whether or not to trust the host key is your choice. If you are
 connecting within a company network, you might feel that all the
@@ -101,22 +105,22 @@ list, but it doesn't matter which one it is.)
 doesn't work that way. Ask the team if they have any good ideas for
 changes to this section!
 
-\H{gs-login} Logging In
+\H{gs-login} \ii{Logging in}
 
 After you have connected, and perhaps verified the server's host
-key, you will be asked to log in, probably using a username and a
-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 mistyped your
-password, most servers will give you several chances to get it
-right.
+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.
 
 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
 Return. This is an unfortunate feature of the SSH protocol: it does
-not allow you to make two login attempts using different usernames.
-If you type your username wrongly, you must close PuTTY and start
-again.
+not allow you to make two login attempts using \i{different
+usernames}. If you type your username wrongly, you must close PuTTY
+and start again.
 
 If your password is refused but you are sure you have typed it
 correctly, check that Caps Lock is not enabled. Many login servers,
@@ -124,16 +128,16 @@ particularly Unix computers, treat upper case and lower case as
 different when checking your password; so if Caps Lock is on, your
 password will probably be refused.
 
-\H{gs-session} After Logging In
+\H{gs-session} After logging in
 
 After you log in to the server, what happens next is up to the
 server! Most servers will print some sort of login message and then
-present a prompt, at which you can type commands which the server
-will carry out. Some servers will offer you on-line help; others
-might not. If you are in doubt about what to do next, consult your
-system administrator.
+present a \i{prompt}, at which you can type commands which the
+server will carry out. Some servers will offer you on-line help;
+others might not. If you are in doubt about what to do next, consult
+your system administrator.
 
-\H{gs-logout} Logging Out
+\H{gs-logout} \ii{Logging out}
 
 When you have finished your session, you should log out by typing
 the server's own logout command. This might vary between servers; if
@@ -141,7 +145,7 @@ in doubt, try \c{logout} or \c{exit}, or consult a manual or your
 system administrator. When the server processes your logout command,
 the PuTTY window should close itself automatically.
 
-You \e{can} close a PuTTY session using the Close button in the
+You \e{can} close a PuTTY session using the \i{Close button} in the
 window border, but this might confuse the server - a bit like
 hanging up a telephone unexpectedly in the middle of a conversation.
 We recommend you do not do this unless the server has stopped