dev.php

   1 <html xmlns="http://www.w3.org/1999/xhtml">
   2 <head>
   3   <meta name="generator" content="HTML Tidy for Linux (vers 25 March 2009), see www.w3.org" />
   4
   5   <title>Window Maker: Development</title>
   6   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
   7   <link href="title.css" rel="stylesheet" type="text/css" />
   8 </head>
   9
  10 <body>
  11   <?php include("dock.php");  ?>
  12   <?php include("header.php"); ?>
  13
  14   <div>
  15     <table class="inner" border="0" cellpadding="1" cellspacing="1">
  16       <tr>
  17         <td content="content" colspan="2" valign="top">
  18           <p>Here are some pieces of information regarding development in Window Maker.</p>
  19
  20           <h3>Source code versioning system</h3>
  21
  22           <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=
  23           "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>
  24
  25           <p>git clone git://repo.or.cz/wmaker-crm.git<br /></p>
  26
  27           <p> There are two main branches in the repository, called 'master' and 'next'. The purpose of the 'next' branch is to add
  28           and extra layer of testing before the patches hit the 'master' branch. It is rebased when needed. The 'master' branch
  29           should ideally never be rebased -- if it is, run to the nearest anti-nuclear bunker.</p>
  30
  31           <h3>Submitting patches</h3>
  32
  33           <p>The Window Maker source code follows the
  34           <a href="http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob_plain;f=Documentation/CodingStyle;hb=HEAD" target="_blank">
  35           coding style of the linux kernel</a>. Respect it when submitting patches.</p>
  36
  37           <p>If you are not familiar with git, take a look at the <a href="http://git-scm.com/" target="_blank">git homepage</a>
  38           -- it contains the kind of documentation you need to get started. You should also read the file contained
  39           in the Window Maker repository <a href=
  40           "http://repo.or.cz/w/wmaker-crm.git/blob/HEAD:/The-perfect-Window-Maker-patch.txt" target="_blank">The perfect Window Maker patch</a>
  41           which gives you further details about patches to Window Maker.</p>
  42
  43           <p>If your patch is really good and important, feel free to send it to the mailing list at
  44           wmaker-dev@lists.windowmaker.org anyway in whatever form most suits you. But please consider the fact that patches sent
  45           in odd formats induce extra work for who applies them.</p>
  46
  47           <p>Last but not least, patches doing code cleanups are <strong>STRONGLY</strong> encouraged.</p>
  48
  49           <h3>Git repository for dockapps</h3>
  50
  51           <p>There is also a <a href="http://repo.or.cz/w/dockapps.git" target="_blank">git repository</a> containing a few dockapps which
  52           apparently have no maintainers anymore. Patches for those dockapps (or to include more apps) can also be sent to
  53           wmaker-dev@lists.windowmaker.org.</p>
  54
  55           <h3>Some sources of information</h3>
  56
  57           <ul>
  58             <li>
  59               <p><a href="wings.php">The Window Maker WINGs library</a>.</p>
  60             </li>
  61
  62             <li>
  63               <p><a href="http://tronche.com/gui/x/xlib/" target="_blank">The Xlib Manual</a></p>
  64             </li>
  65           </ul><br />
  66           <br />
  67           <br />
  68         </td>
  69       </tr>
  70     </table>
  71
  72   <?php include("footer.php"); ?>
  73
  74 </body>
  75 </html>