Openbox

Wiki

Introduction
Screen Shots
Contributors
Platforms
Mailing Lists
Downloads
Bug Reports

Changelogs

Stable
Testing

Documentation

Whats new
Using Openbox

F.A.Q.
Openbox Features
Epist Features
Docker
The RC File
Menu File

Submitting a patch
What to do about a bug

What to do when you find a bug in Openbox:

  • Make sure you are using the latest version of whatever branch you are running, stable, testing, or development.
  • Find a way to reproduce the bug consistantly.
  • If Openbox is segfaulting, then please get it to create a core file, by running one of these in the shell before running Openbox:

    in bash
    ulimit unlimited
    in zsh
    unlimit coredumpsize

    Then when openbox segfaults, a core file will be generated in the current directory. Once you have the core file, run

    gdb /path/to/openbox core

    and at the prompt that gdb gives you, type this command to get a back-trace:

    bt

    Please include this output in your bug report.

  • If you want to fix the bug yourself and submit a patch, please do, it will be much appreciated.
  • Submit a bug report to the bug database with the version of Openbox that you are using when the bug appears, detailing what the bug is, including the back-trace if appropriate, and describing how to reproduce it. If we cannot reproduce it, we probably cannot fix it! So please give clear instructions.