webapi.txt: explain POST /uri/?t=upload, thanks to Toby Murray for the catch

diff --git a/docs/frontends/webapi.txt b/docs/frontends/webapi.txt
index 330ebfdc94fec409e71dd4a8fbba9c7232bb0779..8cc9288f63c2b987b4189cae8d786284886a03d2 100644 (file)
--- a/docs/frontends/webapi.txt
+++ b/docs/frontends/webapi.txt
@@ -670,6 +670,11 @@ POST /uri/$DIRCAP/[SUBDIRS../]FILENAME?t=upload
 
 POST /uri/$FILECAP?t=upload
 
+ This modifies the contents of an existing mutable file in-place. An error is
+ signalled if $FILECAP does not refer to a mutable file. It behaves just like
+ the "PUT /uri/$FILECAP" form, but uses a POST for the benefit of HTML forms
+ in a web browser.
+
 === Attaching An Existing File Or Directory (by URI) ===
 
 POST /uri/$DIRCAP/[SUBDIRS../]?t=uri&name=CHILDNAME&uri=CHILDCAP