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

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

[Giovanni Funchal]

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 also added a header for the "testing" section.

Signed-off-by: Giovanni Funchal <gafunchal@gmail.com>
---

davfs2 seems pretty stable and performance is quite good.

 Documentation/howto/setup-git-server-over-http.txt |   19 ++++++++++++++++---
 1 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/Documentation/howto/setup-git-server-over-http.txt b/Documentation/howto/setup-git-server-over-http.txt
index 4032748..cde6f56 100644
--- a/Documentation/howto/setup-git-server-over-http.txt
+++ b/Documentation/howto/setup-git-server-over-http.txt
@@ -164,6 +164,10 @@ Now go to http://<username>@<servername>/my-new-repo.git in your
 browser to check whether it asks for a password and accepts the right
 password.
 
+
+Step 2 1/2: testing your WebDAD server
+--------------------------------------
+
 On Debian:
 
    To test the WebDAV part, do:
@@ -173,9 +177,18 @@ On Debian:
 
    Most tests should pass.
 
-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 monting 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://...".
 
 If you're into Windows, from XP onwards Internet Explorer supports
 WebDAV. For this, do Internet Explorer -> Open Location ->
-- 
1.5.4.3

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

[Marcus Griep]

Giovanni Funchal wrote:
> +++ b/Documentation/howto/setup-git-server-over-http.txt
> @@ -164,6 +164,10 @@ Now go to http://<username>@<servername>/my-new-repo.git in your
> +
> +Step 2 1/2: testing your WebDAD server
> +--------------------------------------
> +

Typo? (s/WebDAD/WebDAV/)

> @@ -173,9 +177,18 @@ On Debian:
> +An alternative is to use davfs2, a driver that allows monting a WebDAV
> +resource into the system tree. This requires root access and kernel
> +support (probably your kernel includes this).

s/monting/mounting/

-- 
Marcus Griep
GPG Key ID: 0x5E968152
——
http://www.boohaunt.net
את.ψο´

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

[Giovanni Funchal]

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 also added a header for the "testing" section.

Signed-off-by: Giovanni Funchal <gafunchal@gmail.com>
---
 Documentation/howto/setup-git-server-over-http.txt |   19 ++++++++++++++++---
 1 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/Documentation/howto/setup-git-server-over-http.txt b/Documentation/howto/setup-git-server-over-http.txt
index 4032748..827eb43 100644
--- a/Documentation/howto/setup-git-server-over-http.txt
+++ b/Documentation/howto/setup-git-server-over-http.txt
@@ -164,6 +164,10 @@ Now go to http://<username>@<servername>/my-new-repo.git in your
 browser to check whether it asks for a password and accepts the right
 password.
 
+
+Step 2 1/2: testing your WebDAV server
+--------------------------------------
+
 On Debian:
 
    To test the WebDAV part, do:
@@ -173,9 +177,18 @@ On Debian:
 
    Most tests should pass.
 
-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://...".
 
 If you're into Windows, from XP onwards Internet Explorer supports
 WebDAV. For this, do Internet Explorer -> Open Location ->
-- 
1.6.0.6.g8822b

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

[Junio C Hamano]

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.

> +
> +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.

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

[Giovanni Funchal]

> Googling for "davfs2 WebDAV" returns 13,600 hits, while "cadaver WebDAV"
> hits 39,100.

Woops, sorry for that, in fact I greatly misunderstood the statement
"A command line tool to test WebDAV is cadaver." I though this meant
"The command line tool is dead / It does not exist anymore". I didn't
realize "cadaver" was its name!

> In addition, testing with davfs2 requires you to have root access.

When davfs2 is properly configured, the file system can be mounted in
user space by non-root users. Root access is needed only when
installing. Cadaver also needs root access for installation,

-- Giovanni

On Tue, Aug 19, 2008 at 7:57 AM, Junio C Hamano <gitster@pobox.com> wrote:
> 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.
>
>> +
>> +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.
>
>
>

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

[Junio C Hamano]

"Giovanni Funchal" <gafunchal@gmail.com> writes:

>> In addition, testing with davfs2 requires you to have root access.
>
> When davfs2 is properly configured, the file system can be mounted in
> user space by non-root users. Root access is needed only when
> installing.

Ok, then I misread your description.  This part should be clarified:

>>> +An alternative is to use davfs2, a driver that allows mounting a WebDAV
>>> +resource into the system tree. This requires root access and kernel

s/This/Installing this module/;

>>> +support (probably your kernel includes this).
>>> +
>>> +  $ apt-get install davfs2

s/\$ /# /;

>>> +  $ mkdir -p /mnt/webdav

ditto.

>>> +  $ mount -t davfs http://<servername>/ /mnt/webdav
>>> +  $ ls /mnt/webdav
>>> +  $ umount /mnt/webdav