Annotation of src/usr.bin/sendbug/sendbug.1, Revision 1.10
1.10 ! jmc 1: .\" $OpenBSD: sendbug.1,v 1.9 2007/03/26 06:22:12 ray Exp $
1.1 ray 2: .\"
3: .\" Written by Raymond Lai <ray@cyth.net>.
4: .\" Public domain.
5: .\"
6: .Dd March 22, 2007
7: .Dt SENDBUG 1
8: .Os
9: .Sh NAME
10: .Nm sendbug
11: .Nd report a bug in
12: .Ox
13: .Sh SYNOPSIS
14: .Nm
1.5 ray 15: .Op Fl LPV
1.1 ray 16: .Sh DESCRIPTION
17: .Nm
1.10 ! jmc 18: is used to submit problem reports (PRs) to the
! 19: .Ox
! 20: bugs database.
1.1 ray 21: Some system information is filled out in a temporary file,
1.10 ! jmc 22: which is then opened by a text editor.
1.1 ray 23: .Pp
24: Once the bug report is filled out,
1.6 ray 25: it can be sent to the
1.1 ray 26: .Ox
1.6 ray 27: developers, re-edited, or aborted.
28: If aborted,
29: the report is not deleted and the pathname of the report is printed.
1.10 ! jmc 30: .Pp
! 31: The content of the PR is not confidential; it is sent out to a public
! 32: mailing list.
! 33: Sensitive, security-related issues should be sent via email to
! 34: .Aq security@OpenBSD.org .
1.2 deraadt 35: .Pp
36: The options are as follows:
37: .Bl -tag -width Ds
38: .It Fl L
1.6 ray 39: Print the list of available categories.
1.2 deraadt 40: .It Fl P
1.6 ray 41: Generate and print the template with system information filled out.
1.2 deraadt 42: .It Fl V
1.6 ray 43: Print the version number.
1.2 deraadt 44: .El
45: .Pp
46: The bugs database can be queried using the online bug tracking system
47: available at
48: .Pa http://www.openbsd.org/query-pr.html .
49: This allows users to search for PRs based on either their PR number
50: or content.
1.1 ray 51: .Sh ENVIRONMENT
52: .Bl -tag -width Ds
1.9 ray 53: .It Ev EDITOR , VISUAL
1.1 ray 54: Specifies an editor to use.
1.9 ray 55: If both
1.1 ray 56: .Ev EDITOR
1.9 ray 57: and
58: .Ev VISUAL
59: are set,
60: .Ev VISUAL
61: takes precedence.
62: If neither
63: .Ev EDITOR
64: nor
65: .Ev VISUAL
66: are set,
1.1 ray 67: the default is
68: .Xr vi 1 .
1.4 ray 69: .It Ev PR_FORM
70: Filename of PR form to use instead of using the built-in form.
71: Such a PR form can be partially pre-completed to make the
72: process faster.
1.1 ray 73: .It Ev TMPDIR
74: Specifies a directory for temporary files to be created.
75: The default is
76: .Pa /tmp .
77: .El
1.7 ray 78: .Sh FILES
79: .Bl -tag -width "/tmp/p.XXXXXXXXXX" -compact
80: .It Pa /tmp/p.XXXXXXXXXX
81: temporary PR report
1.8 jmc 82: .El
1.1 ray 83: .Sh AUTHORS
84: .Nm
85: was written from scratch for the public domain by
86: .An Ray Lai Aq ray@cyth.net .