NAME

       gawkbug - report a bug in gawk

SYNOPSIS

       gawkbug [--version] [--help] [email-address]

DESCRIPTION

       gawkbug is a shell script to help the user compose and mail bug reports concerning gawk in
       a standard format.  gawkbug invokes the  editor  specified  by  the  environment  variable
       EDITOR  on  a  temporary  copy of the bug report format outline. The user must fill in the
       appropriate fields and exit the editor.  gawkbug then mails the completed report  to  bug-
       gawk@gnu.org,  or  email-address.  If the report cannot be mailed, it is saved in the file
       dead.gawkbug in the invoking user's home directory.

       The bug report format outline consists of several sections.  The  first  section  provides
       information  about  the  machine,  operating system, the gawk version, and the compilation
       environment.  The second section should be filled in with a description of the  bug.   The
       third  section  should  be a description of how to reproduce the bug.  The optional fourth
       section is for a proposed fix.  Fixes are encouraged.

ENVIRONMENT

       gawkbug will utilize the following environment variables if they exist:

       EDITOR Specifies the preferred editor. If EDITOR is not set, gawkbug attempts to locate  a
              number  of  alternative  editors, including vim, and if it must, emacs.  If gawkbug
              cannot locate any of the alternative editors, it attempts to execute vi.

       HOME   Directory in which the failed bug report is saved if the mail fails.

       TMPDIR Directory in which to create temporary files and directories.

SEE ALSO

       gawk(1)

AUTHORS

       Brian Fox, Free Software Foundation
       bfox@gnu.org

       Chet Ramey, Case Western Reserve University
       chet@po.cwru.edu

       Arnold Robbins
       bug-gawk@gnu.org