1\name{updateStatus}
2\Rdversion{1.1}
3\alias{updateStatus}
4\alias{deleteStatus}
5\alias{tweet}
6\title{
7  Functions to manipulate Twitter status
8}
9\description{
10  These functions can be used to set or delete a user's Twitter status
11}
12\usage{
13tweet(text, ...)
14updateStatus(text, lat=NULL, long=NULL, placeID=NULL,
15             displayCoords=NULL, inReplyTo=NULL, mediaPath=NULL,
16             bypassCharLimit=FALSE, ...)
17deleteStatus(status, ...)
18}
19\arguments{
20  \item{text}{The text to use for a new status }
21  \item{status}{An object of class \code{\link{status}}}
22  \item{lat}{If not \code{NULL}, the latitude the status refers to.  Ignored if no \code{long}
23  	parameter is provideded}
24  \item{long}{If not \code{NULL}, the longitude the status refers to.  Ignored if no \code{lat}
25  	parameter is provideded}
26  \item{placeID}{If not \code{NULL}, provideds a place in the world.  See Twitter documentation for details}
27  \item{displayCoords}{Whether or not to put a pin on the exact coordinates a tweet has been sent from,
28        \code{true} or \code{false} if not \code{NULL}}
29  \item{inReplyTo}{If not \code{NULL}, denotes the status this is in reply to.  Either an object of
30        class \code{\link{status}} or an ID value}
31  \item{mediaPath}{If not \code{NULL}, file path to a supported media format (PNG, JPG and GIF) to be included in the status update}
32  \item{bypassCharLimit}{If \code{TRUE} will not enforce the incoming tweet is less than 140 characters. This can be useful when dealing with autoshortened links}
33  \item{...}{Optional arguments to be passed to \code{\link{GET}}}
34}
35\details{
36  These messages will only operate properly if the user is authenticated
37  via \code{OAuth}
38
39  The \code{tweet} and \code{updateStatus} functions are the same.
40
41  To delete a status message, pass in an object of class
42  \code{\link{status}}, such as from the return value of \code{updateStatus}.
43}
44\value{
45  The \code{updateStatus} function will return an object of class
46  \code{\link{status}}.
47
48  The \code{deleteStatus} returns \code{TRUE} on success and an error if
49  failure occurs.
50}
51\author{
52   Jeff Gentry
53}
54\examples{
55   \dontrun{
56      ns <- updateStatus('this is my new status message')
57      ## ooops, we want to remove it!
58      deleteStatus(ns)
59   }
60}
61\keyword{ interface }
62