[svnbook commit] r2836 - trunk/src/en/book
sussman
noreply at red-bean.com
Sun Aug 12 20:30:23 CDT 2007
Author: sussman
Date: Sun Aug 12 20:30:22 2007
New Revision: 2836
Log:
Updates to Appendix C, for the svn 1.4 book.
* src/en/book/appab-svn-for-cvs-users.html
- Minor rewordings, mostly from offby1's review.
* src/en/book/copyright.xml: change (c) date to cover 2007.
Modified:
trunk/src/en/book/appc-webdav.xml
trunk/src/en/book/copyright.xml
Modified: trunk/src/en/book/appc-webdav.xml
==============================================================================
--- trunk/src/en/book/appc-webdav.xml (original)
+++ trunk/src/en/book/appc-webdav.xml Sun Aug 12 20:30:22 2007
@@ -47,7 +47,7 @@
<para>The original WebDAV standard has been widely successful.
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 —
+ standalone applications are also able to speak WebDAV—
Microsoft Office, Dreamweaver, and Photoshop to name a few. On
the server end, the Apache webserver has been able to provide
WebDAV services since 1998 and is considered the de-facto
@@ -64,8 +64,8 @@
technical users appreciate network file-sharing), version
control features aren't interesting or necessary for most users.
Finally, some have argued that DeltaV remains unpopular because
- there's still no open-source server product which implements
- it.</para>
+ there's still no well-known open-source server product which
+ implements it well.</para>
<para>When Subversion was still in its design phase, it seemed
like a great idea to use Apache as a network server. It already
@@ -119,7 +119,7 @@
standard. A typical DeltaV server will reject an ignorant
WebDAV client attempting to do a <literal>PUT</literal> to a
file that's under version control. To change a
- version-controlled file, the server expects a series proper
+ version-controlled file, the server expects a series of proper
versioning requests: something like
<literal>MKACTIVITY</literal>, <literal>CHECKOUT</literal>,
<literal>PUT</literal>, <literal>CHECKIN</literal>. But if the
@@ -131,15 +131,16 @@
ordinary WebDAV clients that don't understand versioning.</para>
<para>Because so many operating systems already have integrated
- WebDAV clients, the use case for this feature borders on
- fantastical: 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 versioning everything. Any administrator (or
- knowledgeable user) can still use a Subversion client to search
- history and retrieve older versions of data.</para>
+ WebDAV clients, the use case for this feature can be incredibly
+ appealing to administrators working with non-technical users:
+ 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
+ versioning everything. Any administrator (or knowledgeable
+ user) can still use a Subversion client to search history and
+ retrieve older versions of data.</para>
<para>This scenario isn't fiction: it's real and it works, as of
Subversion 1.2 and later. To activate autoversioning in
@@ -251,7 +252,7 @@
<tbody>
<row>
<entry>Adobe Photoshop</entry>
- <entry>Standalone WebDAV applications</entry>
+ <entry>Standalone WebDAV application</entry>
<entry>X</entry>
<entry></entry>
<entry></entry>
@@ -260,7 +261,7 @@
</row>
<row>
<entry>Cadaver</entry>
- <entry>Standalone WebDAV applications</entry>
+ <entry>Standalone WebDAV application</entry>
<entry></entry>
<entry>X</entry>
<entry>X</entry>
@@ -269,24 +270,43 @@
</row>
<row>
<entry>DAV Explorer</entry>
- <entry>Standalone WebDAV applications</entry>
+ <entry>Standalone WebDAV application</entry>
<entry>X</entry>
<entry>X</entry>
<entry>X</entry>
<entry>Java GUI tool for exploring WebDAV shares</entry>
</row>
<row>
- <entry>davfs2</entry>
- <entry>WebDAV filesystem implementation</entry>
+ <entry>Macromedia Dreamweaver</entry>
+ <entry>Standalone WebDAV application</entry>
+ <entry>X</entry>
<entry></entry>
<entry></entry>
+ <entry>Web production software able to directly read from
+ and write to WebDAV URLs</entry>
+ </row>
+ <row>
+ <entry>Microsoft Office</entry>
+ <entry>Standalone WebDAV application</entry>
<entry>X</entry>
- <entry>Linux file system driver that allows you to mount a
- WebDAV share</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>Office productivity suite with several components
+ able to directly read from and write to WebDAV
+ URLs</entry>
+ </row>
+ <row>
+ <entry>Microsoft Web Folders</entry>
+ <entry>File-explorer WebDAV extension</entry>
+ <entry>X</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>GUI file explorer program able to perform tree
+ operations on a WebDAV share</entry>
</row>
<row>
<entry>GNOME Nautilus</entry>
- <entry>File-explorer WebDAV extensions</entry>
+ <entry>File-explorer WebDAV extension</entry>
<entry></entry>
<entry></entry>
<entry>X</entry>
@@ -295,7 +315,7 @@
</row>
<row>
<entry>KDE Konqueror</entry>
- <entry>File-explorer WebDAV extensions</entry>
+ <entry>File-explorer WebDAV extension</entry>
<entry></entry>
<entry></entry>
<entry>X</entry>
@@ -312,34 +332,6 @@
WebDAV shares.</entry>
</row>
<row>
- <entry>Macromedia Dreamweaver</entry>
- <entry>Standalone WebDAV applications</entry>
- <entry>X</entry>
- <entry></entry>
- <entry></entry>
- <entry>Web production software able to directly read from
- and write to WebDAV URLs</entry>
- </row>
- <row>
- <entry>Microsoft Office</entry>
- <entry>Standalone WebDAV applications</entry>
- <entry>X</entry>
- <entry></entry>
- <entry></entry>
- <entry>Office productivity suite with several components
- able to directly read from and write to WebDAV
- URLs</entry>
- </row>
- <row>
- <entry>Microsoft Web Folders</entry>
- <entry>File-explorer WebDAV extensions</entry>
- <entry>X</entry>
- <entry></entry>
- <entry></entry>
- <entry>GUI file explorer program able to perform tree
- operations on a WebDAV share</entry>
- </row>
- <row>
<entry>Novell NetDrive</entry>
<entry>WebDAV filesystem implementation</entry>
<entry>X</entry>
@@ -358,6 +350,15 @@
allows the assignment of Windows drive letters to a
mounted remote WebDAV share</entry>
</row>
+ <row>
+ <entry>davfs2</entry>
+ <entry>WebDAV filesystem implementation</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>X</entry>
+ <entry>Linux file system driver that allows you to mount a
+ WebDAV share</entry>
+ </row>
</tbody>
</tgroup>
@@ -367,10 +368,9 @@
<sect2 id="svn.webdav.clients.standalone">
<title>Standalone WebDAV applications</title>
- <para>A WebDAV application is a program which contains built-in
- functionality for speaking WebDAV protocols with a WebDAV
- server. We'll cover some of the most popular programs with
- this kind of WebDAV support.</para>
+ <para>A WebDAV application is a program which speakes WebDAV
+ protocols with a WebDAV server. We'll cover some of the most
+ popular programs with this kind of WebDAV support.</para>
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
<sect3 id="svn.webdav.clients.standalone.windows">
@@ -405,16 +405,17 @@
<para>Cadaver is a bare-bones Unix commandline program for
browsing and changing WebDAV shares. Like the Subversion
- client, it uses the neon HTTP library—not surprisingly,
- both neon and cadaver are written by the same author. Cadaver
- is free software (GPL license) and is available at <ulink
- url="http://www.webdav.org/cadaver/"/>.</para>
+ client, it uses the neon HTTP library—not
+ surprisingly, since both neon and cadaver are written by the
+ same author. Cadaver is free software (GPL license) and is
+ available at
+ <ulink url="http://www.webdav.org/cadaver/"/>.</para>
<para>Using cadaver is similar to using a commandline 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, copy, move, lock or
- unlock files:</para>
+ pinch, and also to examine properties, and to copy, move,
+ lock or unlock files:</para>
<screen>
$ cadaver http://host/repos
@@ -460,15 +461,15 @@
<para>Some popular file explorer GUI programs support WebDAV
extensions which allow a user to browse a DAV share as if it
- was just another directory on the local computer, and allowing
- 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 ordinary
- applications. All DAV interaction must happen through the
- explorer interface.</para>
+ 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
+ ordinary applications. All DAV interaction must happen
+ through the explorer interface.</para>
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
<sect3 id="svn.webdav.clients.file-explorer-extensions.windows">
@@ -593,7 +594,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 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
Modified: trunk/src/en/book/copyright.xml
==============================================================================
--- trunk/src/en/book/copyright.xml (original)
+++ trunk/src/en/book/copyright.xml Sun Aug 12 20:30:22 2007
@@ -3,7 +3,7 @@
<programlisting>
-Copyright (c) 2002-2006
+Copyright (c) 2002-2007
Ben Collins-Sussman, Brian W. Fitzpatrick, C. Michael Pilato.
This work is licensed under the Creative Commons Attribution License.
More information about the svnbook-dev
mailing list