update home-base and home-full

[home-base.git] / .subversion / README.txt

diff --git a/.subversion/README.txt b/.subversion/README.txt
new file mode 100644 (file)
index 0000000..24141c9
--- /dev/null
+++ b/.subversion/README.txt
@@ -0,0 +1,111 @@
+This directory holds run-time configuration information for Subversion
+clients.  The configuration files all share the same syntax, but you
+should examine a particular file to learn what configuration
+directives are valid for that file.
+
+The syntax is standard INI format:
+
+   - Empty lines, and lines starting with '#', are ignored.
+     The first significant line in a file must be a section header.
+
+   - A section starts with a section header, which must start in
+     the first column:
+
+       [section-name]
+
+   - An option, which must always appear within a section, is a pair
+     (name, value).  There are two valid forms for defining an
+     option, both of which must start in the first column:
+
+       name: value
+       name = value
+
+     Whitespace around the separator (:, =) is optional.
+
+   - Section and option names are case-insensitive, but case is
+     preserved.
+
+   - An option's value may be broken into several lines.  The value
+     continuation lines must start with at least one whitespace.
+     Trailing whitespace in the previous line, the newline character
+     and the leading whitespace in the continuation line is compressed
+     into a single space character.
+
+   - All leading and trailing whitespace around a value is trimmed,
+     but the whitespace within a value is preserved, with the
+     exception of whitespace around line continuations, as
+     described above.
+
+   - When a value is a list, it is comma-separated.  Again, the
+     whitespace around each element of the list is trimmed.
+
+   - Option values may be expanded within a value by enclosing the
+     option name in parentheses, preceded by a percent sign:
+
+       %(name)
+
+     The expansion is performed recursively and on demand, during
+     svn_option_get.  The name is first searched for in the same
+     section, then in the special [DEFAULT] section. If the name
+     is not found, the whole %(name) placeholder is left
+     unchanged.
+
+     Any modifications to the configuration data invalidate all
+     previously expanded values, so that the next svn_option_get
+     will take the modifications into account.
+
+
+Configuration data in the Windows registry
+==========================================
+
+On Windows, configuration data may also be stored in the registry.  The
+functions svn_config_read and svn_config_merge will read from the
+registry when passed file names of the form:
+
+   REGISTRY:<hive>/path/to/config-key
+
+The REGISTRY: prefix must be in upper case. The <hive> part must be
+one of:
+
+   HKLM for HKEY_LOCAL_MACHINE
+   HKCU for HKEY_CURRENT_USER
+
+The values in config-key represent the options in the [DEFAULT] section.
+The keys below config-key represent other sections, and their values
+represent the options. Only values of type REG_SZ whose name doesn't
+start with a '#' will be used; other values, as well as the keys'
+default values, will be ignored.
+
+
+File locations
+==============
+
+Typically, Subversion uses two config directories, one for site-wide
+configuration,
+
+  Unix:
+    /etc/subversion/servers
+    /etc/subversion/config
+    /etc/subversion/hairstyles
+  Windows:
+    %ALLUSERSPROFILE%\Application Data\Subversion\servers
+    %ALLUSERSPROFILE%\Application Data\Subversion\config
+    %ALLUSERSPROFILE%\Application Data\Subversion\hairstyles
+    REGISTRY:HKLM\Software\Tigris.org\Subversion\Servers
+    REGISTRY:HKLM\Software\Tigris.org\Subversion\Config
+    REGISTRY:HKLM\Software\Tigris.org\Subversion\Hairstyles
+
+and one for per-user configuration:
+
+  Unix:
+    ~/.subversion/servers
+    ~/.subversion/config
+    ~/.subversion/hairstyles
+  Windows:
+    %APPDATA%\Subversion\servers
+    %APPDATA%\Subversion\config
+    %APPDATA%\Subversion\hairstyles
+    REGISTRY:HKCU\Software\Tigris.org\Subversion\Servers
+    REGISTRY:HKCU\Software\Tigris.org\Subversion\Config
+    REGISTRY:HKCU\Software\Tigris.org\Subversion\Hairstyles
+