diff --git a/docs/curl.1 b/docs/curl.1 index 7d741aca4..1849f3a93 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -129,20 +129,24 @@ document, it returns a HTML document stating so (which often also describes why and more). This flag will prevent curl from outputting that and fail silently instead. .IP "-F/--form " -(HTTP) -This lets curl emulate a filled in form in which a user has pressed -the submit button. This causes curl to POST data using the -content-type multipart/form-data according to RFC1867. This enables -uploading of binary files etc. To force the 'content' part to be -read from a file, prefix the file name with an @ sign. Example, to -send your password file to the server, where 'password' is the -name of the form-field to which /etc/passwd will be the input: +(HTTP) This lets curl emulate a filled in form in which a user has pressed the +submit button. This causes curl to POST data using the content-type +multipart/form-data according to RFC1867. This enables uploading of binary +files etc. To force the 'content' part to be be a file, prefix the file name +with an @ sign. To just get the content part from a file, prefix the file name +with the letter <. The difference between @ and < is then that @ makes a file +get attached in the post as a file upload, while the < makes a text field and +just get the contents for that text field from a file. + +Example, to send your password file to the server, where +'password' is the name of the form-field to which /etc/passwd will be the +input: .B curl -F password=@/etc/passwd www.mypasswords.com To read the file's content from stdin insted of a file, use - where the file -name should've been. +name should've been. This goes for both @ and < constructs. .IP "-h/--help" Usage help. .IP "-H/--header
" @@ -594,6 +598,7 @@ If you do find any (or have other suggestions), mail Daniel Stenberg - David LeBlanc - Rich Gray at Plus Technologies - Luong Dinh Dung + - Torsten Foertsch .SH WWW http://curl.haxx.se