incubator-ooo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r820613 - in /websites/staging/openofficeorg/trunk/content: ./ openofficeorg/svn-basics.html
Date Thu, 07 Jun 2012 04:07:59 GMT
Author: buildbot
Date: Thu Jun  7 04:07:58 2012
New Revision: 820613

Staging update by buildbot for openofficeorg

    websites/staging/openofficeorg/trunk/content/   (props changed)

Propchange: websites/staging/openofficeorg/trunk/content/
--- cms:source-revision (original)
+++ cms:source-revision Thu Jun  7 04:07:58 2012
@@ -1 +1 @@

Modified: websites/staging/openofficeorg/trunk/content/openofficeorg/svn-basics.html
--- websites/staging/openofficeorg/trunk/content/openofficeorg/svn-basics.html (original)
+++ websites/staging/openofficeorg/trunk/content/openofficeorg/svn-basics.html Thu Jun  7
04:07:58 2012
@@ -110,10 +110,10 @@
 <li><a href="#creating_and_submitting_patches">Creating and Submitting Patches</a></li>
 <li><a href="#further_information">Further Information</a></li>
-<h2 id="wzxhzdk21wzxhzdk22overview"><a id="overview"></a>Overview</h2>
+<h2 id="wzxhzdk25wzxhzdk26overview"><a id="overview"></a>Overview</h2>
 <p>You begin using Subversion by copying a directory from a remote repository to a
local directory on your file system. This is known as a checkout of a working copy.</p>
 <p>Subversion uses a copy-modify-merge model meaning that you can add and edit files
and directories in your working copy like any other files on your system, but you should use
subversion commands for everything else such as <code>svn copy</code> and <code>svn
move</code> instead of the operating system commands.</p>
-<h2 id="wzxhzdk23wzxhzdk24sub-commands-and-abbreviations"><a id="sub-commands_and_abbreviations"></a>Sub-commands
and Abbreviations</h2>
+<h2 id="wzxhzdk27wzxhzdk28sub-commands-and-abbreviations"><a id="sub-commands_and_abbreviations"></a>Sub-commands
and Abbreviations</h2>
 <p>Subversion commands can be run from a command shell such as Bash on Linux. The subversion
client command is <code>svn</code> followed by optional sub-commands, options,
and arguments.</p>
 <p>Show the program version and modules</p>
 <div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span>
<span class="o">--</span><span class="n">version</span>
@@ -141,14 +141,14 @@
 <li><code>status</code> - Print the status of working copy files and directories</li>
 <li><code>update</code> - Bring changes from the repository into your working
-<h2 id="wzxhzdk25wzxhzdk26client-configuration"><a id="client_configuration"></a>Client
+<h2 id="wzxhzdk29wzxhzdk30client-configuration"><a id="client_configuration"></a>Client
 <p>Committers need to <a href="">configure
their Subversion client</a> to handle the differences in line endings of text files
on different operating systems.</p>
 <p>There are instances where Subversion may need to open an editor. You need to have
the environment variable EDITOR set to the editor you would like to use. To set it for the
current terminal session in Bash (your path may differ):</p>
 <div class="codehilite"><pre><span class="nv">$</span> <span class="nv">export</span>
<span class="n">EDITOR</span><span class="o">=</span><span class="sr">/usr/</span><span
class="n">bin</span><span class="o">/</span><span class="n">vim</span>
-<h2 id="wzxhzdk27wzxhzdk28repository-layout"><a id="repository_layout"></a>Repository
+<h2 id="wzxhzdk31wzxhzdk32repository-layout"><a id="repository_layout"></a>Repository
 <p>The OOo repository layout uses the following top-level directories <code>branches</code>,
<code>site</code>, <code>tags</code>, and <code>trunk</code>.</p>
 <li><code>branches</code> - Contains branches used for continued development
of a specific version, experimental versions, or for  developing features to be merged into
the trunk or a branch later. (needs examples)</li>
@@ -172,7 +172,7 @@ For more information see the <a href="ht
 <p>"A" indicates file or directory is "Added" to working copy</p>
-<h2 id="wzxhzdk29wzxhzdk30basic-work-cycle"><a id="basic_work_cycle"></a>Basic
Work Cycle</h2>
+<h2 id="wzxhzdk33wzxhzdk34basic-work-cycle"><a id="basic_work_cycle"></a>Basic
Work Cycle</h2>
 <li>Update your working copy - For this you use the <code>svn update</code>
 <li>Make changes - For this you may edit files in an editor, or use the <code>svn
