vmx: nanosec(): fix non-interruptable temporary, assign fasthz only once after xstart

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

diff --git a/sys/man/1/hget b/sys/man/1/hget
index 1b2f0fce1189137a0f763c94202ee46e634301b1..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
 [
@@ -31,10 +31,10 @@ hget, hpost, urlencode \- retrieve, post to a web page corresponding to a url
 ] [
 .B -g
 .I action
-] [
+|
 .B -p
 .I action
-] [
+|
 .B -m
 .I action
 ] [
@@ -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,12 +171,26 @@ 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
+.B -m
+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.
@@ -186,15 +205,15 @@ Retrieve the commands needed to submit a form, which may then be
 edited and sent.
 .IP
 .EX
-% hpost -l http://p.intma.in
-/bin/hpost -l -u http://p.intma.in -p paste.cgi text:
+% hpost http://p.intma.in
+hpost -u http://p.intma.in -p paste.cgi text:
 .EE
 .PP
 Manually specify fields to be sent to a given
 .I url.
 .IP
 .EX
-% hpost -l -u http://p.intma.in -p paste.cgi text:'test post'
+% hpost -u http://p.intma.in -p paste.cgi text:'test post'
 .EE
 .PP
 Upload a file, print the resulting URL
@@ -202,19 +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 webfs (4),
+.IR ftpfs (4),
+.IR file (1)
 .SH DIAGNOSTICS
-.I Hget
-requires 
+.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).