Fix markup to allow clean man pages.

Add new pages for programming languages and tcl shells.

doc/src/sgml/ref/createlang.sgml

@@ -0,0 +1,172 @@
+<!--
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.1 1999/08/06 13:50:30 thomas Exp $
+Postgres documentation
+-->
+
+<refentry id="APP-CREATELANG">
+ <refmeta>
+  <refentrytitle id="APP-CREATELANG-TITLE">
+   <application>createlang</application>
+  </refentrytitle>
+  <refmiscinfo>Application</refmiscinfo>
+ </refmeta>
+ <refnamediv>
+  <refname id="createlang">
+   <application>createlang</application>
+  </refname>
+  <refpurpose>
+   Add a new programming language to a <productname>Postgres</productname> database
+  </refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+  <refsynopsisdivinfo>
+   <date>1999-08-05</date>
+  </refsynopsisdivinfo>
+  <synopsis>
+createlang [ <replaceable class="parameter">langname</replaceable> ]
+createlang [ -h <replaceable class="parameter">host</replaceable> ] [ -p <replaceable class="parameter">port</replaceable> ]
+        [ <replaceable class="parameter">langname</replaceable> ]
+  </synopsis>
+
+  <refsect2 id="R2-APP-CREATELANG-1">
+   <title>
+    Inputs
+   </title>
+   <para>
+    <application>createlang</application> accepts the following command line arguments:
+    
+    <variablelist>
+     <varlistentry>
+      <term><replaceable class="parameter">langname</replaceable></term>
+      <listitem>
+       <para>
+	Specifies the name of the backend programming language to be defined.
+	<application>createlang</application> will prompt for
+	<replaceable class="parameter">langname</replaceable>
+	if it is not specified on the command line.
+       </para>
+      </listitem>
+     </varlistentry>
+    </variablelist>
+   </para>
+
+   <para>
+    <application>createlang</application> also accepts 
+    the following command line arguments for connection parameters:
+    
+    <variablelist>
+     <varlistentry>
+      <term>-h <replaceable class="parameter">host</replaceable></term>
+      <listitem>
+       <para>
+	Specifies the hostname of the machine on which the 
+	<application>postmaster</application>
+	is running.  Defaults to using a local Unix domain socket
+	rather than an IP connection.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term>-p <replaceable class="parameter">port</replaceable></term>
+      <listitem>
+       <para>
+	Specifies the Internet TCP/IP port or local Unix domain socket file 
+	extension on which the <application>postmaster</application>
+	is listening for connections.  The port number defaults to 5432,
+	or the value of the <envar>PGPORT</envar>
+	environment variable (if set).
+       </para>
+      </listitem>
+     </varlistentry>
+     <!--
+     <varlistentry>
+      <term>-u</term>
+      <listitem>
+       <para>
+	Use password authentication. 
+	Prompts for
+	<replaceable class="parameter">username</replaceable>
+	and <replaceable class="parameter">password</replaceable>.
+       </para>
+      </listitem>
+     </varlistentry>
+     -->
+    </variablelist>
+   </para>
+  </refsect2>
+
+  <refsect2 id="R2-APP-CREATELANG-2">
+   <refsect2info>
+    <date>1998-10-04</date>
+   </refsect2info>
+   <title>
+    Outputs
+   </title>
+   <para>
+    <application>createlang</application> installs a new programming
+    language into a <productname>Postgres</productname> server,
+    so has not explicit external output.
+   </para>
+  </refsect2>
+ </refsynopsisdiv>
+ 
+ <refsect1 id="R1-APP-CREATELANG-1">
+  <refsect1info>
+   <date>1998-10-04</date>
+  </refsect1info>
+  <title>
+   Description
+  </title>
+
+  <para>
+   <application>createlang</application> is a utility for adding a new 
+   programming language to a
+   <productname>Postgres</productname> database.
+   <application>createlang</application> currently accepts two
+   languages, <literal>plsql</literal> and <literal>pltcl</literal>.
+  </para>
+ </refsect1>
+
+ <refsect1 id="R1-APP-CREATELANG-2">
+  <title>
+   Notes
+  </title>
+
+  <para>
+   See 
+   <xref linkend="sql-createlanguage" endterm="sql-createlanguage-title">
+   for more details.
+  </para>
+ </refsect1>
+ 
+ <refsect1 id="R1-APP-CREATELANG-3">
+  <title>
+   Usage
+  </title>
+  <para>
+   To install <literal>pltcl</literal>:
+   
+   <programlisting>
+% createlang pltcl
+   </programlisting>
+  </para>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:nil
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:"../reference.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:"/usr/lib/sgml/catalog"
+sgml-local-ecat-files:nil
+End:
+-->