Bugzilla Guide

From NeoWiki

(Difference between revisions)

Jump to: navigation, search

Revision as of 15:57, 8 July 2005

Things to Do

New front page (bypassable for certain users, i.e. admins or long-time good bugfilers) or something like Bugzilla Helper
- Steps to take before filing a bug
  - Install latest patch [link]
  - Reboot
  - Fresh profile
  I.e., is it reproducible, esp. in up-to-date stock conditions
  - Attempt to reproduce in corresponding version of OOo/X11 if possible (?)
  - Search for duplicate (select NeoOffice/J from the Project menu)
- Scope of bugs, i.e. what's a Neo/J bug vs. an OOo bug/limitation vs. an Apple bug/limitation
- How to submit a useful bug report
Write "How to submit a useful bug report"
- One issue per bug report
- Include Patch level and OS version
  - About NeoOffice/J in the Neo/J menu; About This Mac in the Apple menu
- Provide crashlog for crashes and sample for hangs
  - How to get a crashlog to attach
    - Option A: is crashreporter enabled?
      - When "Unexpectedly quit" dialogue appears, select "Submit Report..."
      - Copy/paste "Crash Report:" section into new text file.
    - Option B: the hard way
      - Open Applications > Utilities > Console
      - Click on the "Logs" toolbar icon if the logs drawer isn't showing on the left.
      - Navigate through the list until you get to ~/Library/Logs > CrashReporter > soffice.bin.crash.log
      - Locate the appropriate log for the most recent/remembered crash. It should be the one at the bottom. Each individual crash log is separated by a line of asterisks from the next one above it; each one has a date at the top of it.
      - Copy from the "Host name" down to the end. Edit > Copy. Places a copy of the log onto the Clipboard
      - Open TextEdit and create a new plain-text file. Paste the crashlog. (Hmm, isn't there an "export" function in Console.app that will grab the last log entry?)
  - How to get a sample to attach
    - Open Applications > Utilities > Activity Monitor
    - Select Neo/J from list of running processes
    - Click "Inspect" button
    - Click "Sample" button (lower left corner of resulting window)
    - When sampling is completed, save resulting text file
- Attach (not paste) crashlog or sample
  - After bug is filed
  - Add attachments separately from comments (attachment refresh wipes comments, currently no warning); add warning on bug pages along the lines of the text in the OOo IssueZilla:
    Note: please commit any changes to this issue before creating a new attachment, or changes will be lost.
- Detailed steps to reproduce
- Attach screenshot if relevant
- Attach problematic document, if relevant, or email it to Patrick if sensitive
- Example of a pretty solid report: http://bugzilla.neooffice.org/bug.php?op=show&bugid=554
- Oscar provides two links to general "good bug-filing behavior" articles. We should be sure to include the highlights and perhaps link to them "for more details" or something:
  - How to Report Bugs Effectively
  - How To Ask Questions The Smart Way (a much longer piece also dealing with general "getting support/answers" issues)
~~Change Advanced Query to be the default search~~
~~Basic query is absolutely useless for finding duplicates!~~ I'm having better luck with basic query now
(select NeoOffice/J from the Project menu)

Retrieved from "https://neowiki.neooffice.org/index.php/Bugzilla_Guide"

Categories: NeoOffice/J | Contributing

-== Things to Do ==
+==Things to Do==
 # New front page (bypassable for certain users, i.e. admins or long-time good bugfilers) or something like [https://bugzilla.mozilla.org/enter_bug.cgi?product=Camino&format=guided Bugzilla Helper]
 #** Reboot
 #** Fresh profile
+#*:''I.e., is it reproducible, esp. in up-to-date stock conditions''
 #** Attempt to reproduce in corresponding version of OOo/X11 if possible (?)
 #** Search for duplicate (select '''NeoOffice/J''' from the '''Project''' menu)
 #* One issue per bug report
 #* Include Patch level and OS version
-#* How to get a crashlog to attach
+#** About NeoOffice/J in the Neo/J menu; About This Mac in the Apple menu
-#** Option A: is crashreporter enabled?  Copy/paste into new text file.
+#* Provide crashlog for crashes and sample for hangs
-#** Option B: the hard way
+#** How to get a crashlog to attach
-#***Open Applications > Utilities > Console
+#*** Option A: is crashreporter enabled?
-#***Click on the "Logs" toolbar icon if the logs drawer isn't showing on the left.
+#**** When "Unexpectedly quit" dialogue appears, select "Submit Report..."
-#***Navigate through the list until you get to ~/Library/Logs > CrashReporter > soffice.bin.crash.log
+#**** Copy/paste "Crash Report:" section into new text file.
-#***Locate the appropriate log for the most recent/remembered crash. It should be the one at the bottom. Each individual crash log is separated by a line of asterisks from the next one above it; each one has a date at the top of it.
+#*** Option B: the hard way
-#***Copy from the "Host name" down to the end. Edit > Copy. Places a copy of the log onto the Clipboard
+#****Open Applications > Utilities > Console
-#***Open TextEdit and create a new plain-text file.  Paste the crashlog.  (Hmm, isn't there an "export" function in Console.app that will grab the last log entry?)
+#****Click on the "Logs" toolbar icon if the logs drawer isn't showing on the left.
-#* Attach (not paste) crashlog
+#****Navigate through the list until you get to ~/Library/Logs > CrashReporter > soffice.bin.crash.log
+#****Locate the appropriate log for the most recent/remembered crash. It should be the one at the bottom. Each individual crash log is separated by a line of asterisks from the next one above it; each one has a date at the top of it.
+#****Copy from the "Host name" down to the end. Edit > Copy. Places a copy of the log onto the Clipboard
+#****Open TextEdit and create a new plain-text file.  Paste the crashlog.  (Hmm, isn't there an "export" function in Console.app that will grab the last log entry?)
+#** How to get a sample to attach
+#*** Open Applications > Utilities > Activity Monitor
+#*** Select Neo/J from list of running processes
+#*** Click "Inspect" button
+#*** Click "Sample" button (lower left corner of resulting window)
+#*** When sampling is completed, save resulting text file
+#* Attach (not paste) crashlog or sample
 #** After bug is filed
 #** Add attachments separately from comments (attachment refresh wipes comments, currently no warning); add warning on bug pages along the lines of the text in the OOo IssueZilla:
 #**:Note: please commit any changes to this issue <b>before</b> creating a new attachment, or changes will be lost.
+#* Detailed steps to reproduce
 #* Attach screenshot if relevant
 #* Attach problematic document, if relevant, or email it to Patrick if sensitive
 #** [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to Report Bugs Effectively]
 #** [http://www.catb.org/~esr/faqs/smart-questions.html How To Ask Questions The Smart Way] (a much longer piece also dealing with general "getting support/answers" issues)
-# Change Advanced Query to be the default search
+# <strike>Change Advanced Query to be the default search</strike>
-#:Basic query is absolutely useless for finding duplicates!
+#:<strike>Basic query is absolutely useless for finding duplicates!</strike> ''I'm having better luck with basic query now''
 #:(select '''NeoOffice/J''' from the '''Project''' menu)
 [[Category:NeoOffice/J]][[Category:Contributing]]

Bugzilla Guide

From NeoWiki

Revision as of 15:57, 8 July 2005

Things to Do

Views

Personal tools

Navigation

Search

Toolbox