[Use Danya's io.sgml
Jonas Eschenburg <indyjo@gmx.de>**20071226221831] {
hunk ./debian/io.sgml 1
-<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
-
-<!-- Based on an example constructed by Colin Watson
-     <email>cjwatson@debian.org</email>, based on a man page template
-     provided by Tom Christiansen <email>tchrist@jhereg.perl.com</email>
-     and a DocBook man page example by Craig Small
-     <email>csmall@debian.org</email>.
-  -->
-
-  <!-- Fill in the various UPPER CASE things here. -->
-  <!ENTITY manfirstname "<firstname>Jonas</firstname>">
-  <!ENTITY mansurname   "<surname>Eschenburg</surname>">
-  <!-- Please adjust the date whenever revising the manpage. -->
-  <!ENTITY mandate      "<date>2007-12-08</date>">
-  <!-- SECTION should be 1-8, maybe with subsection. Other parameters are
-       allowed: see man(7), man(1). -->
-  <!ENTITY mansection   "<manvolnum>1</manvolnum>">
-  <!ENTITY manemail     "<email>indyjo@gmx.de</email>">
-  <!ENTITY manucpackage "<refentrytitle>io</refentrytitle>">
-  <!ENTITY manpackage   "io">
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.3//EN" [
+	<!ENTITY manfirstname "<firstname>Danya</firstname>">
+	<!ENTITY mansurname	"<surname>Alexeyevsky</surname>">
+	<!ENTITY manfullname	"&manfirstname; &mansurname;">
+	<!ENTITY mandate	"2007-12-17">
+	<!ENTITY manemail	"<email>me.dendik@gmail.com</email>">
+	<!ENTITY manbinary	"io">
+	<!ENTITY manio	"Io">
+	<!ENTITY manpackage	"iolanguage">
hunk ./debian/io.sgml 11
+
hunk ./debian/io.sgml 13
-  <refentryinfo>
-    <authorgroup>
-      <author>
-        <firstname>Bram</firstname>
-	<surname>Neijt</surname>
-      </author>
-      <author>
-        <firstname>Jonas</firstname>
-	<surname>Eschenburg</surname>
-      </author>
-    </authorgroup>
-    <copyright>
-      <year>2007</year>
-      <holder>Bram Neijt</holder>
-      <holder>Jonas Eschenburg</holder>
-    </copyright>
-    &mandate;
-  </refentryinfo>
-  <refmeta>
-    &manucpackage;
hunk ./debian/io.sgml 14
-    &mansection;
-  </refmeta>
-  <refnamediv>
-    <refname>&manpackage;</refname>
+	<refentryinfo>
+		<address>&manemail;</address>
+		<author>&manfullname;</author>
+		<!--
+		<copyright><year>2007</year> <holder>&manfullname;</holder></copyright>
+		-->
+		<date>&mandate;</date>
+	</refentryinfo>
+
+	<refmeta>
+		<refentrytitle>&manbinary;</refentrytitle>
+		<manvolnum>1</manvolnum>
+	</refmeta>
+
+	<refnamediv>
+		<refname>&manpackage;</refname>
+		<refpurpose>Io Programming Lanuage interperter</refpurpose>
+	</refnamediv>
+
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>&manbinary;</command>
+			<arg><option>-i</option></arg>
+			<arg rep="repeat" choice="opt"><replaceable>input file</replaceable></arg>
+		</cmdsynopsis>
+		<cmdsynopsis>
+			<command>&manbinary;</command>
+			<arg choice="req"><option>-e</option></arg>
+			<arg rep="repeat" choice="opt"><replaceable>expression</replaceable></arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+
+	<refsect1>
+		<title>DESCRIPTION</title>
+		<para><command>&manbinary;</command> is the &manio;
+		Programming Language interperter and the main entry point for
+		the iovm.</para>
+		<para>In the first form &manbinary; executes each of the
+		files specified on the command line.</para>
+		<para>If <option>-i</option> is specified or no input files
+		are given, &manbinary; then runs interactive interpreter.
+		<para>If &manbinary; goes interactive given input files, it
+		attempts to load <filename>main.io</filename> before
+		displaying the command prompt. It may be useful for some
+		common setup for interactive sessions.</para>
+		<para>In the second form &manbinary; evaluates the expression
+		given on the command line and prints the resulting
+		value.</para>
+	</refsect1>
+
+	<refsect1>
+		<title>OPTIONS</title>
+		<variablelist>
+			<varlistentry>
+				<term><option>-i</option></term>
+				<listitem><para>Go interactive after executing the files
+				on the command line.</para>
+			</varlistentry>
+			<varlistentry>
+				<term><option>-e</option></term>
+				<listitem><para>Treat arguments as an &manio; expression
+				and evaluate it. Print the result on the standard
+				output.</para>
+			</varlistentry>
+		</variablelist>
+	</refsect1>
+
+	<refsect1>
+		<title>FILES</title>
+		<variablelist>
+			<varlistentry>
+				<term><filename>main.io</filename></term>
+				<listitem><para>If exists, this file is sourced if
+				&manio; is going interactive and no files are specified
+				on the command line.</para></listitem>
+			</varlistentry>
+			<varlistentry>
+				<term><filename>~/.iorc</filename></term>
+				<listitem><para>If exists, this file is executed first,
+				before executing any other files or expressions on the
+				command line.</para></listitem>
+			</varlistentry>
+		</variablelist>
+	</refsect1>
+
+<!--
+	<refsect1>
+		<title>ENVIRONMENT</title>
+		<para></para>
+	</refsect1>
+-->
hunk ./debian/io.sgml 106
-    <refpurpose>Io Programming Language interpreter</refpurpose>
-  </refnamediv>
-  <refsynopsisdiv>
-    <cmdsynopsis>
-      <command>&manpackage;</command>
-      <arg choice="opt">-i</arg>
-      <group choice="opt">
-        <arg>-e<arg rep="repeat"><replaceable>command</replaceable></arg></arg>
-	<arg><replaceable>input file</replaceable></arg>
-      </group>
-    </cmdsynopsis>
-  </refsynopsisdiv>
-  <refsect1>
-    <title>DESCRIPTION</title>
-    <para><command>&manpackage;</command> is the Io Programming Language interpreter.
-    </para>
-  </refsect1>
-  <refsect1>
-    <title>OPTIONS</title>
+	<refsect1>
+		<title>RETURN VALUE</title>
+		<para>Return value is determined by program code. Unless call to
+		exit is explicitly made, return code is always 0.</para>
+	</refsect1>
hunk ./debian/io.sgml 112
-    <para>When called without any arguments, the interpreter will enter interactive mode.</para>
-    <variablelist>
-      <varlistentry>
-        <term>-i</term>
-	<listitem><para>Interactive mode. Start an interactive session after processing the given commands or file.</para></listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>-e</term>
-	<listitem><para>Perform the io commands commands given on the command line. This will cause all succeeding arguments to be treated as Io statements.</para></listitem>
-      </varlistentry>
-      
-    </variablelist>
+	<refsect1>
+		<title>AUTHOR</title>
+		<para>Steve Dekorte. For more information on the io interperter, please
+		visit <uri>http://www.iolanguage.com/</uri>. </para>
+	</refsect1>
hunk ./debian/io.sgml 118
-  </refsect1>
-  
-  <refsect1>
-    <title>NOTES</title>
+<!--
+	<refsect1>
+		<title>SEE ALSO</title>
+		<para></para>
+	</refsect1>
+-->
hunk ./debian/io.sgml 125
-    <para>For more information on the Io language and the Io interpreter, please visit http://www.iolanguage.com/</para>
-  </refsect1>
}