diff --git a/man/tumblr.1 b/man/tumblr.1 index 724c866..582aa7d 100644 --- a/man/tumblr.1 +++ b/man/tumblr.1 @@ -21,17 +21,21 @@ If you preface your \fIFILE\fR with a bit of YAML () frontmatter, you .SH "OPTIONS" . .TP -\fB\-a\fR,\fB\-\-auth\fR [\fIEMAIL:PASSWORD\fR] +\fB\-a\fR,\fB\-\-auth\fR \fIEMAIL:PASSWORD\fR Provide Email Address and Password, to authenticate to Tumblr, separated by a colon. If these are not provided, you will be prompted for them. - You \fBmust\fR provide this argument if the post comes from standard input. + You \fBmust\fR provide this or the \fB\-\-credentials\fR argument if the post comes from standard input. . .TP -\fB\-e\fR, \fB\-\-email\fR [\fIEMAIL\fR] +\fB\-e\fR, \fB\-\-email\fR \fIEMAIL\fR Email Address associated with your Tumblr account. You will be prompted for a password. . .TP +\fB\-\-credentials\fR \fIFILE\fR + A YAML file with the user credentials. Should have keys \fBemail\fR and \fBpassword\fR. +. +.TP \fB\-p\fR,\fB\-\-publish\fR Publish the post immediately. This will ignore the \fBstate\fR parameter set in the post. . @@ -106,6 +110,33 @@ $ tumblr http://www.youtube.com/watch?v=CW0DUg63lqU . .IP "" 0 . +.P +Save it as a draft: +. +.IP "" 4 +. +.nf +$ tumblr \-d http://www.youtube.com/watch?v=CW0DUg63lqU +. +.fi +. +.IP "" 0 +. +.P +Authenticate with credentials given from a file: +. +.IP "" 4 +. +.nf +$ cat ~/.tumblrlogin +email: tumblruser@generic\-email.com +password: myvoiceismypassport +$ cat data.yml my_post.txt | tumblr \-\-credentials ~/.tumblrlogin +. +.fi +. +.IP "" 0 +. .SH "INSTALLATION" If you have RubyGems installed: . diff --git a/man/tumblr.1.html b/man/tumblr.1.html index 81e6995..757a774 100644 --- a/man/tumblr.1.html +++ b/man/tumblr.1.html @@ -80,11 +80,12 @@

DESCRIPTION

OPTIONS

-
-a,--auth [EMAIL:PASSWORD]

Provide Email Address and Password, to authenticate to Tumblr, separated by a colon. +

-a,--auth EMAIL:PASSWORD

Provide Email Address and Password, to authenticate to Tumblr, separated by a colon. If these are not provided, you will be prompted for them. - You must provide this argument if the post comes from standard input.

-
-e, --email [EMAIL]

Email Address associated with your Tumblr account. + You must provide this or the --credentials argument if the post comes from standard input.

+
-e, --email EMAIL

Email Address associated with your Tumblr account. You will be prompted for a password.

+
--credentials FILE

A YAML file with the user credentials. Should have keys email and password.

-p,--publish

Publish the post immediately. This will ignore the state parameter set in the post.

-q,--queue

Add the post to the queue.

-d,--draft

Save the post as a draft.

@@ -122,6 +123,19 @@

EXAMPLES

$ tumblr http://www.youtube.com/watch?v=CW0DUg63lqU
 
+

Save it as a draft:

+ +
$ tumblr -d http://www.youtube.com/watch?v=CW0DUg63lqU
+
+ +

Authenticate with credentials given from a file:

+ +
$ cat ~/.tumblrlogin
+email: tumblruser@generic-email.com
+password: myvoiceismypassport
+$ cat data.yml my_post.txt | tumblr --credentials ~/.tumblrlogin
+
+

INSTALLATION

If you have RubyGems installed: