X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/putty/blobdiff_plain/211d84da9aff9c324b12f274d82cf2dc35348750..39a938f7a5e16b4be9bee493251238710fbff396:/doc/feedback.but?ds=sidebyside diff --git a/doc/feedback.but b/doc/feedback.but index a84a68f6..b0b1d652 100644 --- a/doc/feedback.but +++ b/doc/feedback.but @@ -1,4 +1,4 @@ -\versionid $Id: feedback.but,v 1.18 2004/08/18 10:24:40 jacob Exp $ +\define{versionidfeedback} \versionid $Id$ \A{feedback} Feedback and bug reporting @@ -15,17 +15,16 @@ reports and feature requests. The PuTTY development team gets a \e{lot} of mail. If you can possibly solve your own problem by reading the manual, reading the -FAQ, reading the web site, asking a fellow user, perhaps posting on -the newsgroup \W{news:comp.security.ssh}\c{comp.security.ssh}, or -some other means, then it would make our lives much easier. +FAQ, reading the web site, asking a fellow user, perhaps posting to a +newsgroup (see \k{feedback-other-fora}), or some other means, then it +would make our lives much easier. We get so much e-mail that we literally do not have time to answer it all. We regret this, but there's nothing we can do about it. So if you can \e{possibly} avoid sending mail to the PuTTY team, we recommend you do so. In particular, support requests -(\k{feedback-support}) are probably better sent to -\W{news:comp.security.ssh}\c{comp.security.ssh} or passed to a local -expert if possible. +(\k{feedback-support}) are probably better sent to newsgroups, or +passed to a local expert if possible. The PuTTY contact email address is a private mailing list containing four or five core developers. Don't be put off by it being a mailing @@ -88,6 +87,21 @@ modification. If you've only changed 10 lines, we'd prefer to receive a mail that's 30 lines long than one containing multiple megabytes of data we already have. +\S{feedback-other-fora} Other places to ask for help + +There are two Usenet newsgroups that are particularly relevant to the +PuTTY tools: + +\b \W{news:comp.security.ssh}\c{comp.security.ssh}, for questions +specific to using the SSH protocol; + +\b \W{news:comp.terminals}\c{comp.terminals}, for issues relating to +terminal emulation (for instance, keyboard problems). + +If you don't have direct access to Usenet, you can access these +newsgroups through Google Groups +(\W{http://groups.google.com/}\cw{groups.google.com}). + \H{feedback-bugs} Reporting bugs If you think you have found a bug in PuTTY, your first steps should @@ -180,8 +194,8 @@ think the documentation is unclear or unhelpful. But we do need to be given exact details of \e{what} you think the documentation has failed to tell you, or \e{how} you think it could be made clearer. If your problem is simply that you don't \e{understand} the -documentation, we suggest posting to the newsgroup -\W{news:comp.security.ssh}\c{comp.security.ssh} and see if someone +documentation, we suggest posting to a newsgroup (see +\k{feedback-other-fora}) and seeing if someone will explain what you need to know. \e{Then}, if you think the documentation could usefully have told you that, send us a bug report and explain how you think we should change it. @@ -271,14 +285,14 @@ don't have time to answer all the questions. Questions of this type include: \b If you want to do something with PuTTY but have no idea where to -start, and reading the manual hasn't helped, try posting to the -newsgroup \W{news:comp.security.ssh}\c{comp.security.ssh} and see if -someone can explain it to you. +start, and reading the manual hasn't helped, try posting to a +newsgroup (see \k{feedback-other-fora}) and see if someone can explain +it to you. \b If you have tried to do something with PuTTY but it hasn't worked, and you aren't sure whether it's a bug in PuTTY or a bug in your SSH server or simply that you're not doing it right, then try -posting to \W{news:comp.security.ssh}\c{comp.security.ssh} and see +posting to a newsgroup (see \k{feedback-other-fora}) and see if someone can solve your problem. Or try doing the same thing with 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 @@ -353,9 +367,10 @@ need to bother. You already have permission. \H{feedback-mirrors} Mirroring the PuTTY web site -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. +Mirrors of the PuTTY web site are welcome, especially in regions not +well covered by existing mirrors. 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 checked that it works, and remember to let us know which country your mirror is in,