More sensible error handling when we receive an SSH1 public key
[u/mdw/putty] / doc / feedback.but
index 1c2cefb..a84a68f 100644 (file)
@@ -1,4 +1,4 @@
-\versionid $Id: feedback.but,v 1.11 2003/01/17 13:32:51 jacob Exp $
+\versionid $Id: feedback.but,v 1.18 2004/08/18 10:24:40 jacob Exp $
 
 \A{feedback} Feedback and bug reporting
 
@@ -94,7 +94,7 @@ If you think you have found a bug in PuTTY, your first steps should
 be:
 
 \b Check the
-\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist.html}{Wishlist
+\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist/}{Wishlist
 page} on the PuTTY website, and see if we already know about the
 problem. If we do, it is almost certainly not necessary to mail us
 about it, unless you think you have extra information that might be
@@ -132,7 +132,10 @@ just tell us \q{I'm running the latest version}; e-mail can be
 delayed and it may not be obvious which version was the latest at
 the time you sent the message. 
 
-\b Tell us what version of what OS you are running PuTTY on.
+\b PuTTY is a multi-platform application; tell us what version of what
+OS you are running PuTTY on. (If you're running on Unix, or Windows
+for Alpha, tell us, or we'll assume you're running on Windows for
+Intel as this is overwhelmingly the case.)
 
 \b Tell us what protocol you are connecting with: SSH, Telnet,
 Rlogin or Raw mode.
@@ -189,13 +192,13 @@ If you want to request a new feature in PuTTY, the very first things
 you should do are:
 
 \b Check the
-\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist.html}{Wishlist
+\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist/}{Wishlist
 page} on the PuTTY website, and see if your feature is already on
 the list. If it is, it probably won't achieve very much to repeat
 the request. (But see \k{feedback-feature-priority} if you want to
 persuade us to give your particular feature higher priority.)
 
-\b Check the
+\b Check the Wishlist and
 \W{http://www.chiark.greenend.org.uk/~sgtatham/putty/changes.html}{Change
 Log} on the PuTTY website, and see if we have already added your
 feature in the development snapshots. If it isn't clear, download
@@ -281,6 +284,11 @@ a different SSH client and see if it works with that. Please do not
 report it as a PuTTY bug unless you are really sure it \e{is} a bug
 in PuTTY.
 
+\b If someone else installed PuTTY for you, or you're using PuTTY on
+someone else's computer, try asking them for help first.  They're more
+likely to understand how they installed it and what they expected you
+to use it for than we are.
+
 \b If you have successfully made a connection to your server and now
 need to know what to type at the server's command prompt, or other
 details of how to use the server-end software, talk to your server's
@@ -330,6 +338,14 @@ or as part of a collection of useful software on a CD or a web site,
 then \e{permission is already granted}. You don't have to mail us
 and ask. Just go ahead and do it. We don't mind.
 
+(If you want to distribute PuTTY alongside your own application for
+use with that application, or if you want to distribute PuTTY within
+your own organisation, then we recommend you offer your own
+first-line technical support, to answer questions about the
+interaction of PuTTY with your environment. If your users mail us
+directly, we won't be able to tell them anything useful about your
+specific setup.)
+
 If you want to use parts of the PuTTY source code in another
 program, then it might be worth mailing us to talk about technical
 details, but if all you want is to ask permission then you don't
@@ -341,16 +357,17 @@ All mirrors of the PuTTY web site are welcome. Please don't bother
 asking us for permission before setting up a mirror. You already
 have permission. We are always happy to have more mirrors.
 
-If you mail us \e{after} you have set up the mirror, and remember to
-let us know which country your mirror is in, then we'll add it to
-the
+If you mail us \e{after} you have set up the mirror and checked that
+it works, and remember to let us know which country your mirror is in,
+then we'll add it to the
 \W{http://www.chiark.greenend.org.uk/~sgtatham/putty/mirrors.html}{Mirrors
 page} on the PuTTY website.
 
 If you have technical questions about the process of mirroring, then
-you might want to mail us before setting up the mirror; but if you
-just want to ask for permission, you don't need to. You already have
-permission.
+you might want to mail us before setting up the mirror (see also the
+\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/mirrors.html#guidelines}{guidelines on the Mirrors page});
+but if you just want to ask for permission, you don't need to. You
+already have permission.
 
 \H{feedback-compliments} Praise and compliments