[svnbook commit] r3224 - trunk/src/en/book
cmpilato
noreply at red-bean.com
Mon Jul 28 23:22:39 CDT 2008
Author: cmpilato
Date: Mon Jul 28 23:22:38 2008
New Revision: 3224
Log:
Enter O'Reilly second-round copyedits.
Modified:
trunk/src/en/book/appc-webdav.xml
Modified: trunk/src/en/book/appc-webdav.xml
==============================================================================
--- trunk/src/en/book/appc-webdav.xml (original)
+++ trunk/src/en/book/appc-webdav.xml Mon Jul 28 23:22:38 2008
@@ -3,11 +3,11 @@
<para>WebDAV is an extension to HTTP, and it is growing more and more
popular as a standard for file sharing. Today's operating systems
- are becoming extremely Web-aware, and many now have built-in
+ are becoming extremely web-aware, and many now have built-in
support for mounting <quote>shares</quote> exported by WebDAV
servers.</para>
- <para>If you use Apache as your Subversion network server, then to
+ <para>If you use Apache as your Subversion network server, to
some extent you are also running a WebDAV server. This appendix
gives some background on the nature of this protocol, how
Subversion uses it, and how well Subversion interoperates with
@@ -23,7 +23,7 @@
<para><firstterm>DAV</firstterm> stands for <quote>Distributed
Authoring and Versioning.</quote> RFC 2518 defines a set of
concepts and accompanying extension methods to HTTP 1.1 that
- make the Web into a more universal read/write medium. The basic
+ make the Web a more universal read/write medium. The basic
idea is that a WebDAV-compliant web server can act like a
generic file server; clients can <quote>mount</quote> shared
folders over HTTP that behave much like other network
@@ -48,11 +48,11 @@
Every modern computer operating system has a general WebDAV
client built in (details to follow), and a number of popular
standalone applications are also able to speak
- WebDAV—Microsoft Office, Dreamweaver, and Photoshop to
+ WebDAV—Microsoft Office, Dreamweaver, and Photoshop, to
name a few. On the server end, Apache HTTP Server has been
able to provide WebDAV services since 1998 and is considered the
- de-facto open source standard. There are several other
- commercial WebDAV servers available, including Microsoft's own
+ de facto open source standard. Several other
+ commercial WebDAV servers are available, including Microsoft's own
IIS.</para>
<para>DeltaV, unfortunately, has not been so successful. It's
@@ -62,7 +62,7 @@
entirely clear as to why DeltaV has remained stagnant. Some
opine that the specification is just too complex. Others argue
that while WebDAV's features have mass appeal (even the least
- technical users appreciate network file sharing), version
+ technical users appreciate network file sharing), its version
control features just aren't interesting or necessary for most
users. Finally, some believe that DeltaV remains unpopular
because there's still no open source server product that
@@ -89,7 +89,7 @@
<para>Second, <command>mod_dav_svn</command> is not a
fully realized DeltaV server. Many portions of the DeltaV
- specification were irrelevant to Subversion, and thus left
+ specification were irrelevant to Subversion, and thus were left
unimplemented.</para>
<para>There is still some debate in the developer community as to
@@ -111,8 +111,8 @@
<sect1 id="svn.webdav.autoversioning">
<title>Autoversioning</title>
- <para>While the Subversion client is not a full DeltaV client, nor
- the Subversion server a full DeltaV server, there's still a
+ <para>While the Subversion client is not a full DeltaV client, and
+ the Subversion server is not a full DeltaV server, there's still a
glimmer of WebDAV interoperability to be happy about:
<firstterm>autoversioning</firstterm>.</para>
@@ -124,8 +124,8 @@
versioning requests: something like
<literal>MKACTIVITY</literal>, <literal>CHECKOUT</literal>,
<literal>PUT</literal>, <literal>CHECKIN</literal>. But if the
- DeltaV server supports autoversioning, then write requests from
- basic WebDAV clients are accepted. The server behaves as if the
+ DeltaV server supports autoversioning, write requests from
+ basic WebDAV clients are accepted. The server behaves as though the
client <emphasis>had</emphasis> issued the proper series of
versioning requests, performing a commit under the hood. In
other words, it allows a DeltaV server to interoperate with
@@ -137,8 +137,8 @@
Imagine an office of ordinary users running Microsoft Windows or
Mac OS. Each user <quote>mounts</quote> the Subversion
repository, which appears to be an ordinary network folder.
- They use the shared folder as they always do: open files, edit
- them, save them. Meanwhile, the server is automatically
+ They use the shared folder as they always do: open files, edit
+ them, and save them. Meanwhile, the server is automatically
versioning everything. Any administrator (or knowledgeable
user) can still use a Subversion client to search history and
retrieve older versions of data.</para>
@@ -171,7 +171,7 @@
0-byte file (as a way of reserving a name) followed by another
<literal>PUT</literal> with the real file data. The single
file-write results in two separate commits. Also consider that
- many applications autosave every few minutes, resulting in even
+ many applications auto-save every few minutes, resulting in even
more commits.</para>
<para>If you have a post-commit hook program that sends email, you
@@ -190,7 +190,7 @@
<literal>mod_mime</literal> module. If a WebDAV client adds a
new file to the repository, there's no opportunity for the user
to set the the <literal>svn:mime-type</literal> property. This
- might cause the file to appear as generic icon when viewed
+ might cause the file to appear as a generic icon when viewed
within a WebDAV shared folder, not having an association with
any application. One remedy is to have a sysadmin (or other
Subversion-knowledgeable person) check out a working copy and
@@ -212,10 +212,10 @@
</screen>
<para>This directive allows <literal>mod_mime</literal> to attempt
- automatic deduction of the mime-type on new files that enter the
+ automatic deduction of the MIME type on new files that enter the
repository via autoversioning. The module looks at the file's
named extension and possibly the contents as well; if the file
- matches some common patterns, then the the
+ matches some common patterns, the
file's <literal>svn:mime-type</literal> property will be set
automatically.</para>
@@ -233,8 +233,8 @@
broadly define the types of WebDAV functionality available to
users. <xref linkend="svn.webdav.clients.tbl-1"/> gives our
categorization as well as a quick description of some common pieces of
- WebDAV-enabled software. More details about these software
- offerings, as well as their general category, can be found in
+ WebDAV-enabled software. You can find more details about these software
+ offerings, as well as their general category, in
the sections that follow.</para>
<table id="svn.webdav.clients.tbl-1">
@@ -258,16 +258,16 @@
<entry></entry>
<entry></entry>
<entry>Image editing software, allowing direct opening
- from, and writing to, WebDAV URLs.</entry>
+ from, and writing to, WebDAV URLs</entry>
</row>
<row>
- <entry>Cadaver</entry>
+ <entry>cadaver</entry>
<entry>Standalone WebDAV application</entry>
<entry></entry>
<entry>X</entry>
<entry>X</entry>
<entry>Command-line WebDAV client supporting file
- transfer, tree, and locking operations.</entry>
+ transfer, tree, and locking operations</entry>
</row>
<row>
<entry>DAV Explorer</entry>
@@ -275,7 +275,7 @@
<entry>X</entry>
<entry>X</entry>
<entry>X</entry>
- <entry>Java GUI tool for exploring WebDAV shares.</entry>
+ <entry>Java GUI tool for exploring WebDAV shares</entry>
</row>
<row>
<entry>Macromedia Dreamweaver</entry>
@@ -284,7 +284,7 @@
<entry></entry>
<entry></entry>
<entry>Web production software able to directly read from
- and write to WebDAV URLs.</entry>
+ and write to WebDAV URLs</entry>
</row>
<row>
<entry>Microsoft Office</entry>
@@ -294,7 +294,7 @@
<entry></entry>
<entry>Office productivity suite with several components
able to directly read from and write to WebDAV
- URLs.</entry>
+ URLs</entry>
</row>
<row>
<entry>Microsoft Web Folders</entry>
@@ -303,7 +303,7 @@
<entry></entry>
<entry></entry>
<entry>GUI file explorer program able to perform tree
- operations on a WebDAV share.</entry>
+ operations on a WebDAV share</entry>
</row>
<row>
<entry>GNOME Nautilus</entry>
@@ -312,7 +312,7 @@
<entry></entry>
<entry>X</entry>
<entry>GUI file explorer able to perform tree
- operations on a WebDAV share.</entry>
+ operations on a WebDAV share</entry>
</row>
<row>
<entry>KDE Konqueror</entry>
@@ -321,7 +321,7 @@
<entry></entry>
<entry>X</entry>
<entry>GUI file explorer able to perform tree
- operations on a WebDAV share.</entry>
+ operations on a WebDAV share</entry>
</row>
<row>
<entry>Mac OS X</entry>
@@ -329,8 +329,8 @@
<entry></entry>
<entry>X</entry>
<entry></entry>
- <entry>Operating system has built-in support for mounting
- WebDAV shares..</entry>
+ <entry>Operating system that has built-in support for mounting
+ WebDAV shares.</entry>
</row>
<row>
<entry>Novell NetDrive</entry>
@@ -339,7 +339,7 @@
<entry></entry>
<entry></entry>
<entry>Drive-mapping program for assigning Windows drive
- letters to a mounted remote WebDAV share.</entry>
+ letters to a mounted remote WebDAV share</entry>
</row>
<row>
<entry>SRT WebDrive</entry>
@@ -349,7 +349,7 @@
<entry></entry>
<entry>File transfer software, which, among other things,
allows the assignment of Windows drive letters to a
- mounted remote WebDAV share.</entry>
+ mounted remote WebDAV share</entry>
</row>
<row>
<entry>davfs2</entry>
@@ -357,8 +357,8 @@
<entry></entry>
<entry></entry>
<entry>X</entry>
- <entry>Linux file system driver that allows you to mount a
- WebDAV share.</entry>
+ <entry>Linux filesystem driver that allows you to mount a
+ WebDAV share</entry>
</row>
</tbody>
@@ -377,12 +377,12 @@
<sect3 id="svn.webdav.clients.standalone.windows">
<title>Microsoft Office, Dreamweaver, Photoshop</title>
- <para>On Windows, there are several well-known applications
- that contain integrated WebDAV client functionality, such as
+ <para>On Windows, several well-known applications
+ contain integrated WebDAV client functionality, such as
Microsoft's Office,
<footnote>
<para>WebDAV support was removed from Microsoft Access for
- some reason, but exists in the rest of the Office
+ some reason, but it exists in the rest of the Office
suite.</para>
</footnote>
Adobe's Photoshop, and Macromedia's Dreamweaver programs.
@@ -390,7 +390,7 @@
make heavy use of WebDAV locks when editing a file.</para>
<para>Note that while many of these programs also exist for
- the Mac OS X, they do not appear to support WebDAV directly
+ Mac OS X, they do not appear to support WebDAV directly
on that platform. In fact, on Mac OS X, the
<guimenu>File→Open</guimenu> dialog box doesn't allow
one to type a path or URL at all. It's likely that the
@@ -415,8 +415,8 @@
<para>Using cadaver is similar to using a command-line FTP
program, and thus it's extremely useful for basic WebDAV
debugging. It can be used to upload or download files in a
- pinch, and also to examine properties, and to copy, move,
- lock or unlock files:</para>
+ pinch, to examine properties, and to copy, move,
+ lock, or unlock files:</para>
<screen>
$ cadaver http://host/repos
@@ -461,14 +461,14 @@
<title>File-Explorer WebDAV Extensions</title>
<para>Some popular file explorer GUI programs support WebDAV
- extensions that allow a user to browse a DAV share as if it
+ extensions that allow a user to browse a DAV share as though it
was just another directory on the local computer, and to
perform basic tree editing operations on the items in that
share. For example, Windows Explorer is able to browse a
WebDAV server as a <quote>network place.</quote> Users can
drag files to and from the desktop, or can rename, copy, or
delete files in the usual way. But because it's only a
- feature of the file-explorer, the DAV share isn't visible to
+ feature of the file explorer, the DAV share isn't visible to
ordinary applications. All DAV interaction must happen
through the explorer interface.</para>
@@ -479,14 +479,14 @@
<para>Microsoft was one of the original backers of the WebDAV
specification, and first started shipping a client in
Windows 98, which was known as Web Folders. This client was
- also shipped in Windows NT4 and 2000.</para>
+ also shipped in Windows NT 4.0 and Windows 2000.</para>
<para>The original Web Folders client was an extension to
Explorer, the main GUI program used to browse filesystems. It
works well enough. In Windows 98, the feature might need to
be explicitly installed if Web Folders aren't already visible
inside My Computer. In Windows 2000, simply
- add a new <quote>network place</quote>, enter the URL, and the
+ add a new <quote>network place,</quote> enter the URL, and the
WebDAV share will pop up for browsing.</para>
<para>With the release of Windows XP, Microsoft started shipping
@@ -494,21 +494,22 @@
Mini-Redirector. The new implementation is a
filesystem-level client, allowing WebDAV shares to be mounted
as drive letters. Unfortunately, this implementation is
- incredibly buggy. The client usually tries to convert http
+ incredibly buggy. The client usually tries to convert HTTP
URLs (<literal>http://host/repos</literal>) into UNC share
notation (<literal>\\host\repos</literal>); it also often
tries to use Windows Domain authentication to respond to
basic-auth HTTP challenges, sending usernames as
<literal>HOST\username</literal>. These interoperability
- problems are severe and documented in numerous places around
+ problems are severe and are documented in numerous places around
the Web, to the frustration of many users. Even Greg Stein,
the original author of Apache's WebDAV module, bluntly
states that XP Web Folders simply can't operate against an Apache
server.</para>
- <para>Windows Vista's implementation of Web Folders seems to
+ <para>Windows Vista's initial implementation of Web Folders seems to
be almost the same as XP's, so it has the same sort of
- problems (at the time of writing).</para>
+ problems. With luck, Microsoft will remedy these issues in
+ a Vista Service Pack.</para>
<para>However, there seem to be workarounds for both XP and
Vista that allow Web Folders to work against Apache. Users
@@ -524,8 +525,8 @@
Places and adding a new network place. When prompted,
enter the URL of the repository, but <emphasis>include a
port number</emphasis> in the URL. For
- example, <uri>http://host/repos</uri> should be
- entered as <uri>http://host:80/repos</uri> instead.
+ example, you should enter <userinput>http://host/repos</userinput>
+ as <userinput>http://host:80/repos</userinput> instead.
Respond to any authentication prompts with your Subversion
credentials.</para>
@@ -537,9 +538,9 @@
unless the connection happens
over <literal>https://</literal>. If you're unable to connect
to the Subversion repository via SSL, you can tweak the
- system registry to turn off this behavior. Just set the
- key <literal>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel</literal>
- from 1 to 2. A final warning: be sure to set up the Web
+ system registry to turn off this behavior. Just change the
+ value of the <literal>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel</literal>
+ key from <userinput>1</userinput> to <userinput>2</userinput>. A final warning: be sure to set up the Web
Folder to point to the repository's root directory
(<filename>/</filename>), rather than some subdirectory
such as <filename>/trunk</filename>. Vista Web Folders
@@ -573,7 +574,7 @@
an <literal>http://</literal> URL, Konqueror will behave
like an ordinary web browser. You'll likely see the generic
HTML directory listing produced
- by <command>mod_dav_svn</command>. By entering
+ by <command>mod_dav_svn</command>. When you enter
<userinput>webdav://host/repos</userinput> instead of
<userinput>http://host/repos</userinput>, Konqueror becomes a
WebDAV client and displays the repository as a
@@ -590,7 +591,7 @@
filesystem module, typically within the operating system's
kernel. This means that the DAV share is mounted like any
other network filesystem, similar to mounting an NFS share on
- Unix or attaching an SMB share as drive letter in Windows.
+ Unix or attaching an SMB share as a drive letter in Windows.
As a result, this sort of client provides completely
transparent read/write WebDAV access to all programs.
Applications aren't even aware that WebDAV requests are
@@ -603,12 +604,12 @@
<para>Both WebDrive and NetDrive are excellent commercial
products that allow a WebDAV share to be attached as drive
letters in Windows. As a result, you can operate on the
- contents of these WebDAV-backed pseudo-drives as easily as
+ contents of these WebDAV-backed pseudodrives as easily as
you can against real local hard drives, and in the same
- ways. WebDrive can be purchased from South River
+ ways. You can purchase WebDrive from South River
Technologies (<ulink url="http://www.southrivertech.com"/>).
Novell's NetDrive is freely available online, but requires
- users to have a Netware license.</para>
+ users to have a NetWare license.</para>
</sect3>
@@ -632,14 +633,14 @@
<para>Note that if your <command>mod_dav_svn</command> is
older than version 1.2, OS X will refuse to mount the share
- as read-write; it will appear as read-only. This is because
- OS X insists on locking support for read-write shares, and
+ as read/write; it will appear as read-only. This is because
+ OS X insists on locking support for read/write shares, and
the ability to lock files first appeared in Subversion
1.2.</para>
<para>Also, OS X's WebDAV client can sometimes be overly
sensitive to HTTP redirects. If OS X is unable to mount the
- repository at all, you may need to enable the BrowserMatch
+ repository at all, you may need to enable the <literal>BrowserMatch</literal>
directive in the Apache server's
<filename>httpd.conf</filename>:</para>
@@ -654,9 +655,9 @@
<title>Linux davfs2</title>
<para>Linux davfs2 is a filesystem module for the Linux kernel,
- whose development is located at <ulink
- url="http://dav.sourceforge.net/"/>. Once installed, a WebDAV
- network share can be mounted with the usual Linux mount
+ whose development is organized at <ulink
+ url="http://dav.sourceforge.net/"/>. Once you install
+ davfs2, you can mount a WebDAV network share using the usual Linux mount
command:</para>
<screen>
More information about the svnbook-dev
mailing list