summaryrefslogtreecommitdiffstats
path: root/src/man
diff options
context:
space:
mode:
authorGreg Hudson <ghudson@mit.edu>2012-03-24 14:29:44 +0000
committerGreg Hudson <ghudson@mit.edu>2012-03-24 14:29:44 +0000
commit44217e054db645e47642bde12d48736263193620 (patch)
tree550bdac62a230c2f23e4d195b9fcaf840b0562ae /src/man
parent5c90e2e933f6449e05b334cdfdb4a828d1fa8535 (diff)
downloadkrb5-44217e054db645e47642bde12d48736263193620.tar.gz
krb5-44217e054db645e47642bde12d48736263193620.tar.xz
krb5-44217e054db645e47642bde12d48736263193620.zip
Remove krb5-send-pr man page
The license on the krb5-send-pr man page was incompatible with the rest of our documentation, and the content is questionably up to date (krb5-send-pr still exists, but we don't use GNATS any more, and free-form mail to krb5-bugs is equally acceptable at this point). Get rid of it for now. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@25788 dc483132-0cff-0310-8789-dd5450dbe970
Diffstat (limited to 'src/man')
-rw-r--r--src/man/krb5-send-pr.man231
1 files changed, 0 insertions, 231 deletions
diff --git a/src/man/krb5-send-pr.man b/src/man/krb5-send-pr.man
deleted file mode 100644
index 004958898c..0000000000
--- a/src/man/krb5-send-pr.man
+++ /dev/null
@@ -1,231 +0,0 @@
-.TH "KRB5-SEND-PR" "1" " " "0.0.1" "MIT Kerberos"
-.SH NAME
-krb5-send-pr \- send problem report (PR) to a central support site
-.
-.nr rst2man-indent-level 0
-.
-.de1 rstReportMargin
-\\$1 \\n[an-margin]
-level \\n[rst2man-indent-level]
-level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
--
-\\n[rst2man-indent0]
-\\n[rst2man-indent1]
-\\n[rst2man-indent2]
-..
-.de1 INDENT
-.\" .rstReportMargin pre:
-. RS \\$1
-. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
-. nr rst2man-indent-level +1
-.\" .rstReportMargin post:
-..
-.de UNINDENT
-. RE
-.\" indent \\n[an-margin]
-.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.nr rst2man-indent-level -1
-.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
-..
-.\" Man page generated from reStructeredText.
-.
-.SH SYNOPSIS
-.sp
-\fBkrb5\-send\-pr\fP
-[\fIsite\fP]
-[\fB\-f\fP \fIproblem\-report\fP]
-[\fB\-t\fP \fImail\-address\fP]
-[\fB\-P\fP]
-[\fB\-L\fP]
-[\fB\-s\fP \fIseverity\fP]
-[\fB\-c\fP \fIaddress\fP]
-[\fB\-\-request\-id\fP]
-[\fB\-V\fP]
-.SH DESCRIPTION
-.sp
-krb5\-send\-pr is a tool used to submit problem reports (PRs) to a
-central support site. In most cases the correct site will be the
-default. This argument indicates the support site which is
-responsible for the category of problem involved. Some sites may use
-a local address as a default. \fIsite\fP values are defined by using the
-aliases(5).
-.sp
-krb5\-send\-pr invokes an editor on a problem report template (after
-trying to fill in some fields with reasonable default values). When
-you exit the editor, krb5\-send\-pr sends the completed form to the
-Problem Report Management System (\fBGNATS\fP) at a central support
-site. At the support site, the PR is assigned a unique number and is
-stored in the GNATS database according to its category and
-submitter\-id. GNATS automatically replies with an acknowledgement,
-citing the category and the PR number.
-.sp
-To ensure that a PR is handled promptly, it should contain your (unique)
-\fIsubmitter\-id\fP and one of the available \fIcategories\fP to identify the problem area.
-(Use \fIkrb5\-send\-pr \-L\fP to see a list of categories.)
-.sp
-The krb5\-send\-pr template at your site should already be customized
-with your submitter\-id (running \fBinstall\-sid submitter\-id\fP to
-accomplish this is part of the installation procedures for
-krb5\-send\-pr). If this hasn\(aqt been done, see your system
-administrator for your submitter\-id, or request one from your support
-site by invoking \fBkrb5\-send\-pr \-\-request\-id\fP. If your site does not
-distinguish between different user sites, or if you are not affiliated
-with the support site, use \fBnet\fP for this field.
-.sp
-The more precise your problem description and the more complete your
-information, the faster your support team can solve your problems.
-.SH OPTIONS
-.INDENT 0.0
-.TP
-.B \fB\-f\fP \fIproblem\-report\fP
-.sp
-Specify a file \fIproblem\-report\fP which already contains a complete
-problem report. krb5\-send\-pr sends the contents of the file
-without invoking the editor. If the value for problem\-report is
-\fB\-\fP, then krb5\-send\-pr reads from standard input.
-.TP
-.B \fB\-s\fP \fIseverity\fP
-.sp
-Give the problem report the severity \fIseverity\fP.
-.TP
-.B \fB\-t\fP \fImail\-address\fP
-.sp
-Change mail address at the support site for problem reports. The
-default mail address is the address used for the default site.
-Use the site argument rather than this option in nearly all cases.
-.TP
-.B \fB\-c\fP \fIaddress\fP
-.sp
-Put \fIaddress\fP in the \fICc:\fP header of the message.
-.TP
-.B \fB\-P\fP
-.sp
-Print the form specified by the environment variable \fBPR_FORM\fP
-on standard output. If \fBPR_FORM\fP is not set, print the standard
-blank PR template. No mail is sent.
-.TP
-.B \fB\-L\fP
-.sp
-Print the list of available categories. No mail is sent.
-.TP
-.B \fB\-\-request\-id\fP
-.sp
-Sends mail to the default support site, or site if specified, with
-a request for your submitter\-id. If you are not affiliated with
-site, use a submitter\-id of \fBnet\fP.
-.TP
-.B \fB\-V\fP
-.sp
-Display the krb5\-send\-pr version number.
-.UNINDENT
-.IP Note
-.
-Use krb5\-send\-pr to submit problem reports rather than
-mailing them directly. Using both the template and
-krb5\-send\-pr itself will help ensure all necessary
-information will reach the support site.
-.RE
-.SH ENVIRONMENT
-.sp
-The environment variable \fBEDITOR\fP specifies the editor to invoke on
-the template. Default: \fBvi\fP.
-.sp
-If the environment variable \fBPR_FORM\fP is set, then its value is used
-as the file name of the template for your problem\-report editing
-session. You can use this to start with a partially completed form
-(for example, a form with the identification fields already
-completed).
-.SH HOW TO FILL OUT A PROBLEM REPORT
-.sp
-Problem reports have to be in a particular form so that a program can
-easily manage them. Please remember the following guidelines:
-.INDENT 0.0
-.IP \(bu 2
-.
-Describe only one problem with each problem report.
-.IP \(bu 2
-.
-For follow\-up mail, use the same subject line as the one in the
-automatic acknowledgent. It consists of category, PR number and the
-original synopsis line. This allows the support site to relate
-several mail messages to a particular PR and to record them
-automatically.
-.IP \(bu 2
-.
-Please try to be as accurate as possible in the subject and/or
-synopsis line.
-.IP \(bu 2
-.
-The subject and the synopsis line are not confidential. This is
-because open\-bugs lists are compiled from them. Avoid confidential
-information there.
-.UNINDENT
-.sp
-See the GNU Info file \fIkrb5\-send\-pr.info\fP or the document
-Reporting Problems With krb5\-send\-pr for detailed information on reporting problems.
-.SH HOW TO SUBMIT TEST CASES, CODE, ETC.
-.sp
-Submit small code samples with the PR. Contact the support site for
-instructions on submitting larger test cases and problematic source
-code.
-.SH FILES
-.INDENT 0.0
-.TP
-.B \fB/tmp/p$$\fP
-.sp
-copy of PR used in editing session
-.TP
-.B \fB/tmp/pf$$\fP
-.sp
-copy of empty PR form, for testing purposes
-.TP
-.B \fB/tmp/pbad$$\fP
-.sp
-file for rejected PRs
-.UNINDENT
-.SH EMACS USER INTERFACE
-.sp
-An Emacs user interface for krb5\-send\-pr with completion of field
-values is part of the krb5\-send\-pr distribution (invoked with \fBM\-x
-krb5\-send\-pr\fP). See the file krb5\-send\-pr.info or the ASCII file
-INSTALL in the top level directory of the distribution for
-configuration and installation information. The Emacs LISP template
-file is krb5\-send\-pr\-el.in and is installed as krb5\-send\-pr.el.
-.SH INSTALLATION AND CONFIGURATION
-.sp
-See krb5\-send\-pr.info or INSTALL for installation instructions.
-.SH SEE ALSO
-.sp
-Reporting Problems Using krb5\-send\-pr (also installed as the GNU Info
-file krb5\-send\-pr.info).
-.sp
-gnats(l), query\-pr(1), edit\-pr(1), gnats(8), queue\-pr(8), at\-pr(8),
-mkcat(8), mkdist(8).
-.SH AUTHORS
-.sp
-Jeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (Cygnus Support)
-.SH COPYING
-.sp
-Copyright (c) 1992, 1993 Free Software Foundation, Inc.
-.sp
-Permission is granted to make and distribute verbatim copies of this
-manual provided the copyright notice and this permission notice are
-preserved on all copies.
-.sp
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the
-entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
-.sp
-Permission is granted to copy and distribute translations of this
-manual into another language, under the above conditions for modified
-versions, except that this permission notice may be included in
-translations approved by the Free Software Foundation instead of in
-the original English.
-.SH AUTHOR
-MIT
-.SH COPYRIGHT
-2011, MIT
-.\" Generated by docutils manpage writer.
-.