merge

[plan9front.git] / sys / man / 1 / hget

diff --git a/sys/man/1/hget b/sys/man/1/hget
index 4cbcafb12377f36b9659520b9cdc38af2375faf5..c4238344a6a893d72db051e49a2a17e30fc05d8b 100644 (file)
--- a/sys/man/1/hget
+++ b/sys/man/1/hget
@@ -1,6 +1,6 @@
 .TH HGET 1
 .SH NAME
-hget, hpost, urlencode \- retrieve, post to a web page corresponding to a url
+hget, hpost, webpaste, urlencode \- retrieve, post to a web page corresponding to a url
 .SH SYNOPSIS
 .B hget
 [
@@ -48,6 +48,11 @@ hget, hpost, urlencode \- retrieve, post to a web page corresponding to a url
 ]
 .I ...
 .PP
+.B webpaste
+[
+.I file
+]
+.PP
 .B urlencode
 [
 .B -d
@@ -95,10 +100,10 @@ option causes
 .I hget
 and
 .I hpost
-to print the location URL from the transactoin response
-instead of retriving the the body data. This is usefull
+to print the location URL from the transaction response
+instead of retrieving the body data. This is useful
 for HTTP POST transactions that redirect to a URL containing
-the prosted data so we wont refetch the data we just uploaded
+the posted data so we wont refetch the data we just uploaded
 to the site.
 .PP
 The
@@ -144,7 +149,7 @@ flags set the form method to GET and POST, respectively. The
 .B -m
 flag sets the form method to POST and its enctype to
 .B multipart/form-data.
-In all cases, the form action URL is set to
+In all cases, the target relative form action URL is set to
 .I action.
 .PP
 The
@@ -155,7 +160,7 @@ As the
 .I url
 parameter is always required, the
 .B -u
-flag can be omited when
+flag can be omitted when
 .I url
 follows directly after the last option if any.
 .PP
@@ -166,7 +171,7 @@ argument of the form
 .B name@file
 is interpreted as a file upload, with the information following the
 .B @
-symbol treated as the full path to the location of the file.
+symbol treated as the file name.
 For
 .B multipart/form-data
 uploads (see
@@ -175,10 +180,17 @@ flag), the file has to be seekable as
 .IR file (1)
 is invoked to determine its mime type.
 .PP
+.I Webpaste
+uploads the contents either of its standard input or
+.I file
+to the pastebin website
+.B http://okturing.com
+and then prints a URL where the contents may be retrieved.
+.PP
 .I Urlencode
 is a helper program to URL encode and decode files. The
 .B -d
-flag insead of encoding, decodes URL encoded file. If no
+flag, instead of encode, decodes URL encoded file. If no
 .I file
 is given, standard input is read. The resulting data
 is written to standard output.
@@ -194,7 +206,7 @@ edited and sent.
 .IP
 .EX
 % hpost http://p.intma.in
-/bin/hpost -u http://p.intma.in -p paste.cgi text:
+hpost -u http://p.intma.in -p paste.cgi text:
 .EE
 .PP
 Manually specify fields to be sent to a given
@@ -209,22 +221,46 @@ Upload a file, print the resulting URL
 .EX
 % hpost -l http://i.intma.in file@/tmp/screen.png | rc
 .EE
+.PP
+Upload the output of
+.IR ns (1)
+to
+.B http://okturing.com
+.IP
+.EX
+% ns | webpaste
+.EE
 .SH SOURCE
 .B /rc/bin/hget
 .br
 .B /rc/bin/hpost
 .br
+.B /rc/bin/webpaste
+.br
 .B /sys/src/cmd/urlencode.c
 .SH "SEE ALSO"
 .IR webfs (4),
 .IR ftpfs (4),
 .IR file (1)
 .SH DIAGNOSTICS
-.I Hget
-and
+.IR Hget ,
 .I hpost
+and
+.I webpaste
 require
 .IR webfs (4)
 service mounted on
 .B /mnt/web
 to work.
+.SH HISTORY
+.I Hget
+first appeared in Plan 9 from Bell Labs. It was
+rewritten as an
+.I rc
+script for 9front (January, 2012).
+.I Hpost
+and
+.I urlencode
+first appeared in 9front (October, 2012).
+.I Webpaste
+first appeared in 9front (September, 2013).