<!-- $XConsortium: hello.sgm /main/8 1996/10/30 16:27:45 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<refentry id="CDEMX.MAN16.rsml.1" remap="">
<refmeta><refentrytitle>dthello</refentrytitle><manvolnum>user cmd</manvolnum>
</refmeta>
<refnamediv><refname><command>dthello</command></refname><refpurpose>CDE login
transitional greeting</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>dthello</command>
<arg choice="opt">&minus;display <replaceable>&lt;display></replaceable></arg>
<arg choice="opt">&minus;fground <replaceable>&lt;color></replaceable></arg>
<arg choice="opt">&minus;bground <replaceable>&lt;color></replaceable></arg>
<arg choice="opt">&minus;font <replaceable>&lt;fontname></replaceable></arg>
<arg choice="opt">&minus;string <replaceable>&lt;message></replaceable></arg>
<arg choice="opt">&minus;file <replaceable>&lt;filename></replaceable></arg>
<arg choice="opt">&minus;timeout <replaceable>&lt;seconds></replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>The dthello client provides transition visuals from the end of login
to the start of the window manager in the user's session.</para>
<para>Upon invocation, the dthello client will create an override-redirect
window the size of the screen and draw a specified message on it. At the same
time, a 1x1 window is created that will be picked up by the window manager.
When the window manager reparents the little window (an indication that the
window manager has started), this program exits.</para>
<para>The message may be specified on the command line, or in a text file.
</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<note>
<para>The <command>dthello</command> client is designed to be started by the system and
is not intended to be started directly by users.
</para>
</note>
<variablelist>
<varlistentry><term><literal>&minus;display</literal> <emphasis>display</emphasis></term>
<listitem>
<para>Display id.
</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>&minus;fground</literal> <emphasis>color</emphasis></term>
<listitem>
<para>Foreground color.
</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>&minus;bground</literal> <emphasis>color</emphasis></term>
<listitem>
<para>Background color.
</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>&minus;font</literal> <emphasis>fontname</emphasis></term>
<listitem>
<para>Font.
</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>&minus;string</literal> <emphasis>message</emphasis></term>
<listitem>
<para>String to be displayed in window.
</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>&minus;file</literal> <emphasis>filename</emphasis></term>
<listitem>
<para>Text file name whose contents will be displayed in window.
This option may be specified up to five times.
</para>
</listitem>
</varlistentry>
<varlistentry><term><literal>&minus;timeout</literal> <emphasis>seconds</emphasis></term>
<listitem>
<para>Number of seconds before giving up on the window manager
and terminating.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>RETURN</title>
<para>Exit values are:</para>
<variablelist>
<varlistentry><term>0</term>
<listitem>
<para>Successful completion.</para>
</listitem>
</varlistentry>
<varlistentry><term>>0</term>
<listitem>
<para>Error condition occurred.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>EXAMPLES</title>
<para><command>dthello</command> <literal>-string</literal> <literal>Welcome
to the Desktop</literal> Transition window will contain this message.</para>
</refsect1>
<refsect1>
<title>RESOURCES</title>
<para>NOTE: Resources should be prefaced with the string "Dthello*" when specified.
Resources should be specified in the Dthello app-defaults file.</para>
<informaltable remap="center" orient="port">
<tgroup cols="4" colsep="0" rowsep="0">
<colspec align="left" colwidth="99*">
<colspec align="left" colwidth="109*">
<colspec align="left" colwidth="84*">
<colspec align="left" colwidth="164*">
<tbody>
<row>
<entry align="left" valign="top"><literal>Name</literal></entry>
<entry align="left" valign="top"><literal>Class</literal></entry>
<entry align="left" valign="top"><literal>Type</literal></entry>
<entry align="left" valign="top"><literal>Default</literal></entry></row>
<row>
<entry align="left" valign="top">vbackground</entry>
<entry align="left" valign="top">Vbackground</entry>
<entry align="left" valign="top">Pixel</entry>
<entry align="left" valign="top">dynamic</entry></row>
<row>
<entry align="left" valign="top">vforeground</entry>
<entry align="left" valign="top">Vforeground</entry>
<entry align="left" valign="top">Pixel</entry>
<entry align="left" valign="top">dynamic</entry></row>
<row>
<entry align="left" valign="top">vfont</entry>
<entry align="left" valign="top">Vfont</entry>
<entry align="left" valign="top">FontList</entry>
<entry align="left" valign="top">dynamic</entry></row>
<row>
<entry align="left" valign="top">string</entry>
<entry align="left" valign="top">String</entry>
<entry align="left" valign="top">String</entry>
<entry align="left" valign="top">.........</entry></row>
<row>
<entry align="left" valign="top">file</entry>
<entry align="left" valign="top">File</entry>
<entry align="left" valign="top">String</entry>
<entry align="left" valign="top">NULL</entry></row>
<row>
<entry align="left" valign="top">timeout</entry>
<entry align="left" valign="top">Timeout</entry>
<entry align="left" valign="top">Integer</entry>
<entry align="left" valign="top">240</entry></row></tbody></tgroup></informaltable>
<refsect2><?Pub Caret1>
<title>vbackground</title>
<para>Specifies the background color for the transition message.</para>
</refsect2>
<refsect2>
<title>vforeground</title>
<para>Specifies the foreground color for the transition message.</para>
</refsect2>
<refsect2>
<title>vfont</title>
<para>Specifies the font to use for the transition message.</para>
</refsect2>
<refsect2>
<title>string</title>
<para>Specifies the text to use in the transition message.</para>
</refsect2>
<refsect2>
<title>file</title>
<para>Specifies a file whose contents is to be displayed in addition to the
transition message. Only one file may be specified.</para>
</refsect2>
<refsect2>
<title>timeout</title>
<para>Number of seconds before giving up on the window manager and terminating.
</para>
</refsect2>
</refsect1>
</refentry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 01:31:55-->
<?Pub *0000035081>