add</code>, <code>svn delete</code>, <code>svn copy</code>,
<code>svn-move</code> commands</li>
@@ -290,7 +290,7 @@ Select: (p) postpone, (df) diff-full, (e
 <p>"G" indicates "merGed"</p>
-<h2 id="wzxhzdk31wzxhzdk32committing-changes"><a id="committing_changes"></a>Committing
+<h2 id="wzxhzdk35wzxhzdk36committing-changes"><a id="committing_changes"></a>Committing
 <p>Only Committers can commit directly to the repository. The following example shows
using your Apache ID and password.</p>
 <div class="codehilite"><pre><span class="nv">$</span> <span class="nv">svn</span>
<span class="n">commit</span> <span class="n">test</span><span
class="o">-</span><span class="n">file</span><span class="o">.</span><span
class="n">c</span> <span class="o">--</span><span class="n">username</span>
<span class="n">your</span><span class="o">-</span><span class="n">name</span>
<span class="o">--</span><span class="n">password</span> <span
class="n">your</span><span class="o">-</span><span class="n">password</span>
<span class="o">\</span>
   <span class="o">-</span><span class="n">m</span> <span class="s">&quot;added
new C file&quot;</span>
@@ -304,7 +304,7 @@ Select: (p) postpone, (df) diff-full, (e
 <p>Always check your changes with "svn diff" and "svn status". Also be careful to specify
the files and/or directories you want to change, if
 you don't specify, SVN will commit <strong>all</strong> your changes.</p>
 <p>For further information see the <a href="">Basic
Work Cycle</a> page from <a href="">Subversion Book</a>.</p>
-<h2 id="wzxhzdk33wzxhzdk34commit-message"><a id="commit_message"></a>Commit
+<h2 id="wzxhzdk37wzxhzdk38commit-message"><a id="commit_message"></a>Commit
 <p>The examples in the previous sections use a simple commit message with the "-m"
 <p>This is fine for some quick testing or for large bulk commits of code that you wrote.</p>
 <p>We ask that your commits include special tagging to appropriately credit the patch.
@@ -325,7 +325,7 @@ should actually look like this:</p>
 <p>Use of the special fields will enable processing by scripts like the
 <a href="">contribulyzer</a>
to help quickly identify
-<h2 id="wzxhzdk35wzxhzdk36committing-changes-by-others"><a id="committing_changes_by_others"></a>Committing
Changes By Others</h2>
+<h2 id="wzxhzdk39wzxhzdk40committing-changes-by-others"><a id="committing_changes_by_others"></a>Committing
Changes By Others</h2>
 <p>See the <a href="">Applying
Patches</a> section of the Committer FAQ page. Please use the special fields 
 described in the previous Commit Message section to commit changes supplied by others. </p>
 <p>Example similar to one on Committer FAQ:</p>
@@ -345,14 +345,68 @@ described in the previous Commit Message
-<h2 id="wzxhzdk37wzxhzdk38creating-and-submitting-patches"><a id="creating_and_submitting_patches"></a>Creating
and Submitting Patches</h2>
+<h2 id="wzxhzdk41wzxhzdk42creating-and-submitting-patches"><a id="creating_and_submitting_patches"></a>Creating
and Submitting Patches</h2>
 <p>See the <a href="">Sending
in Patches</a> section on the Contributors Tech Guide page.</p>
 <p>Create the patch file from <code>svn diff</code> where <code>your-patch-name.patch</code>
is the full path to the patch file to create.</p>
 <div class="codehilite"><pre><span class="n">svn</span> <span
class="n">diff</span> <span class="o">&gt;</span> <span class="n">your</span><span
class="o">-</span><span class="n">patch</span><span class="o">-</span><span
class="n">name</span><span class="o">.</span><span class="n">patch</span>
-<h2 id="wzxhzdk39wzxhzdk40further-information"><a id="further_information"></a>Further
+<h2 id="wzxhzdk43wzxhzdk44merging-changes-to-a-branch"><a id="merging_changes"></a>Merging
changes to a branch</h2>
+<p>New development is done in the trunk of the tree. With few exceptions you do <strong>NOT</strong>
do direct commits to the stable
+branches: you normally only commit your changes to the stable branch after other developers
have been
+given enough time to test the changes don't break anything in the trunk. SVN also keeps a
+of the specific commit that have been merged so the changes are much easier to track down.</p>
+<p>In case there are impending security issues, or if the code in the branch has diverged
significantly to the
+code in the trunk you may commit the code directly but it is a good idea to let
+other developers know about such changes.</p>
+<p>The first step is to do a check out of the specific branch. You can do a complete
+checkout or you can save some space by using the "--depth=empty" option:</p>
+<div class="codehilite"><pre> <span class="c">% svn co --depth=empty
+ <span class="n">U</span>   <span class="n">aoo</span><span class="o">-</span><span
+ <span class="n">Checked</span> <span class="n">out</span> <span
class="n">revision</span> 1347362<span class="p">.</span>
+<p>You can keep saving space (rather convenient) until you reach the directory where
you want to make changes:</p>
+<div class="codehilite"><pre> <span class="c">% svn up --depth=empty main</span>
+ <span class="n">Updating</span> <span class="s">&#39;main&#39;</span><span
+ <span class="n">A</span>    <span class="n">main</span>
+ <span class="n">Updated</span> <span class="n">to</span> <span
class="n">revision</span> 1347363<span class="p">.</span>
+ <span class="c">% svn up --depth=empty jvmfwk</span>
+ <span class="n">Updating</span> <span class="s">&#39;jvmfwk&#39;</span><span
+ <span class="n">A</span>    <span class="n">jvmfwk</span>
+ <span class="n">Updated</span> <span class="n">to</span> <span
class="n">revision</span> 1347366<span class="p">.</span>
+<p>And do a complete checkout from there:
+     svn up --set-depth=infinity
+     Updating '.':
+     A    source
+     A    source/elements.hxx
+     A    source/fwkbase.cxx
+     ... (and so on)</p>
+<p>Now merge the specific revision(s) you want, in this case 1333165:</p>
+<div class="codehilite"><pre> <span class="n">svn</span> <span
class="n">merge</span> <span class="o">-</span><span class="n">c1333165</span>
<span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span
class="o">.</span><span class="n">apache</span><span class="o">.</span><span
class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span
class="sr">/incubator/ooo/trunk/m</span><span class="n">ain</span><span
class="o">/</span><span class="n">jvmfwk</span> <span class="o">.</span>
+ <span class="o">---</span> <span class="n">Merging</span> <span
class="n">r1333165</span> <span class="n">into</span> <span class="s">&#39;.&#39;</span><span
+ <span class="n">U</span>    <span class="n">distributions</span><span
class="sr">/OpenOfficeorg/</span><span class="n">javavendors_unx</span><span
class="o">.</span><span class="n">xml</span>
+<p>After you finish merging check your changes with "svn status" and "svn diff"
+and commit:</p>
+<div class="codehilite"><pre> <span class="n">svn</span> <span
class="n">commit</span> <span class="o">-</span><span class="n">m</span>
<span class="s">&quot;Merge r1329539, r1329547, 1333165 - Add Oracle as a Java vendor
on unix.&quot;</span> <span class="n">distributions</span><span class="sr">/OpenOfficeorg/</span><span
class="n">javavendors_unx</span><span class="o">.</span><span class="n">xml</span>
<span class="n">distributions</span><span class="sr">/OpenOfficeorg/</span><span
class="n">javavendors_freebsd</span><span class="o">.</span><span
+ <span class="n">Sending</span>        <span class="n">distributions</span><span
class="sr">/OpenOfficeorg/</span><span class="n">javavendors_freebsd</span><span
class="o">.</span><span class="n">xml</span>
+ <span class="n">Sending</span>        <span class="n">distributions</span><span
class="sr">/OpenOfficeorg/</span><span class="n">javavendors_unx</span><span
class="o">.</span><span class="n">xml</span>
+ <span class="n">Transmitting</span> <span class="n">file</span>
<span class="n">data</span> <span class="o">..</span>
+ <span class="n">Committed</span> <span class="n">revision</span>
<span class="mi">1347377</span><span class="o">.</span>
+<p>You usually don't need to apply patches or add new files to merge your changes,
instead you use the "svn merge"
+command which finds out the specific changes and replays them.</p>
+<h2 id="wzxhzdk45wzxhzdk46further-information"><a id="further_information"></a>Further
 <p>For more information see: </p>
 <li><a href="">Apache Subversion Project</a></li>

View raw message