Version Control with Subversion phần 10 pptx

--tunnel-user NAME

Used in conjunction with the --tunnel option; tells svnserve to assume that NAME is the

authenticated user, rather than the UID of the svnserve process. Useful for users wishing

to share a single system account over SSH, but maintaining separate commit identities.

--threads (-T)

When running in daemon mode, causes svnserve to spawn a thread instead of a process

for each connection (e.g. for when running on Windows). The svnserve process still back￾grounds itself at startup time.

--listen-once (-X)

Causes svnserve to accept one connection on the svn port, serve it, and exit. This option

is mainly useful for debugging.

svnversion

Subversion Complete Reference

309

Name

svnversion — Summarize the local revision(s) of a working copy.

Synopsis

svnversion [OPTIONS] [WC_PATH [TRAIL_URL]]

Description

svnversion is a program for summarizing the revision mixture of a working copy. The resultant

revision number, or revision range, is written to standard output.

It's common to use this output in your build process when defining the version number of your

program.

TRAIL_URL, if present, is the trailing portion of the URL used to determine if WC_PATH itself is

switched (detection of switches within WC_PATH does not rely on TRAIL_URL).

When WC_PATH is not defined, the current directory will be used as the working copy path.

TRAIL_URL cannot be defined if WC_PATH is not explicitly given.

Options

Like svnserve, svnversion has no subcommands, it only has options.

--no-newline (-n)

Omit the usual trailing newline from the output.

--committed (-c)

Use the last-changed revisions rather than the current (i.e., highest locally available) revi￾sions.

--help (-h)

Print a help summary.

--version

Print the version of svnversion and exit with no error.

Examples

If the working copy is all at the same revision (for example, immediately after an update), then

that revision is printed out:

$ svnversion

4168

You can add TRAIL_URL to make sure that the working copy is not switched from what you

expect. Note that the WC_PATH is required in this command:

$ svnversion . /repos/svn/trunk

Subversion Complete Reference

310

4168

For a mixed-revision working copy, the range of revisions present is printed:

$ svnversion

4123:4168

If the working copy contains modifications, a trailing "M" is added:

$ svnversion

4168M

If the working copy is switched, a trailing "S" is added:

$ svnversion

4168S

Thus, here is a mixed-revision, switched working copy containing some local modifications:

$ svnversion

4212:4168MS

If invoked on a directory that is not a working copy, svnversion assumes it is an exported

working copy and prints "exported":

$ svnversion

exported

mod_dav_svn

Subversion Complete Reference

311

Name

mod_dav_svn Configuration Directives — Apache configuration directives for serving Subver￾sion repositories through Apache HTTP Server.

Description

This section briefly describes each of the Subversion Apache configuration directives. For an

in-depth description of configuring Apache with Subversion, see the section called “httpd, the

Apache HTTP server”.)

Directives

DAV svn

This directive must be included in any Directory or Location block for a Subversion

repository. It tells httpd to use the Subversion backend for mod_dav to handle all requests.

SVNAutoversioning On

This directive allows write requests from WebDAV clients to result in automatic commits. A

generic log message is auto-generated and attached to each revision. If you enable

Autoversioning, you'll likely want to set ModMimeUsePathInfo On so that mod_mime can

set svn:mime-type to the correct mime-type automatically (as best as mod_mime is able

to, of course). For more information, see Appendix C, WebDAV and Autoversioning

SVNPath

This directive specifies the location in the filesystem for a Subversion repository's files. In a

configuration block for a Subversion repository, either this directive or SVNParentPath

must be present, but not both.

SVNSpecialURI

Specifies the URI component (namespace) for special Subversion resources. The default

is “!svn”, and most administrators will never use this directive. Only set this if there is a

pressing need to have a file named !svn in your repository. If you change this on a server

already in use, it will break all of the outstanding working copies and your users will hunt

you down with pitchforks and flaming torches.

SVNReposName

Specifies the name of a Subversion repository for use in HTTP GET responses. This value

will be prepended to the title of all directory listings (which are served when you navigate to

a Subversion repository with a web browser). This directive is optional.

SVNIndexXSLT

Specifies the URI of an XSL transformation for directory indexes. This directive is optional.

SVNParentPath

Specifies the location in the filesystem of a parent directory whose child directories are

Subversion repositories. In a configuration block for a Subversion repository, either this dir￾ective or SVNPath must be present, but not both.

SVNPathAuthz

Control path-based authorization by enabling or disabling subrequests. See the section

called “Disabling Path-based Checks” for details.

Subversion Complete Reference

312