- publishing free software manuals
The Org Mode 7 Reference Manual
by Carsten Dominik and others
Paperback (6"x9"), 282 pages
ISBN 9781906966089
RRP £9.95 ($14.95)

Sales of this book support the Org project! Get a printed copy>>>

1.4 Feedback

If you find problems with Org, or if you have questions, remarks, or ideas about it, please mail to the Org mailing list emacs-orgmode at gnu.org. If you are not a member of the mailing list, your mail will be passed to the list after a moderator has approved it.(1)

For bug reports, please first try to reproduce the bug with the latest version of Org available--if you are running an outdated version, it is quite possible that the bug has been fixed already. If the bug persists, prepare a report and provide as much information as possible, including the version information of Emacs (M-x emacs-version RET) and Org (M-x org-version RET), as well as the Org related setup in ‘.emacs’. The easiest way to do this is to use the command

M-x org-submit-bug-report

which will put all this information into an Emacs mail buffer so that you only need to add your description. If you re not sending the Email from within Emacs, please copy and paste the content into your Email program.

If an error occurs, a backtrace can be very useful (see below on how to create one). Often a small example file helps, along with clear information about:

  1. What exactly did you do?
  2. What did you expect to happen?
  3. What happened instead?

Thank you for helping to improve this program.

How to create a useful backtrace

If working with Org produces an error with a message you don't understand, you may have hit a bug. The best way to report this is by providing, in addition to what was mentioned above, a backtrace. This is information from the built-in debugger about where and how the error occurred. Here is how to produce a useful backtrace:

  1. Reload uncompiled versions of all Org-mode Lisp files. The backtrace contains much more information if it is produced with uncompiled code. To do this, use
    C-u M-x org-reload RET
    
    or select Org -> Refresh/Reload -> Reload Org uncompiled from the menu.
  2. Go to the Options menu and select Enter Debugger on Error (XEmacs has this option in the Troubleshooting sub-menu).
  3. Do whatever you have to do to hit the error. Don't forget to document the steps you take.
  4. When you hit the error, a ‘*Backtrace*’ buffer will appear on the screen. Save this buffer to a file (for example using C-x C-w) and attach it to your bug report.
ISBN 9781906966089The Org Mode 7 Reference ManualSee the print edition