Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SEND-PR(1)		    General Commands Manual		    SEND-PR(1)

NAME
       send-pr - submit	a GNATS	Problem	Report (PR) to a support site

SYNOPSIS
       send-pr
	      [	--batch	| -b ]
	      [	--database=database | -d database ]
	      [	--file=file | -f file ]
	      [	--print	| -p ]
	      [	--request-id ]
	      [	--severity=severity | -s severity ]
	      [	--help | -h ] [	--version | -V ]

DESCRIPTION
       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,	send-pr	 submits  the  completed form to the GNATS system at a
       central support site, either directly over the  network	to  the	 GNATS
       server  or by e-mail.  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.

       To  ensure  that	 a  PR	is  handled  promptly,	it should contain your
       (unique)	submitter-id and one of	the available categories  to  identify
       the problem area.

       The  more  precise  your	problem	description and	the more complete your
       information, the	faster your support team can solve your	problems.

       Note: use send-pr to submit problem reports rather  than	 mailing  them
       directly.   Using both the template and send-pr itself will help	ensure
       that all	necessary information will reach the support site.

OPTIONS
       -b, --batch
	      Suppresses printing of most of the messages that send-pr usually
	      prints while running.

       -d database, --database=database
	      Specifies	the database to	which the PR is	to be submitted; if no
	      database is specified, the local database	named default  is  as-
	      sumed.   This  option  overrides	the  database specified	in the
	      GNATSDB environment variable.

       -f file,	--file=file
	      Specifies	a file where a completed Problem Report	or a  PR  tem-
	      plate  exists.   send-pr	verifies that the contents of the file
	      constitute a valid PR and	asks the user whether the PR should be
	      submitted	directly or edited first.  If the PR text is  invalid,
	      the  user	 will be notified and given the	option to edit it.  If
	      file is set to `-', send-pr reads	from standard input.

       -p, --print
	      Displays the PR template for the specified database, or  if  the
	      -d  or  --database options are not specified, print the template
	      for the local database default.  No PR is	 submitted  when  this
	      option is	used.

       --request-id
	      Sends a request for a Submitter Id to the	support	site.

       -s severity, --severity=severity
	      Sets the initial value of	the Severity field to severity.

       --version, -V
	      Displays the version number of the program.

       --help, -h
	      Prints a brief usage message.

ENVIRONMENT
       The  environment	 variable EDITOR specifies the editor to invoke	on the
       template.
       default:	vi

HOW TO FILL OUT	A PROBLEM REPORT
       Problem reports have to be in a particular form so that a  program  can
       easily manage them.  Please remember the	following guidelines:

         describe only	one problem with each problem report.

         For  follow-up mail, use the same subject line as the	one in the au-
	  tomatic acknowledgent. It consists of	category, PR  number  and  the
	  original synopsis line.  This	allows the support site	to relate sev-
	  eral	mail  messages to a particular PR and to record	them automati-
	  cally.

         Please try to	be as accurate as possible in the subject and/or  syn-
	  opsis	line.

         The subject and the synopsis line are	not confidential.  This	is be-
	  cause	 open-bugs  lists  are compiled	from them.  Avoid confidential
	  information there.

       See the GNU Info	file gnats.info	or the document	Keeping	Track:	Manag-
       ing Messages With GNATS for detailed information	on reporting problems.

FILES
       /usr/local/etc/gnats/send-pr.conf  The send-pr configuration file
       $HOME/.send-pr.conf  User-specific send-pr configuration	file
       /tmp/p$$	    copy of PR used in editing session
       /tmp/pf$$    copy of empty PR form, for testing purposes
       /tmp/pbad$$  file for rejected PRs

EMACS USER INTERFACE
       An  Emacs user interface	for send-pr with completion of field values is
       part of the send-pr distribution	(invoked with M-x send-pr).   See  the
       file gnats.info in the doc subdirectory of the distribution for config-
       uration,	installation and usage information, or see Keeping Track: Man-
       aging Messages With GNATS

INSTALLATION AND CONFIGURATION
       See gnats.info or INSTALL for installation instructions.

SEE ALSO
       Keeping	Track: Managing	Messages With GNATS (also installed as the GNU
       Info file gnats.info)

       databases(5), dbconfig(5), delete-pr(8),	edit-pr(1) file-pr(8), gen-in-
       dex(8), gnats(7),  gnatsd(8),  mkcat(8),	 mkdb(8),  pr-edit(8),	query-
       pr(1), queue-pr(8), send-pr(1).

AUTHORS
       Jeffrey	Osier,	Brendan	 Kehoe,	 Jason Merrill,	Heinz G. Seidl (Cygnus
       Support), Yngve Svendsen.

COPYING
       Copyright (c) 1992, 1993, 2002, Free Software Foundation, Inc.

       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.

       Permission is granted to	copy and distribute modified versions of  this
       manual under the	conditions for verbatim	copying, provided that the en-
       tire resulting derived work is distributed under	the terms of a permis-
       sion notice identical to	this one.

       Permission is granted to	copy and distribute translations of this manu-
       al  into	another	language, under	the above conditions for modified ver-
       sions, except that this permission notice may be	included  in  transla-
       tions approved by the Free Software Foundation instead of in the	origi-
       nal English.

November 2002			     4.1.0			    SEND-PR(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=send-pr&sektion=1&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help