Skip to content
davexunit edited this page Aug 7, 2012 · 5 revisions

Please follow the following guidelines when contributing to this project.

Coding Standards

Tabs

Please use tab characters, not spaces. We use the 1TBS (one true brace style) format. Please configure your text editor accordingly

Alternatively, astyle can be used to format the code after your write it to make sure that is in the correct format before you commit.

astyle --style=1tbs --indent=tab --indent-switches

Functions

Use underscores in between words in a function

Good:

void do_stuff();

Bad:

void doStuff();

Pointers

Good:

const char *foo;

Bad:

const char* foo;

Pull Requests

Write me!

Commit Messages

Commit messages should be short, sweet, and to the point:

Add basic window manager detection.

Please, nothing like:

  • Fixed bug
  • A bunch of changes

Each commit should contain a small number of changes. Please, no massive commits that are difficult to review.

Using Xnest

Xnest is a handy application that allows one to run an X session WITHIN another X session. This makes Xnest a handy tool for testing a window manager without having to trash your current desktop environment.

Xnest can be started like so:

Xnest :1 &

Start up a window manager on the specified X display (in our case :1):

twm -display :1

A lot of window managers don't let one specify the display to use, so instead twm is used as a bootstrap.

Open an xterm and kill twm:

pkill twm

Now start WizardWM (or whatever window manager you want)

./wizwm

Clone this wiki locally