+ Note created at server
+ http://known.bogo/2016/img-url
+
+
+===============
+Delete/Undelete
+===============
+You may delete and restore posts on micropub servers::
+
+ $ ./bin/shpub.php delete http://known.bogo/2016/like
+
+Restore a deleted post::
+
+ $ ./bin/shpub.php undelete http://known.bogo/2016/like
+
+
+=======
+Updates
+=======
+Existing posts can be modified if the `server supports this`__::
+
+ $ ./bin/shpub update --add category=foo category=bar\
+ --replace slug=differentslug\
+ --delete category=oldcat\
+ http://known.bogo/2016/post
+
+__ https://indieweb.org/Micropub/Servers#Implementation_status
+
+
+============
+File uploads
+============
+Most post types allow file uploads. Simply use ``-f``::
+
+ $ ./bin/shpub.php note -f path/to/image.jpg "image test"
+ Note created at server
+ http://known.bogo/2016/image-test
+
+The media endpoint is used automatically if the micropub endpoint has one.
+To force shpub to directly upload the file and skip the media endpoint,
+use the ``--direct-upload`` option::
+
+ $ ./bin/shpub.php note --direct-upload -f path/to/image.jpg "direct upload"
+
+Use the ``upload`` command to upload files to the media endpoint without
+creating a post::
+
+ $ ./bin/shpub.php upload /path/to/file.jpg /path/to/file2.jpg
+ Uploaded file /path/to/file.jpg
+ http://test.bogo/micropub-media-endpoint/1474362040.2941/file.jpg
+ Uploaded file /path/to/file2.jpg
+ http://test.bogo/micropub-media-endpoint/1474362040.3383/file2.jpg
+
+
+=========
+Debugging
+=========
+To debug ``shpub`` or your micropub endpoint, use the ``--debug`` option
+to see ``curl`` command equivalents to the shpub HTTP requests::
+
+ $ ./bin/shpub.php -s known -d note "a simple note"
+ curl -X POST -H 'User-Agent: shpub' -H 'Content-Type: application/x-www-form-urlencoded' -H 'Authorization: Bearer abc' -d 'h=entry' -d 'content=a simple note' 'http://known.bogo/micropub/endpoint'
+ Post created at server
+ http://known.bogo/2016/a-simple-note
+
+
+===========
+About shpub
+===========
+shpub's homepage is http://cweiske.de/shpub.htm
+
+
+Source code
+===========
+shpub's source code is available from http://git.cweiske.de/shpub.git
+or the `mirror on github`__.
+
+__ https://github.com/cweiske/shpub
+
+
+License
+=======
+shpub is licensed under the `AGPL v3 or later`__.
+
+__ http://www.gnu.org/licenses/agpl.html
+
+
+Author
+======
+shpub was written by `Christian Weiske`__.
+
+__ http://cweiske.de/