Document:     report

Purpose:      reports a bug or a wish

Category:     UTILITY

File:         report.c

Author:       W. Zwitser

Keywords:


   SUBJECT=   name of a task (usually)
              A report may also be given about:
              - "general", if it concerns a general Gipsy item
              - a subroutine or document.


   SUMMARY=   a summary of the report ( max. 50 characters )             [quit]

   TYPE=      type of report                                              [BUG]
              BUG : if i.e. the program crashes or gives wrong results
              WISH: if it concerns i.e. a new feature

** FILE=      name of a prepared bug report

** EDIT=      Y: edit the prepared bug report                              [N]
              N: bypass the edit session
              (only if FILE=<name> was specified)


Use:          After the mentioned keywords the report is created in
              an edit session. The environment variable EDITOR is
              used to determine the editor. Just before the editor is
              started it gives the name of a file on /tmp which is used
              to create the report. This is not meant to change that name
              but to have the opportunity to abort with ^C.
              An error message about the editor generally means that
              you did not define the environment variable EDITOR.

Updates:      May  3, 1992: WZ  test version installed.
              May  4, 1992: WZ  version+date of subject added to report.
              Aug 24, 1993: JPT bitmap logic for fixes corrected.
              Nov 19, 1993: KGB bug in clearstr repaired.
              Apr 12, 1994: KGB address of GIPSY server now from server.mgr.
              May 12, 1997: KGB default address changed to new server.
              Jan 16, 1999: JPT modified for Linux 2.0.36
              Jun  7, 2000: JPT simplified; disabled bug listings
              Mar  9, 2001: JPT changed e-mail address
              Feb 11, 2004: JPT included subject in mail
              May  4, 2007: JPT included conditional code for Apple Mac.