Read Me

1. OVERVIEW

DAV Commander is partially based on DAV Explorer, developed at the University of
California, Irvine (http://www.davexplorer.org/).

DAV Commander is a WebDAV and DeltaV client application that uses the WebDAV,
DeltaV and ACL protocols to provide:
     A commander-style split view of a WebDAV server and your local fileystem 
     Upload and download of Web resources 
     Locking and unlocking of resources for collaboration support 
     Display all resource properties, or just lock properties 
     Copying collections and individual resources 
     Renaming of individual resources 
     Creating new collections 
     Delete collections or individual resources 
     Logging of protocol activity 
     Creating new versions of resources
     Checking out and checking in of resources
     Listing of resource versions
     Listing of Access Control information
     Adding and Modification of Access Control Lists
     ACL Reports

DAV Commander is a useful tool for interoperability testing a WebDAV server,
since it is capable of exercising the majority of the functionality
specified in RFC 2518, the WebDAV Distributed Authoring Protocol
specification, while logging the protocol stream. However, DAV Commander can
also be used for remote namespace management, and has collaboration support
for groups which employ a lock-download-work-upload-unlock authoring
process.
DAV Commander also supports the linear versioning of resources through the
use of RFC 3253, the DeltaV Versioning Extensions to WebDAV protocol specification.
DAV Commander supports the linear checkout, uncheckout, checkin, and reporting
functionality specified in the DeltaV specification.
DAV Commander also supports the WebDAV Access Control Protocol as specified
in RFC 3744.

DAV Commander also works as applet. Usage:
<applet archive="DAVCommander.jar"
    code="ch.oxinia.webdav.davcommander.AppletMain.class"
    width="100%"
    height=500>
    <param name="uri" value="https://myserver.com/myWebDavPath/">
    <param name="acl" value="false">
    <param name="versionControl" value="false">
    <param name="locking" value="false">
    <param name="davproperties" value="false">
    <param name="showTrees" value="false">
    <param name="multipleSelection" value="true">
    <param name="dragDrop" value="false">
    <param name="renameWithDoubleclick" value="false">
</applet>
The username and password parameters are optional for security reasons.
In fact, we consider it BAD PRACTICE to provide them in clear text on a
webpage, unless the webpage is accessible only through secure means, e.g.,
using SSL.
If they are not specified on the webpage, they are requested interactively.
The proxy parameter is optional and allows the automatic use of a proxy
server if specified.
The applet code also supports the use of SSL.
Since DAV Commander accesses restricted properties, the jar file is signed
to allow the use as applet.
When using JRE 1.4 and above, it may be required to run the JDK policy tool
program, policytool, before using DAV Commander as applet.
The policytool can set the permissions for the appropriate codebase,
http://my-url/DAVCommander.jar, to whatever DAV Commander needs. The easiest
is to allow All Permissions, but it can be set finer-grained, to set
Property Permissions, File Permissions, and Socket Permissions.


2. LICENSE

DAV Commander is released under the GNU General Public License. See the file
License.txt in the distribution for details.


3. SOURCE CODE

The source files are also available via Subversion at
https://davcommander.svn.sourceforge.net/svnroot/davcommander/
To retrieve the complete source tree, check out the trunk directory with your
favorite Subversion client tool.
The command line format:
svn checkout https://davcommander.svn.sourceforge.net/svnroot/davcommander/ davcommander

If the DAV Commander jar file is created from the source, it has to be
signed with the jarsigner tool before it can run as applet. The jar file
included in the binary distribution is signed by the DAV Commander Team.


4. COMMAND LINE OPTIONS

DAV Commander accepts the following command line options:

-Dhelp, -Dhelp=yes
  Prints a list of all options.
  
-Ddebug=option
  where option is one of:
  all          all function traces are enabled
  request      function traces related to HTTP requests are enabled
  response     function traces related to HTTP responses are enabled
  treeview     function traces related to the tree view on the left
  		side of the DAVCommander window are enabled
  treenode     function traces related to each node in the tree view
  		are enabled
  fileview     function traces related to the file view on the right
  		side of the DAVCommander window are enabled

-Dpropfind=allprop
  This option results in using the <allprop> tag in PROPFIND.
  
-DSSL=yes
  This option enables the use of SSL.
  NOTE: SSL support can also be enabled through an entry in the Edit menu.
  
-DSharePoint=yes
  This option enables a workaround for a bug in Microsoft's SharePoint
  server which allows tags to start with a digit.
  
-DApache=yes
  This option enables a workaround for a bug in Apache 1.3.x, which returns
  a 500 error in response to a PROPPATCH if the Host: header contains a
  port number.

-Dlocal=no
  This option prevents showing the local directory structure in the
  main DAV Commander window.

-Dcompress=no
  This option prevents DAV Commander from accepting compressed data.
  This is a workaround for a bug in MS Exchange that results in corrupt
  compressed data.


5. Contributors
The file contributors.txt contains a list of all contributors.
Thanks to everybody.


6. CHANGELOG