[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