moparisthebest
/
wget
mirror of https://github.com/moparisthebest/wget
1
0
Fork 0
Code Issues Releases Wiki Activity

Clarify operation of --post-file.

This commit is contained in:
Micah Cowan 2009-07-06 23:12:06 -07:00
parent 532aa2cb2d
commit 0b4470b5e7
2 changed files with 15 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/ChangeLog
View File

@ -4,6 +4,7 @@
--input-file, implying that --force-html isn't necessary when the
input is in HTML file. Improve accuracy of --base description.
(Wgetrc Commands): Improve accuracy of "base" description.
(HTTP Options): Clarify operation of --post-file.
2009-07-03 Micah Cowan <micah@cowan.name>

18
doc/wget.texi
View File

@ -1394,10 +1394,20 @@ not to send the @code{User-Agent} header in @sc{http} requests.
@cindex POST
@item --post-data=@var{string}
@itemx --post-file=@var{file}
Use POST as the method for all HTTP requests and send the specified data
in the request body. @code{--post-data} sends @var{string} as data,
whereas @code{--post-file} sends the contents of @var{file}. Other than
that, they work in exactly the same way.
Use POST as the method for all HTTP requests and send the specified
data in the request body. @samp{--post-data} sends @var{string} as
data, whereas @samp{--post-file} sends the contents of @var{file}.
Other than that, they work in exactly the same way. In particular,
they @emph{both} expect content of the form @code{key1=value1&key2=value2},
with percent-encoding for special characters; the only difference is
that one expects its content as a command-line paramter and the other
accepts its content from a file. In particular, @samp{--post-file} is
@emph{not} for transmitting files as form attachments: those must
appear as @code{key=value} data (with appropriate percent-coding) just
like everything else. Wget does not currently support
@code{multipart/form-data} for transmitting POST data; only
@code{application/x-www-form-urlencoded}. Only one of
@samp{--post-data} and @samp{--post-file} should be specified.
Please be aware that Wget needs to know the size of the POST data in
advance. Therefore the argument to @code{--post-file} must be a regular