Implemented the posting script

README

@@ -25,13 +25,13 @@ The tii repo consists of the following parts:
 Readiness status
 ----------------
 * tiifetch.tcl: ready/tested
-* tiipost.tcl: planned
+* tiipost.tcl: ready/tested
 * tiiview.tcl: ready/tested
 * tiidb (format): ready/tested
 * stations.txt (format): ready/tested
-* auth.txt (format): ready to be implemented
+* auth.txt (format): ready/tested
 * tiix.tcl: planned
-* Overall status: work in progress
+* Overall status: CLI-ready. work in progress for GUI
 
 Usage
 -----
@@ -106,6 +106,27 @@ filtering has been done. Also note that the search is done within all fields
 of the message. E.g. h100/retro will find the retro-themed messages among the
 first 100 of them.
 
+### Posting the messages from CLI (tiipost.tcl): ###
+
+echo my_post_text | tiipost.tcl station_root_url echo_name msgto subj [repto]
+
+The tiipost.tcl script accepts the message body from the standard input. The
+body must be provided in UTF-8 encoding and all command line parameters except
+[repto] (reply-to ID) are mandatory.
+
+The script will look for the auth.txt file in its directory, with the format:
+
+station_url_1 password1
+station_url_2 password2
+...
+
+If the station root URL matches one of the lines in auth.txt, it automatically
+will use the password as the authstring when posting to the station.
+
+On success, tiipost.tcl will output a message that starts with "Success", in
+case of an error the line will start with "Error". The server-side description
+will follow this success or error status.
+
 Message database format
 -----------------------
 The tiidb format is based upon the official ii/IDEC developer recommendations