dep/ACE_wrappers/PROBLEM-REPORT-FORM

   1 [Please use the PRF form below to submit bug reports, problem reports,
   2  etc., to the ACE developers and interested users.  Send to
   3  ace-bugs@cs.wustl.edu.  If you are using OCI, PrismTech, or
   4  Riverace's versions of ACE do not send bugs to this mailing list, but
   5  instead contact those companies for support.  Please also send your
   6  PRF as plain ASCII text, _not_ uuencoded or as an attachment.
   7
   8  We prefer that all bug reports be submitted through our bug tracking
   9  system.  See $ACE_ROOT/docs/usage-bugzilla.html for more information
  10  about how to do this.  If you are unsure as to whether your problem
  11  is a real bug or not then please submit your question to the mailing
  12  list using the following form.  Not using the problem report form
  13  will make it harder or impossible to identify the problem, and in
  14  many cases we will be unable to help at all.  Also please try to
  15  browse bugzilla and the ChangeLog files to find out if your problem
  16  has been solved in a more recent version of ACE.
  17
  18  To ensure that you see responses, please do one of the following:
  19
  20     1) Subscribe to the ace-bugs mail list, by sending email with
  21        contents "subscribe ace-bugs" to majordomo@cs.wustl.edu.
  22
  23     2) Or, monitor the comp.soft-sys.ace newsgroup for responses.
  24
  25  Replace/remove all the explanatory text in brackets before mailing.
  26
  27  Please send this form as ASCII text only.  Do _not_ send it as an
  28  attachment, or as tar'ed, compressed and/or uuencoded text.  And
  29  limit line lengths to less than 80 characters.
  30
  31  PLEASE make your Subject: line as descriptive as possible.
  32  Subjects like "ACE bug" or "bug report" are not helpful!
  33  Also, do _not_ include the word "help" in the Subject!]
  34
  35  When including your config.h and platform_macros.GNU files as requested
  36  below, only include the contents if you use the recommended method of
  37  including the platform-specific file in your file. If you use a link
  38  to the platform-specific file, simply state which one - DO NOT
  39  include an entire platform-specific configuration file in the form.
  40
  41 8<----------8<----------8<----------8<----------8<----------8<----------8<----
  42
  43 To: ace-bugs@cs.wustl.edu
  44 Subject: [area]: [synopsis]
  45
  46     ACE VERSION: 5.6.6
  47
  48     HOST MACHINE and OPERATING SYSTEM:
  49         If on Windows based OS's, which version of WINSOCK do you
  50         use?:
  51
  52     TARGET MACHINE and OPERATING SYSTEM, if different from HOST:
  53     COMPILER NAME AND VERSION (AND PATCHLEVEL):
  54
  55     THE $ACE_ROOT/ace/config.h FILE [if you use a link to a platform-
  56     specific file, simply state which one]:
  57
  58     THE $ACE_ROOT/include/makeinclude/platform_macros.GNU FILE [if you
  59     use a link to a platform-specific file, simply state which one
  60     (unless this isn't used in this case, e.g., with Microsoft Visual
  61     C++)]:
  62
  63     CONTENTS OF $ACE_ROOT/bin/MakeProjectCreator/config/default.features
  64     (used by MPC when you generate your own makefiles):
  65
  66     AREA/CLASS/EXAMPLE AFFECTED:
  67 [What example failed?  What module failed to compile?]
  68
  69     DOES THE PROBLEM AFFECT:
  70         COMPILATION?
  71         LINKING?
  72             On Unix systems, did you run make realclean first?
  73         EXECUTION?
  74         OTHER (please specify)?
  75 [Please indicate whether ACE, your application, or both are affected.]
  76
  77     SYNOPSIS:
  78 [Brief description of the problem]
  79
  80     DESCRIPTION:
  81 [Detailed description of problem.  Don't just say "<blah>
  82 doesn't work, here's a fix," explain what your program does
  83 to get to the <blah> state. ]
  84
  85     REPEAT BY:
  86 [What you did to get the error; include test program or session
  87 transcript if at all possible.  ]
  88
  89     SAMPLE FIX/WORKAROUND:
  90 [If available ]