[Cherbot-commit] SF.net SVN: cherbot: [22] trunk/src/doc/subversion.xhtml
Status: Alpha
Brought to you by:
christianhujer
|
From: <chr...@us...> - 2006-10-29 00:01:22
|
Revision: 22
http://svn.sourceforge.net/cherbot/?rev=22&view=rev
Author: christianhujer
Date: 2006-10-28 17:01:08 -0700 (Sat, 28 Oct 2006)
Log Message:
-----------
Added Subversion documentation.
Added Paths:
-----------
trunk/src/doc/subversion.xhtml
Added: trunk/src/doc/subversion.xhtml
===================================================================
--- trunk/src/doc/subversion.xhtml (rev 0)
+++ trunk/src/doc/subversion.xhtml 2006-10-29 00:01:08 UTC (rev 22)
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Id: releasePlan.xhtml,v 1.6 2006/03/29 22:21:14 christianhujer Exp $ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="de">
+ <head>
+ <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8" />
+ <meta name="Date" content="$Date: 2006-09-19 01:16:38 +0200 (Di, 19 Sep 2006) $" />
+ <title>CherBot Subversion Developer Access</title>
+ </head>
+ <body>
+ <h2>Checking out a normal working copy</h2>
+ <p>
+ To checkout a normal working copy of the latest development, checkout the trunk.
+ This is what's called HEAD or MAIN/LATEST in other version control systems.
+ </p>
+ <p><code>svn co https://svn.sourceforge.net/svnroot/cherbot/trunk cherbot</code></p>
+ <h2>Rules</h2>
+ <p>
+ Current rules are this:
+ </p>
+ <ul>
+ <li>
+ All files need a mime type.
+ For normal source code, use <code>text/plain</code>.
+ Use this command to set the mime type:
+ <br />
+ <code>svn propset svn:mime-type text/plain <var>filename</var></code>
+ <br />
+ <em>Note:</em> A hook verifies that the mime type is set.
+ </li>
+ <li>
+ All files with a text based mime type need a line ending setting.
+ CherBot convention is to always use <code>LF</code>.
+ Use this command to set the line ending style:
+ <br />
+ <code>svn propset svn:eol-style LF <var>filename</var></code>
+ <br />
+ <em>Note:</em> A hook verifies that the eol style for files with mime type text/* is set.
+ </li>
+ <li>
+ All XHTML files of the documentation (<code>src/doc/**/*.xhtml</code>) need a meta element for the edit date:
+ <br />
+ <code><![CDATA[<meta name="Date" content="$]]><![CDATA[Date$" />]]></code>
+ <br />
+ Also, they need their keyword substitution set to <code>Date</code>.
+ Use <code>svn propset svn:keywords Date <var>filename</var></code> to set the keyword substitution.
+ <br />
+ <em>Note:</em> Because we cannot install custom hooks on SF, this is <em>not</em> checked with a hook.
+ </li>
+ </ul>
+ <h2>Releases</h2>
+ <p>
+ Releases are created in the following way:
+ </p>
+ <ol>
+ <li>
+ A branch with the new release name is created.
+ Usually the branch will increase the minor revision and use it as its name.
+ Example: <code>svn copy trunk branches/0.8</code>.
+ The policy for branches is that they aren't completely frozen, but only changes required for release and bug fixing are allowed.
+ </li>
+ <li>
+ The branch is braught into releasable state.
+ This usually should be zero effort, yet consider this a separate step.
+ </li>
+ <li>
+ The release is published.
+ As a part of the release publishing, a tag with the new release name and patch level is created.
+ Example: <code>svn copy branches/0.8 tags/0.8.0</code>.
+ The policy for tags is that they are completely frozen, tags must never ever be changed.
+ </li>
+ </ol>
+ <h2>Checking out a released version</h2>
+ <p>
+ To checkout a released version, use <code>svn co https://svn.sourceforge.net/svnroot/cherbot/tags/<var>version</var> cherbot</code> with
+ <var>version</var> being the release name.
+ To checkout, for example, version <samp>0.8.0</samp>, use <samp>svn co https://svn.sourceforge.net/svnroot/cherbot/tags/0.8.0 cherbot</samp>.
+ </p>
+ <h2>See Also</h2>
+ <ul>
+ <li><a href="http://sourceforge.net/svn/?group_id=180828">SourceForge.net: Subversion for CherBot</a></li>
+ </ul>
+ </body>
+</html>
Property changes on: trunk/src/doc/subversion.xhtml
___________________________________________________________________
Name: svn:mime-type
+ text/xml
Name: svn:eol-style
+ LF
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|