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/">git</a> repository located <a href=
  23           "http://repo.or.cz/w/wmaker-crm.git">here</a>. Git is very convenient for our purposes and you can find more
  24           information about it on the mentioned link. To obtain a full-fledged copy of the repository do this:<br /></p>
  25
  26           <p>git clone git://repo.or.cz/wmaker-crm.git<br /></p>
  27
  28           <h3>Submitting patches</h3>
  29
  30           <p>The source code in the above git repository follows the coding style of the linux kernel. Please take a look
  31           <a href="http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob_plain;f=Documentation/CodingStyle;hb=HEAD">
  32           here</a> and try to respect it when submitting patches. This is really important.</p>
  33
  34           <p>If you want to contribute patches to Window Maker and you are not familiar with git, please take a look at the git
  35           homepage above - it contains the kind of documentation you need to get started. You should also read the file contained
  36           in the Window Maker repository <a href=
  37           "http://repo.or.cz/w/wmaker-crm.git/blob/HEAD:/The-perfect-Window-Maker-patch.txt">The perfect Window Maker patch</a>
  38           which gives you further details about patches to Window Maker.</p>
  39
  40           <p>If your patch is really good and important, feel free to send it to the mailing list
  41           wmaker-dev@lists.windowmaker.org anyway in whatever form most suits you. But please consider the fact that patches sent
  42           in odd formats induce extra work for who applies them.</p>
  43
  44           <p>Last but not least, patches doing code cleanups are <strong>STRONGLY</strong> encouraged. Please go ahead! The risks
  45           of introducing regressions when doing cleanups exists, but if you also follow the practice of having a patch for each
  46           unrelated change you do, the eventuall regressions can be easily found and reverted.</p>
  47
  48           <h3>Git repository for dockapps</h3>
  49
  50           <p>There is also a <a href="http://repo.or.cz/w/dockapps.git">git repository</a> containing a few dockapps which
  51           apparently have no maintainers anymore. Patches for those dockapps (or to include more apps) can also be sent to
  52           wmaker-dev@lists.windowmaker.org.</p>
  53
  54           <h3>Some sources of information</h3>
  55
  56           <ul>
  57             <li>
  58               <p><a href="wings.php">The Window Maker WINGs library</a>.</p>
  59             </li>
  60
  61             <li>
  62               <p><a href="http://tronche.com/gui/x/xlib/">The Xlib Manual</a></p>
  63             </li>
  64           </ul><br />
  65           <br />
  66           <br />
  67         </td>
  68       </tr>
  69     </table>
  70
  71   <?php include("footer.php"); ?>
  72
  73 </body>
  74 </html>