Added Torsten Foertsch's changes to the -F description and his name to the
authorDaniel Stenberg <daniel@haxx.se>
Tue, 25 Jul 2000 21:19:35 +0000 (21:19 +0000)
committerDaniel Stenberg <daniel@haxx.se>
Tue, 25 Jul 2000 21:19:35 +0000 (21:19 +0000)
list of contributors.

docs/curl.1

index 7d741ac..1849f3a 100644 (file)
@@ -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 <name=content>"
-(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 <header>"
@@ -594,6 +598,7 @@ If you do find any (or have other suggestions), mail Daniel Stenberg
  - David LeBlanc <dleblanc@qnx.com>
  - Rich Gray at Plus Technologies
  - Luong Dinh Dung <u8luong@lhsystems.hu>
+ - Torsten Foertsch <torsten.foertsch@gmx.net>
  
 .SH WWW
 http://curl.haxx.se