window-maker.github.io/dev/index.html

---
layout: default
title: Development
---

          <p>Here are some pieces of information regarding development in Window Maker.</p>

          <h3>Source code versioning system</h3>

          <p>The source code for Window Maker is contained in a <a href="http://git-scm.com/" target="_blank">git</a> repository located <a href=
          "http://repo.or.cz/w/wmaker-crm.git" target="_blank">here</a>. To obtain a full-fledged copy of the repository do this:<br /></p>

          <p>git clone git://repo.or.cz/wmaker-crm.git<br /></p>

	  <p> There are two main branches in the repository, called 'master' and 'next'. The purpose of the 'next' branch is to add
	  and extra layer of testing before the patches hit the 'master' branch. It is rebased when needed. The 'master' branch
	  should ideally never be rebased -- if it is, run to the nearest anti-nuclear bunker.</p>

          <h3>Submitting patches</h3>

          <p>The Window Maker source code follows the
          <a href="http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob_plain;f=Documentation/CodingStyle;hb=HEAD" target="_blank">
          coding style of the linux kernel</a>. Respect it when submitting patches.</p>

          <p>If you are not familiar with git, take a look at the <a href="http://git-scm.com/" target="_blank">git homepage</a>
          -- it contains the kind of documentation you need to get started. You should also read the file contained
          in the Window Maker repository <a href=
          "http://repo.or.cz/w/wmaker-crm.git/blob/HEAD:/The-perfect-Window-Maker-patch.txt" target="_blank">The perfect Window Maker patch</a>
          which gives you further details about patches to Window Maker.</p>

          <p>Patches not submitted according to the above guidelines will not be accepted.</p>

          <p>Last but not least, patches doing code cleanups are <strong>STRONGLY</strong> encouraged.</p>

          <h3>Git repository for dockapps</h3>

          <p>There is also a <a href="http://repo.or.cz/w/dockapps.git" target="_blank">git repository</a> containing a few dockapps which
          apparently have no maintainers anymore. Patches for those dockapps (or to include more apps) can also be sent to
          wmaker-dev@lists.windowmaker.org.</p>

          <h3>Some sources of information</h3>

          <ul>
            <li>
              <p><a href="{{ site.baseurl }}/docs/wings.html">The Window Maker WINGs library</a>.</p>
            </li>

            <li>
              <p><a href="http://tronche.com/gui/x/xlib/" target="_blank">The Xlib Manual</a></p>
            </li>
          </ul><br />
          <br />
          <br />