.\" $OpenBSD: sendbug.1,v 1.9 2007/03/26 06:22:12 ray Exp $
.\"
.\" Written by Raymond Lai <ray@cyth.net>.
.\" Public domain.
.\"
.Dd March 22, 2007
.Dt SENDBUG 1
.Os
.Sh NAME
.Nm sendbug
.Nd report a bug in
.Ox
.Sh SYNOPSIS
.Nm
.Op Fl LPV
.Sh DESCRIPTION
.Nm
is used to send bug reports to
.Ox .
Some system information is filled out in a temporary file,
which is then opened by an editor.
See
.Ev EDITOR
below,
for details of which editor, if any, is invoked.
.Pp
Once the bug report is filled out,
it can be sent to the
.Ox
developers, re-edited, or aborted.
If aborted,
the report is not deleted and the pathname of the report is printed.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl L
Print the list of available categories.
.It Fl P
Generate and print the template with system information filled out.
.It Fl V
Print the version number.
.El
.Pp
The bugs database can be queried using the online bug tracking system
available at
.Pa http://www.openbsd.org/query-pr.html .
This allows users to search for PRs based on either their PR number
or content.
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev EDITOR , VISUAL
Specifies an editor to use.
If both
.Ev EDITOR
and
.Ev VISUAL
are set,
.Ev VISUAL
takes precedence.
If neither
.Ev EDITOR
nor
.Ev VISUAL
are set,
the default is
.Xr vi 1 .
.It Ev PR_FORM
Filename of PR form to use instead of using the built-in form.
Such a PR form can be partially pre-completed to make the
process faster.
.It Ev TMPDIR
Specifies a directory for temporary files to be created.
The default is
.Pa /tmp .
.El
.Sh FILES
.Bl -tag -width "/tmp/p.XXXXXXXXXX" -compact
.It Pa /tmp/p.XXXXXXXXXX
temporary PR report
.El
.Sh AUTHORS
.Nm
was written from scratch for the public domain by
.An Ray Lai Aq ray@cyth.net .