docs: tweak wording per kpreid and tweak example filename extension per me

diff --git a/docs/webapi.txt b/docs/webapi.txt
index e1996189d16fe91e9852d8f126890812a4bba4b9..2a848e2770b2e324e61ed93bdbbc6f9c296b2220 100644 (file)
--- a/docs/webapi.txt
+++ b/docs/webapi.txt
@@ -60,10 +60,10 @@ In addition, each directory has a corresponding URL. The Pictures URL is:
 
 http://localhost:8123/uri/$PRIVATE_VDRIVE_URI/Pictures
 
-Note that all filenames are assumed to be UTF-8 encoded, so "resume.doc"
-(with an acute accent on both E's) would be accessed with:
+Note that all filenames in URLs are required to be UTF-8 encoded, so
+"resume.odt" (with an acute accent on both E's) would be accessed with:
 
- http://localhost:8123/uri/$PRIVATE_VDRIVE_URI/r%C3%A9sum%C3%A9.doc
+ http://localhost:8123/uri/$PRIVATE_VDRIVE_URI/r%C3%A9sum%C3%A9.odt
 
 The filenames inside upload POST forms are interpreted using whatever
 character set was provided in the conventional '_charset' field, and defaults