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