Re: [PATCH] Documentation: setup-git-server-over-http: Mention davfs2

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 19, 2008, 05:57 UTC
Message-ID: <7vwsidh7hi.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <1219095967-15971-1-git-send-email-gafunchal@gmail.com>

Giovanni Funchal <gafunchal@gmail.com> writes:

> I just came across an interesting file system driver that allows to mount
> WebDAV resources into file system tree: davfs2. I though it would be worth
> mentioning this on setup-git-server-over-http.txt.

I might agree with "It would be worth mentioning", but I do not think that is what you did.

Show 20 quoted lines

> +
> +Step 2 1/2: testing your WebDAV server
> +--------------------------------------
> +
> ...
> -A command line tool to test WebDAV is cadaver. If you prefer GUIs, for
> -example, konqueror can open WebDAV URLs as "webdav://..." or
> -"webdavs://...".
> +An alternative is to use davfs2, a driver that allows mounting a WebDAV
> +resource into the system tree. This requires root access and kernel
> +support (probably your kernel includes this).
> +
> +  $ apt-get install davfs2
> +  $ mkdir -p /mnt/webdav
> +  $ mount -t davfs http://<servername>/ /mnt/webdav
> +  $ ls /mnt/webdav
> +  $ umount /mnt/webdav
> +
> +If you prefer GUIs, for example, konqueror can open WebDAV URLs as
> +"webdav://..." or "webdavs://...".

You are dropping mention of cadaver and the only remaining suggestion for command line testing is via davfs2.

Googling for "davfs2 WebDAV" returns 13,600 hits, while "cadaver WebDAV" hits 39,100. In addition, testing with davfs2 requires you to have root access.

When troubleshooting a nonworking system, it often is easier to do it from a command line tool than from GUI (one of whose main point is to hide away the low-level details). And I thought the title of this semi-section was "Testing"?

Offering alternatives for command line tools is good, but that is not what this patch does.