Effective problem reports are the most likely to be fixed. These guidelines explain how to write such reports.

Principles

Preliminaries

  1. Reproduce your problem using a recent build of the software, to see whether it has already been fixed.
  2. Search Bugzilla/Geant4, to see whether your problem has already been reported.

Reporting a New Problem

If you have reproduced the problem in a recent build and no-one else appears to have reported it, then:

  1. Choose "Enter a new problem"
  2. Select the product in which you've found the problem
  3. Fill out the form. Here is some help understanding it:

Component: In which sub-part of the software does it exist?
This field is required. Click the word "Component" to see a description of each component. If none seems appropriate, look for a "General" component.

OS: On which operating system (OS) did you find it? (e.g. Linux, Windows XP, Mac OS X.)
If you know the problem happens on more than one type of operating system, choose All. If your OS isn't listed, choose Other.

Summary: How would you describe the problem, in approximately 60 or fewer characters?
A good summary should quickly and uniquely identify a problem report. It should explain the problem, not your suggested solution.

Description: The details of your problem report, including:

Overview: More detailed restatement of summary.

Drag-selecting any page crashes Mac builds in the NSGetFactory function.

Steps to Reproduce: Minimized, easy-to-follow steps that will trigger the problem. Include any special setup steps.

1) View any web page. (I used the default sample page, 
resource:/res/samples/test0.html)

2) Drag-select the page. (Specifically, while holding down 
the mouse button, drag the mouse pointer downwards from any 
point in the browser's content region to the bottom of the 
browser's content region.)

Actual Results: What the application did after performing the above steps.

The application crashed.

Expected Results: What the application should have done, were the problem not present.

The window should scroll downwards. Scrolled content should be selected. 
(Or, at least, the application should not crash.)

Build Date & Hardware: Date and hardware of the build in which you first encountered the problem.

Build 2006-08-10 on Mac OS 10.4.3

Additional Builds and Platforms: Whether or not the problem takes place on other platforms (or browsers, if applicable).

Doesn't Occur On Build 2006-08-10 on Windows XP Home (Service Pack 2)

Additional Information: Any other useful information.

For crashing problems:

  • Windows: Note the type of the crash, and the module that the application crashed in (e.g. access violation in apprunner.exe).
  • Mac OS X: Attach the "Crash Reporter" log that appears upon crash. Only include the section directly below the crashing thread, usually titled "Thread 0 Crashed". Please do not paste the entire log!

Double-check your report for errors and omissions, then press "Commit". Your problem report will now be in the Bugzilla/Geant4 database.