<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>Say</title><revhistory><revision><revnumber>5</revnumber><date>2012-12-04 21:24:45</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>4</revnumber><date>2012-12-04 21:22:51</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>3</revnumber><date>2012-12-04 21:22:32</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>2</revnumber><date>2012-12-04 21:07:25</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>1</revnumber><date>2012-12-04 21:07:10</date><authorinitials>Inanna</authorinitials></revision></revhistory></articleinfo><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>say &quot;message&quot;</para><para>say &quot;[language#] message&quot; </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>say &quot;Your city is under attack.&quot;</para><para>say &quot;es# Tu ciudad esta siendo atacada.&quot; </para></entry></row></tbody></tgroup></informaltable><para>Allows you to instruct the bot to say outloud a given message using the operating system's built-in text-to-speech reader. The say command can be used with expressions and thus requires use of quotation marks around all you want it to say, so that it can differentiate between your string and a variable.  </para><para>An optional language value can be given to use that language by the TTS reader. In the 2nd example above, the bot would say the sentence <emphasis>Tu ciudad esta siendo atacada. (Your city is under attack)</emphasis> with a Spanish accent and voice as determined by the language value <emphasis>es</emphasis>.  </para><para>An example of a useful line for a defensive script would be: </para><screen><![CDATA[say city.name + " has " + city.NumberOfRealAttacks + " incoming attacks"]]></screen><para>You can see a list of language codes here: <ulink url="http://www.loc.gov/standards/iso639-2/php/code_list.php"/> (please note that your TTS reader may not suppose all of these!) The bot will use the two character ones, for example: de for german, es for spanish, en for english, etc. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="http://guide.neatportal.com/wiki/Say/wiki/ScriptControlStructures#">ScriptControlStructures</ulink> </para></article>