Author: markt Date: Fri Nov 23 11:02:38 2007 New Revision: 597719 URL: http://svn.apache.org/viewvc?rev=597719&view=rev Log: Update WebDAV javadocs as a result of bug 43893
Modified: tomcat/trunk/java/org/apache/catalina/servlets/WebdavServlet.java Modified: tomcat/trunk/java/org/apache/catalina/servlets/WebdavServlet.java URL: http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/servlets/WebdavServlet.java?rev=597719&r1=597718&r2=597719&view=diff ============================================================================== --- tomcat/trunk/java/org/apache/catalina/servlets/WebdavServlet.java (original) +++ tomcat/trunk/java/org/apache/catalina/servlets/WebdavServlet.java Fri Nov 23 11:02:38 2007 @@ -67,7 +67,49 @@ /** * Servlet which adds support for WebDAV level 2. All the basic HTTP requests - * are handled by the DefaultServlet. + * are handled by the DefaultServlet. The WebDAVServlet must not be used as the + * default servlet (ie mapped to '/') as it will not work in this configuration. + * To enable WebDAV for a context add the following to web.xml:<br/><code> + * <servlet><br/> + * <servlet-name>webdav</servlet-name><br/> + * <servlet-class>org.apache.catalina.servlets.WebdavServlet</servlet-class><br/> + * <init-param><br/> + * <param-name>debug</param-name><br/> + * <param-value>0</param-value><br/> + * </init-param><br/> + * <init-param><br/> + * <param-name>listings</param-name><br/> + * <param-value>true</param-value><br/> + * </init-param><br/> + * </servlet><br/> + * <servlet-mapping><br/> + * <servlet-name>webdav</servlet-name><br/> + * <url-pattern>/*</url-pattern><br/> + * </servlet-mapping> + * </code> + * <p/> + * This will enable read only access. To enable read-write access add:<br/> + * <code> + * <init-param><br/> + * <param-name>readonly</param-name><br/> + * <param-value>false</param-value><br/> + * </init-param><br/> + * </code> + * <p/> + * To make the content editable via a different URL, using the following + * mapping:<br/> + * <code> + * <servlet-mapping><br/> + * <servlet-name>webdav</servlet-name><br/> + * <url-pattern>/webdavedit/*</url-pattern><br/> + * </servlet-mapping> + * </code> + * <p/> + * Don't forget to secure access appropriately to the editing URLs. With this + * configuration the context will be accessible to normal users as before. Those + * users with the necessary access will be able to edit content available via + * http://host:port/context/content using + * http://host:port/context/webdavedit/content * * @author Remy Maucherat * @version $Revision$ $Date$ @@ -326,7 +368,6 @@ * @param request The servlet request we are processing */ protected String getRelativePath(HttpServletRequest request) { - // Are we being processed by a RequestDispatcher.include()? if (request.getAttribute(Globals.INCLUDE_REQUEST_URI_ATTR) != null) { String result = (String) request.getAttribute( --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]