[svnbook commit] r2676 - trunk/src/en/book

cmpilato noreply at red-bean.com
Fri Feb 9 05:34:00 CST 2007


Author: cmpilato
Date: Fri Feb  9 05:33:59 2007
New Revision: 2676

Modified:
   trunk/src/en/book/ch-advanced-topics.xml
   trunk/src/en/book/ch-reference.xml

Log:
* src/en/book/ch-reference.xml
  Add some missing refpurpose's.  Tweak the properties section to not be
  trying (and failing) to be reference-y.

* src/en/book/ch-advanced-topics.xml
  Update some cross-references.


Modified: trunk/src/en/book/ch-advanced-topics.xml
==============================================================================
--- trunk/src/en/book/ch-advanced-topics.xml	(original)
+++ trunk/src/en/book/ch-advanced-topics.xml	Fri Feb  9 05:33:59 2007
@@ -326,7 +326,7 @@
       mentioned elsewhere in this or other chapters as part of the
       more general topics to which they are related.  For an
       exhaustive list of Subversion's pre-defined properties, see
-      <xref linkend="svn.ref.svnprops"/>.</para>
+      <xref linkend="svn.ref.properties"/>.</para>
 
     <para>In this section, we will examine the utility—both to
       users of Subversion, and to Subversion itself—of property
@@ -2900,7 +2900,7 @@
         author of the revision.  That is, the authenticated user's
         name is stored as the value of the
         <literal>svn:author</literal> property on the new revision
-        (see <xref linkend="svn.ref.svnprops"/>).  If
+        (see <xref linkend="svn.ref.properties"/>).  If
         the client was not authenticated (in other words, the server
         never issued an authentication challenge), then the revision's
         <literal>svn:author</literal> property is empty.

Modified: trunk/src/en/book/ch-reference.xml
==============================================================================
--- trunk/src/en/book/ch-reference.xml	(original)
+++ trunk/src/en/book/ch-reference.xml	Fri Feb  9 05:33:59 2007
@@ -6713,192 +6713,178 @@
 
     <title>Subversion properties</title>
 
-    <refentry id="svn.ref.svnprops">
-      <refnamediv>
-
-        <refname>Subversion-defined properties</refname> <refpurpose>
-        properties defined by Subversion to control behavior.</refpurpose>
-
-      </refnamediv>
-
-      <refsect1 id="svn.ref.svnprops.desc">
-        <title>Description</title>
-
-        <para>Subversion allows users to invent arbitrarily-named
-          versioned properties on files and directories, as well as
-          unversioned properties on revisions.  The only restriction
-          is on properties prefixed with <quote>svn:</quote>.
-          Properties in that namespace are reserved for Subversion's
-          own use.  While these properties may be set by users to
-          control Subversion's behavior, users may not invent new
-          <quote>svn:</quote> properties.</para>
-
-      </refsect1>
+    <para>Subversion allows users to invent arbitrarily-named
+      versioned properties on files and directories, as well as
+      unversioned properties on revisions.  The only restriction is on
+      properties prefixed with <quote>svn:</quote>.  Properties in
+      that namespace are reserved for Subversion's own use.  While
+      these properties may be set by users to control Subversion's
+      behavior, users may not invent new <quote>svn:</quote>
+      properties.</para>
 
-      <refsect1 id="svn.ref.properties.versioned-props">
-        <title>Versioned Properties</title>
+    <sect2 id="svn.ref.properties.versioned-props">
+      <title>Versioned Properties</title>
 
-        <variablelist>
+      <variablelist>
 
-          <varlistentry>
-            <term><literal>svn:executable</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:executable</literal></term>
+          <listitem>
 
-              <para>If present on a file, the client will make the
-                file executable in Unix-hosted working copies.  See
-                <xref
-                linkend="svn.advanced.props.special.executable"/>.</para>
+            <para>If present on a file, the client will make the
+              file executable in Unix-hosted working copies.  See
+              <xref
+              linkend="svn.advanced.props.special.executable"/>.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:mime-type</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:mime-type</literal></term>
+          <listitem>
 
-              <para>If present on a file, the value indicates the
-                file's mime-type.  This allows the client to decide
-                whether line-based contextual merging is safe to
-                perform during updates, and can also affect how the
-                file behaves when fetched via web browser.  See
-                <xref
-                linkend="svn.advanced.props.special.mime-type"/>. </para>
+            <para>If present on a file, the value indicates the
+              file's mime-type.  This allows the client to decide
+              whether line-based contextual merging is safe to
+              perform during updates, and can also affect how the
+              file behaves when fetched via web browser.  See
+              <xref
+              linkend="svn.advanced.props.special.mime-type"/>. </para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:ignore</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:ignore</literal></term>
+          <listitem>
 
-              <para>If present on a directory, the value is a list of
-                unversioned file patterns to be ignored
-                by <command>svn status</command> and other
-                subcommands.  See
-                <xref
-                linkend="svn.advanced.props.special.ignore"/></para>
+            <para>If present on a directory, the value is a list of
+              unversioned file patterns to be ignored
+              by <command>svn status</command> and other
+              subcommands.  See
+              <xref
+              linkend="svn.advanced.props.special.ignore"/></para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:keywords</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:keywords</literal></term>
+          <listitem>
 
