Add Git specific files and configuration

* Setup usage.xml to be binary, as XMLWriter does not honor operating
  system's newline format.
* Setup various files to ignore (svn:ignore was not carried over)
* Add dummy files to prevent git from ignoring empty directories

Signed-off-by: Edward Z. Yang <edwardzyang@thewritingpot.com>

.gitattributes

@@ -0,0 +1 @@
+configdoc/usage.xml -crlf

.gitignore

@@ -0,0 +1,9 @@
+conf/
+library/HTMLPurifier/DefinitionCache/Serializer/*/
+library/standalone/
+library/HTMLPurifier.standalone.php
+*.phpt.diff
+*.phpt.exp
+*.phpt.log
+*.phpt.out
+*.phpt.php

FOCUS

@@ -0,0 +1,13 @@
+9 - Major security fixes
+
+[ Appendix A: Release focus IDs ]
+0 - N/A
+1 - Initial freshmeat announcement
+2 - Documentation
+3 - Code cleanup
+4 - Minor feature enhancements
+5 - Major feature enhancements
+6 - Minor bugfixes
+7 - Major bugfixes
+8 - Minor security fixes
+9 - Major security fixes

NEWS

@@ -9,6 +9,10 @@ NEWS ( CHANGELOG and HISTORY )                                     HTMLPurifier
     . Internal change
 ==========================
 
+3.2.0, unknown release date
+
+3.1.2, unknown release date
+
 3.1.1, released 2008-06-19
 # %URI.Munge now, by default, does not munge resources (for example, <img src="">)
   In order to enable this again, please set %URI.MungeResources to true. 

WHATSNEW

@@ -2,8 +2,7 @@ HTML Purifier 3.1.1 is a security and bugfix release. This release addresses
 two security vulnerabilities, both related to CSS, and one of which only
 applies to users using Shift_JIS as their output encoding. There is also
 a security improvement regarding the imagecrash attack. There is a backwards
-incompatible change with %URI.Munge, in which resources are no longer munged
+incompatible change in which resources are no longer munged
 by default; please enable using %URI.MungeResources. Besides this, there
 are numerous improvements to URI munging, esp. with the addition of
-%URI.MungeSecretKey, as well as an experimental implementation of 
-%HTML.SafeObject and %HTML.SafeEmbed. There are also some memory optimizations.
+%URI.MungeSecretKey, as well as an experimental %HTML.SafeObject and %HTML.SafeEmbed.

library/HTMLPurifier/DefinitionCache/README

@@ -0,0 +1 @@
+This is a dummy file to prevent Git from ignoring this empty directory.

maintenance/update-freshmeat.php

@@ -0,0 +1,154 @@
+#!/usr/bin/php
+<?php
+
+chdir(dirname(__FILE__));
+require_once 'common.php';
+assertCli();
+
+/**
+ * @file
+ * Updates Freshmeat's HTML Purifier with the latest information via XML RPC.
+ */
+
+class XmlRpc_Freshmeat
+{
+    
+    const URL = 'http://freshmeat.net/xmlrpc/';
+    
+    public $chatty = false;
+    
+    public $encodeOptions = array(
+        'encoding' => 'utf-8',
+    );
+    
+    /**
+     * This array defines shortcut method signatures for dealing with simple
+     * XML RPC methods. More complex ones (publish_release) should use the named parameter
+     * syntax.
+     */
+    public $signatures = array(
+        'login' => array('username', 'password'),
+        'fetch_branch_list' => array('project_name'),
+        'fetch_release'    => array('project_name', 'branch_name', 'version'),
+        'withdraw_release' => array('project_name', 'branch_name', 'version'),
+    );
+    
+    protected $sid = null;
+    
+    /**
+     * @param $username Username to login with
+     * @param $password Password to login with
+     */
+    public function __construct($username = null, $password = null) {
+        if ($username && $password) {
+            $this->login($username, $password);
+        }
+    }
+    
+    /**
+     * Performs a raw XML RPC call to self::URL
+     */
+    protected function call($method, $params) {
+        $request = xmlrpc_encode_request($method, $params, $this->encodeOptions);
+        $ch = curl_init();  
+        curl_setopt($ch, CURLOPT_URL, self::URL);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+        curl_setopt($ch, CURLOPT_TIMEOUT, 1);
+        curl_setopt($ch, CURLOPT_HTTPHEADER, array(
+            'Content-type: text/xml',
+            'Content-length: ' . strlen($request)
+        ));
+        curl_setopt($ch, CURLOPT_POSTFIELDS, $request);
+        $data = curl_exec($ch);      
+        if ($errno = curl_errno($ch)) {
+            throw new Exception("Curl error [$errno]: " . curl_error($ch));
+        } else {
+            curl_close($ch);
+            return xmlrpc_decode($data);
+        }
+    }
+    
+    /**
+     * Performs an XML RPC call to Freshmeat.
+     * @param $name Name of method to call, can be methodName or method_name
+     * @param $args Arguments of call, in form array('key1', 'val1', 'key2' ...)
+     */
+    public function __call($name, $args) {
+        $method = $this->camelToUnderscore($name);
+        $params = array();
+        if ($this->sid) $params['SID'] = $this->sid;
+        if (isset($this->signatures[$method])) {
+            for ($i = 0, $c = count($this->signatures[$method]); $i < $c; $i++) {
+                $params[$this->signatures[$method][$i]] = $args[$i];
+            }
+        } else {
+            for ($i = 0, $c = count($args); $i + 1 < $c; $i += 2) {
+                $params[$args[$i]] = $args[$i + 1];
+            }
+        }
+        $result = $this->call($method, $params);
+        switch ($method) {
+            case 'login':
+                $this->sid = $result['SID'];
+                break;
+            case 'logout':
+                $this->sid = null;
+                break;
+        }
+        if ($this->chatty) print_r($result);
+        return $result;
+    }
+    
+    /**
+     * Munge methodName to method_name
+     */
+    private function camelToUnderscore($name) {
+        $method = '';
+        for ($i = 0, $c = strlen($name); $i < $c; $i++) {
+            $v = $name[$i];
+            if (ctype_lower($v)) $method .= $v;
+            else $method .= '_' . strtolower($v);
+        }
+        return $method;
+    }
+    
+    /**
+     * Automatically logout at end of scope
+     */
+    public function __destruct() {
+        if ($this->sid) $this->logout();
+    }
+    
+}
+
+$rpc = new XmlRpc_Freshmeat($argv[1], $argv[2]);
+$rpc->chatty = true;
+
+$project = 'htmlpurifier';
+$branch  = 'Default';
+$version = file_get_contents('../VERSION');
+
+$result = $rpc->fetchRelease($project, $branch, $version);
+if (!isset($result['faultCode'])) {
+    echo "Freshmeat release already exists.\n";
+    exit(0);
+}
+
+$changes = strtr(file_get_contents('../WHATSNEW'), array("\r" => '', "\n" => ' '));
+$focus = (int) trim(file_get_contents('../FOCUS'));
+
+if (strlen($changes) > 600) {
+    echo "WHATSNEW entry is too long.\n";
+    exit(1);
+}
+
+$rpc->publishRelease(
+    'project_name',  $project,
+    'branch_name',   $branch,
+    'version',       $version,
+    'changes',       $changes,
+    'release_focus', $focus,
+    'url_tgz',       "http://htmlpurifier.org/releases/htmlpurifier-$version.tar.gz",
+    'url_zip',       "http://htmlpurifier.org/releases/htmlpurifier-$version.zip",
+    'url_changelog', "http://htmlpurifier.org/svnroot/htmlpurifier/tags/$version/NEWS"
+);

release1-update.php

@@ -104,5 +104,5 @@ file_put_contents('library/HTMLPurifier/Config.php', $config_c);
 
 passthru('php maintenance/flush.php');
 
-if ($is_dev) echo "Review changes, write something in WHATSNEW, and then SVN commit with log 'Release $version.'" . PHP_EOL;
+if ($is_dev) echo "Review changes, write something in WHATSNEW and FOCUS, and then SVN commit with log 'Release $version.'" . PHP_EOL;
 else echo "Numbers updated to dev, no other modifications necessary!";

tests/HTMLPurifier/DefinitionCache/SerializerTest/README

@@ -0,0 +1 @@
+This is a dummy file to prevent Git from ignoring this empty directory.

tests/tmp/README

@@ -0,0 +1 @@
+This is a dummy file to prevent Git from ignoring this empty directory.