.\" -*- nroff -*-.\" ---------------------------------------------------------------------------.\"    man page for send-pr (by Heinz G. Seidl, hgs@cygnus.com).\"    updated Feb 1993 for GNATS 3.00 by Jeffrey Osier, jeffrey@cygnus.com.\".\"    This file is part of the Problem Report Management System (GNATS).\"    Copyright 1992 Cygnus Support.\".\"    This program is free software; you can redistribute it and/or.\"    modify it under the terms of the GNU General Public.\"    License as published by the Free Software Foundation; either.\"    version 2 of the License, or (at your option) any later version..\".\"    This program is distributed in the hope that it will be useful,.\"    but WITHOUT ANY WARRANTY; without even the implied warranty of.\"    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU.\"    General Public License for more details..\".\"    You should have received a copy of the GNU Library General Public.\"    License along with this program; if not, write to the Free.\"    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.\".\" ---------------------------------------------------------------------------.nh.TH SEND-PR 1 xVERSIONx "February 1993".SH NAMEipsec send-pr \- send problem report (PR) to a central support site.SH SYNOPSIS.B ipsec send-pr[.I site][.B \-f.I problem-report][.B \-t.I mail-address].br.in +0.8i[.B \-P][.B \-L][.B \-s.I severity][.B \-c.I address].br[.B \-\-request-id][.B \-V].SH DESCRIPTION.B ipsec send-pris a tool used to submit .I problem reports .\" SITE ADMINISTRATORS - change this if you use a local default(PRs) to a central support site.  In most cases the correct .I sitewill be the default.  This argument indicates the support site whichis responsible for the category of problem involved.  Some sites mayuse a local address as a default.  .I sitevalues are defined by using the .BR aliases (5)..LP.B ipsec send-prinvokes an editor on a problem report template (after trying to fillin some fields with reasonable default values).  When you exit theeditor,.B ipsec send-pr sends the completed form to the.I Problem Report Management System(\fBGNATS\fR) at a central support site.  At the support site, the PRis assigned a unique number and is stored in the \fBGNATS\fR databaseaccording to its category and submitter-id.  \fBGNATS\fR automaticallyreplies with an acknowledgement, citing the category and the PRnumber..LPTo ensure that a PR is handled promptly, it should contain your (unique)\fIsubmitter-id\fR and one of the available \fIcategories\fR to identify theproblem area.  (Use.B `ipsec send-pr -L'to see a list of categories.).LPThe.B ipsec send-prtemplate at your site should already be customized with yoursubmitter-id (running `\|\fBinstall-sid\fP \fIsubmitter-id\fP\|' toaccomplish this is part of the installation procedures for.BR ipsec send-pr ).If this hasn't been done, see your system administrator for yoursubmitter-id, or request one from your support site by invoking.B `ipsec send-pr \-\-request\-id'.If your site does not distinguish between different user sites, or ifyou are not affiliated with the support site, use.B `net'for this field..LPThe more precise your problem description and the more complete yourinformation, the faster your support team can solve your problems..SH OPTIONS.TP.BI \-f " problem-report"specify a file (\fIproblem-report\fR) which already contains acomplete problem report..B ipsec send-prsends the contents of the file without invoking the editor.  If the value for .I problem-reportis.BR `\|\-\|' ,then.B ipsec send-prreads from standard input..TP.BI \-s " severity"Give the problem report the severity.IR severity ..TP.BI \-t " mail-address"Change mail address at the support site for problem reports.  Thedefault .I mail-addressis the address used for the default .IR site .  Use the.I siteargument rather than this option in nearly all cases..TP.BI \-c " address"Put.I addressin the .B Cc:header of the message..TP.B \-Pprint the form specified by the environment variable .B PR_FORM on standard output.  If .B PR_FORMis not set, print the standard blank PR template.  No mail is sent..TP.B -Lprint the list of available categories.  No mail is sent..TP.B \-\-request\-idsends mail to the default support site, or.I siteif specified, with a request for your .IR submitter-id . If you arenot affiliated with .IR site ,use a.I submitter-idof.BR net \|'..TP.B \-VDisplay the .B ipsec send-prversion number..LPNote: use.B ipsec send-prto submit problem reports rather than mailing them directly.  Usingboth the template and.B ipsec send-pritself will help ensure all necessary information will reach thesupport site..SH ENVIRONMENTThe environment variable .B EDITORspecifies the editor to invoke on the template..brdefault:.B vi.spIf the environment variable .B PR_FORMis set, then its value is used as the file name of the template foryour problem-report editing session.  You can use this to start with apartially completed form (for example, a form with the identificationfields already completed)..SH "HOW TO FILL OUT A PROBLEM REPORT"Problem reports have to be in a particular form so that a program caneasily manage them.  Please remember the following guidelines:.IP \(bu 3m describe only .B one problemwith each problem report..IP \(bu 3mFor follow-up mail, use the same subject line as the one in the automaticacknowledgent. It consists of category, PR number and the original synopsisline.  This allows the support site to relate several mail messages to aparticular PR and to record them automatically..IP \(bu 3m Please try to be as accurate as possible in the subject and/or synopsis line..IP \(bu 3m The subject and the synopsis line are not confidential.  This isbecause open-bugs lists are compiled from them.  Avoid confidentialinformation there..LPSee the GNU .B Info file.B send-pr.infoor the document \fIReporting Problems With send-pr\fR\ for detailedinformation on reporting problems.SH "HOW TO SUBMIT TEST CASES, CODE, ETC."Submit small code samples with the PR.  Contact the support site forinstructions on submitting larger test cases and problematic sourcecode..SH FILES.ta \w'/tmp/pbad$$  'u/tmp/p$$	copy of PR used in editing session.br/tmp/pf$$	copy of empty PR form, for testing purposes.br/tmp/pbad$$	file for rejected PRs.br @IPSEC_DIR@/send-pr.conf	script to customize send-pr..SH EMACS USER INTERFACEAn Emacs user interface for .B send-prwith completion of field values is part of the .B send-prdistribution (invoked with.BR "M-x send-pr" ).See the file.B send-pr.infoor the ASCII file.B INSTALLin the top level directory of the distribution for configuration andinstallation information.  The Emacs LISP template file is .B send-pr-el.inand is installed as.BR send-pr.el ..SH INSTALLATION AND CONFIGURATIONSee .B send-pr.infoor.B INSTALLfor installation instructions..SH SEE ALSO.I Reporting Problems Using send-pr(also installed as the GNU Info file.BR send-pr.info )..LP.BR gnats (l),.BR query-pr (1),.BR edit-pr (1),.BR gnats (8),.BR queue-pr (8),.BR at-pr (8),.BR mkcat (8),.BR mkdist (8)..SH AUTHORSJeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (CygnusSupport).SH COPYINGCopyright (c) 1992, 1993 Free Software Foundation, Inc..PPPermission is granted to make and distribute verbatim copies ofthis manual provided the copyright notice and this permission noticeare preserved on all copies..PPPermission is granted to copy and distribute modified versions of thismanual under the conditions for verbatim copying, provided that theentire resulting derived work is distributed under the terms of apermission notice identical to this one..PPPermission is granted to copy and distribute translations of thismanual into another language, under the above conditions for modifiedversions, except that this permission notice may be included intranslations approved by the Free Software Foundation instead of inthe original English.