-              <para>If present on a file, the value tells the client
-                how to expand particular keywords within the file.
-                See
-                <xref
-                linkend="svn.advanced.props.special.keywords"/>.</para>
+            <para>If present on a file, the value tells the client
+              how to expand particular keywords within the file.
+              See
+              <xref
+              linkend="svn.advanced.props.special.keywords"/>.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:eol-style</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:eol-style</literal></term>
+          <listitem>
 
-              <para>If present on a file, the value tells the client
-                how to manipulate the file's line-endings in the
-                working copy.  See
-                <xref
-                linkend="svn.advanced.props.special.eol-style"/>.</para>
+            <para>If present on a file, the value tells the client
+              how to manipulate the file's line-endings in the
+              working copy.  See
+              <xref
+              linkend="svn.advanced.props.special.eol-style"/>.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:externals</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:externals</literal></term>
+          <listitem>
 
-              <para>If present on a directory, the value is a
-                multi-line list of other paths and URLs the client
-                should check out.  See
-                <xref
-                linkend="svn.advanced.externals"/>.</para>
+            <para>If present on a directory, the value is a
+              multi-line list of other paths and URLs the client
+              should check out.  See
+              <xref
+              linkend="svn.advanced.externals"/>.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:special</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:special</literal></term>
+          <listitem>
 
-              <para>If present on a file, indicates that the file is
-                not an ordinary file, but a symbolic link or other
-                special object.</para>
+            <para>If present on a file, indicates that the file is
+              not an ordinary file, but a symbolic link or other
+              special object.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:needs-lock</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:needs-lock</literal></term>
+          <listitem>
 
-              <para>If present on a file, tells the client to make the
-                file read-only in the working copy, as a reminder that
-                the file should be locked before editing begins.  See
-                <xref
-                linkend="svn.advanced.locking.lock-communication"/>.</para>
+            <para>If present on a file, tells the client to make the
+              file read-only in the working copy, as a reminder that
+              the file should be locked before editing begins.  See
+              <xref
+              linkend="svn.advanced.locking.lock-communication"/>.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-        </variablelist>
-      </refsect1>
+      </variablelist>
+    </sect2>
 
-      <refsect1 id="svn.ref.properties.unversioned-props">
-        <title>Unversioned Properties</title>
+    <sect2 id="svn.ref.properties.unversioned-props">
+      <title>Unversioned Properties</title>
 
-        <variablelist>
+      <variablelist>
 
-          <varlistentry>
-            <term><literal>svn:author</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:author</literal></term>
+          <listitem>
 
-              <para>If present, contains the authenticated username of
-                the person who created the revision.  (If not present,
-                then the revision was committed anonymously.)</para>
+            <para>If present, contains the authenticated username of
+              the person who created the revision.  (If not present,
+              then the revision was committed anonymously.)</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:date</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:date</literal></term>
+          <listitem>
 
-              <para>Contains the UTC time the revision was created, in
-                ISO format.  The value comes from the server
-                machine's clock.</para>
+            <para>Contains the UTC time the revision was created, in
+              ISO format.  The value comes from the server
+              machine's clock.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:log</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:log</literal></term>
+          <listitem>
 
-              <para>Contains the log message describing the
-                revision.</para>
+            <para>Contains the log message describing the
+              revision.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-          <varlistentry>
-            <term><literal>svn:autoversioned</literal></term>
-            <listitem>
+        <varlistentry>
+          <term><literal>svn:autoversioned</literal></term>
+          <listitem>
 
-              <para>If present, the revision was created via the
-                autoversioning feature.  See
-                <xref linkend="svn.webdav.autoversioning"/>.</para>
+            <para>If present, the revision was created via the
+              autoversioning feature.  See
+              <xref linkend="svn.webdav.autoversioning"/>.</para>
 
-            </listitem>
-          </varlistentry>
+          </listitem>
+        </varlistentry>
 
-        </variablelist>
-      </refsect1>
+      </variablelist>
+    </sect2>
 
-    </refentry>
   </sect1>
 
   <!-- ================================================================= -->
@@ -6919,6 +6905,7 @@
 
       <refnamediv>
         <refname>start-commit</refname>
+        <refpurpose>Notification of the beginning of a commit.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -6970,6 +6957,7 @@
 
       <refnamediv>
         <refname>pre-commit</refname>
+        <refpurpose>Notification just prior to commit completion.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -7024,6 +7012,7 @@
 
       <refnamediv>
         <refname>post-commit</refname>
+        <refpurpose>Notification of a successful commit.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -7075,6 +7064,8 @@
 
       <refnamediv>
         <refname>pre-revprop-change</refname>
+        <refpurpose>Notification of a revision property change
+          attempt.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -7141,6 +7132,8 @@
 
       <refnamediv>
         <refname>post-revprop-change</refname>
+        <refpurpose>Notification of a successful revision property 
+          change.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -7209,6 +7202,7 @@
 
       <refnamediv>
         <refname>pre-lock</refname>
+        <refpurpose>Notification of a path lock attempt.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -7265,6 +7259,7 @@
 
       <refnamediv>
         <refname>post-lock</refname>
+        <refpurpose>Notification of a successful path lock.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -7318,6 +7313,7 @@
 
       <refnamediv>
         <refname>pre-unlock</refname>
+        <refpurpose>Notification of a path unlock attempt.</refpurpose>
       </refnamediv>
 
       <refsect1>
@@ -7376,6 +7372,7 @@
 
       <refnamediv>
         <refname>post-unlock</refname>
+        <refpurpose>Notification of a successful path unlock.</refpurpose>
       </refnamediv>
 
       <refsect1>




More information about the svnbook-dev mailing list