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