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 70a094b919219ca1ccd14b01e2ec487a30be2e87..c4238344a6a893d72db051e49a2a17e30fc05d8b 100644 (file)
--- a/sys/man/1/hget
+++ b/sys/man/1/hget
@@ -1,6 +1,6 @@
 .TH HGET 1
 .SH NAME
-hget, hpost \- 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 \- retrieve, post to a web page corresponding to a url
 ] [
 .B -g
 .I action
-] [
+|
 .B -p
 .I action
-] [
+|
 .B -m
 .I action
 ] [
@@ -47,6 +47,18 @@ hget, hpost \- retrieve, post to a web page corresponding to a url
 .I name@file
 ]
 .I ...
+.PP
+.B webpaste
+[
+.I file
+]
+.PP
+.B urlencode
+[
+.B -d
+] [
+.I file
+]
 .SH DESCRIPTION
 .I Hget
 retrieves the web page specified by the URL
@@ -88,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
@@ -137,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
@@ -148,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
@@ -159,7 +171,29 @@ 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, 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.
 .SH EXAMPLES
 Download a file from the web.
 .IP
@@ -171,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
@@ -187,17 +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).