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
  12 <?php
  13         include("header.php");
  14         include("dock.php");
  15 ?>
  16
  17   <div id="inhalt">
  18     <table width="880" border="0" cellpadding="1" cellspacing="1">
  19       <tr>
  20         <td content="content" colspan="2" valign="top">
  21           <p>Here are some pieces of information regarding development in Window Maker.</p>
  22
  23           <h3>Source code versioning system</h3>
  24
  25           <p>The source code for Window Maker is contained in a <a href="http://git-scm.com/">git</a> repository located <a href=
  26           "http://repo.or.cz/w/wmaker-crm.git">here</a>. Git is very convenient for our purposes and you can find more
  27           information about it on the mentioned link. To obtain a full-fledged copy of the repository do this:<br /></p>
  28
  29           <p>git clone git://repo.or.cz/wmaker-crm.git<br /></p>
  30
  31           <h3>Submitting patches</h3>
  32
  33           <p>The source code in the above git repository follows the coding style of the linux kernel. Please take a look
  34           <a href="http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob_plain;f=Documentation/CodingStyle;hb=HEAD">
  35           here</a> and try to respect it when submitting patches. This is really important.</p>
  36
  37           <p>If you want to contribute patches to Window Maker and you are not familiar with git, please take a look at the git
  38           homepage above - 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">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
  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. Please go ahead! The risks
  48           of introducing regressions when doing cleanups exists, but if you also follow the practice of having a patch for each
  49           unrelated change you do, the eventuall regressions can be easily found and reverted.</p>
  50
  51           <h3>WINGs</h3>
  52
  53           <p>Window Maker uses the WINGs library for its widgets. For more information
  54           click <a href="wings.php">here</a>.</p>
  55         <br><br></br></br>
  56         </td>
  57       </tr>
  58     </table>
  59   </div>
  60 </body>
  61 </html>