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:

       o  describe only	one problem with each problem report.

       o  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.

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

       o  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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | HOW TO FILL OUT A PROBLEM REPORT | FILES | EMACS USER INTERFACE | INSTALLATION AND CONFIGURATION | SEE ALSO | AUTHORS | COPYING

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

home | help