gsmssend.sgml

用于在ＬＩＮＵＸ下使用串口进行收发短消息

           <para>This menu contains:</para>
           <itemizedlist>
                <listitem>
                  <para>
                    <guimenuitem>Manage Aliases&hellip;</guimenuitem>
                     &mdash; This opens the <link
                     linkend="alias"><interface>Alias
                     Dialog</interface></link>, which allows you to configure
                     the aliases.
                   </para>
                </listitem>
                <listitem>
                  <para>
                    <guimenuitem>Manage Scripts&hellip;</guimenuitem>
                     &mdash; This opens the <link
                     linkend="scripts"><interface>Scripts
                     Dialog</interface></link>, which allows you to configure
                     the scripts you want to see or to save.
                   </para>
                </listitem>
                <listitem>
                  <para>
                    <guimenuitem>Check for updates</guimenuitem>
                     &mdash; This will check, by launching <application>smssend</application>
                     with the <command>-update</command> option, if the installed 
                     version of <application>smssend</application> is the latest. Outputs generated
                     by this call can be seen in the status bar of the main window.
                   </para>
                </listitem>
                <listitem>
                  <para>
                    <guimenuitem>Preferences&hellip;</guimenuitem>
                     &mdash; This opens the <link
                     linkend="prefs"><interface>Preferences
                     Dialog</interface></link>, which allows you to configure
                     many settings.
                   </para>
                </listitem>

            </itemizedlist>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term><guimenu>Help</guimenu></term>
           <listitem>
           <figure>
             <title>The Help Menu</title>
             <screenshot>
               <screeninfo>The Help Menu</screeninfo>
               <graphic format="png" fileref="figs/gsmssend-menu-help" srccredit="el">
             </screenshot>
           </figure>
           <para>This menu contains:</para>
           <itemizedlist>
                <listitem>
                  <para>
                    <guimenuitem>Help topics</guimenuitem>
                     &mdash; This opens the <ulink type="help" url="ghelp:help-browser">GNOME Help Browser</ulink> for the specified topic.
                   </para>
                </listitem>
                <listitem>
                  <para>
                    <guimenuitem>About&hellip;</guimenuitem>
                     &mdash; This opens the <link
                     linkend="fig-about"><interface>About
                     box window</interface></link>.
                   </para>
                </listitem>

            </itemizedlist>

           <figure id="fig-about">
             <title>The About box</title>
             <screenshot>
               <screeninfo>The about box</screeninfo>
               <graphic format="png" fileref="figs/gsmssend-about" srccredit="el">
             </screenshot>
           </figure>
           </listitem>
         </varlistentry>
       </variablelist>
       </sect2>
  </sect1>

  
  <!-- #########  User Interface  ############## -->
    <sect1 id="ui">
      <title>User Interface</title>
        <sect2 id="tab">
        <title>The Provider Interface</title>
           <figure id="fig-tab">
             <title>The Provider Interface</title>
             <screenshot>
               <screeninfo>The Provider Interface</screeninfo>
               <graphic format="png" fileref="figs/gsmssend-provider" srccredit="el">
             </screenshot>
           </figure>
           <para>
	   The provider part of the main window is created by parsing a provider script,
           each parameter of the script is used to create a text field in this window.
           Each text field as a name and a popup help.
           </para>
	   <para>
           The big text entry on the right is used to enter the SMS message, updating
           in real time the <guilabel>Remaining characters</guilabel> field.
	   </para>
           <para>
           When the message is ready, <application>smssend</application> is called by
           pressing the <guibutton>Apply</guibutton> button.
	   </para>
           <para>
           All outputs of <application>smssend</application> can be seen in the status bar
           of the main window.
	   </para>
        </sect2>
        <sect2 id="prefs">
        <title>The Preference Dialog Window</title>
           <figure id="fig-prefs">
             <title>The Preference Dialog Window</title>
             <screenshot>
               <screeninfo>The Preference Dialog Window</screeninfo>
               <graphic format="png" fileref="figs/gsmssend-config" srccredit="el">
             </screenshot>
           </figure>
           <para>
	   This window lets you manage all options that can be set to 
           <application>smssend</application>. All terms here are explained in the 
           <application>smssend</application> manual. The only specific option is in the
           <guilabel>Usage</guilabel> part of this window:
           <variablelist>
             <varlistentry>
               <term><guilabel>Delay SmsSend calls</guilabel></term>
               <listitem><para>This checkbox is used if you want to delay all calls to
               <application>smssend</application>. They can be latter triggered by using
               <menuchoice>
                 <guisubmenu>File</guisubmenu>
                 <guimenuitem>Execute SmsSend for delayed connections</guimenuitem>
               </menuchoice>.
               </para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>OK</guibutton></term>
               <listitem><para>This button is used to update the used
               options in memory, close the dialog window and overwrite the
               <filename>~/.smssend/smssendrc</filename> file.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Apply</guibutton></term>
               <listitem><para>This button is used to update the used
               options in memory and close the dialog window.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Cancel</guibutton></term>
               <listitem><para>This button is used to cancel all changes to the options
               close the dialog window.</para></listitem>
             </varlistentry>
           </variablelist>
           </para>
        </sect2>
        <sect2 id="alias">
        <title>The Alias Dialog Window</title>
           <figure>
             <title>The Alias Dialog Window</title>
             <screenshot>
               <screeninfo>The Alias Dialog Window Window</screeninfo>
               <graphic format="png" fileref="figs/gsmssend-alias" srccredit="el">
             </screenshot>
           </figure>
           <para>
	   This window lets you manage (Add/Edit/Remove) aliases that can be used in every
	   parameter text field  of the <link linkend="tab">Provider Interface</link>. This
           enables the possibility to use aliases (<userinput>@Alias_name</userinput>), which are 
           located in the file <filename>~/.smssend/aliases</filename>. 
           When using an alias name in a parameter text field it is automatically replaced by its 
           value.
           </para>
           <para>
           The elements of this window are as follows:
           <variablelist>
             <varlistentry>
               <term><guilabel>Key Column</guilabel></term>
               <listitem><para>This colums shows the Alias_name (that has to be entered
               prefixed by <keycap>@</keycap> in the parameter text field)</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guilabel>Value Column</guilabel></term>
               <listitem><para>This colums shows the value that is used when 
               <userinput>@Alias_name</userinput> is entered.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guilabel>Key Text Field</guilabel></term>
               <listitem><para>This text field is used to Add new
               <userinput>@Alias_name</userinput> in the list.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guilabel>Value Text Field</guilabel></term>
               <listitem><para>This text field is used to Add the value of the preceeding
               <userinput>@Alias_name</userinput>.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Add</guibutton></term>
               <listitem><para>This button is used to Add the 2 values of the preceeding
               text fields in the list.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Delete</guibutton></term>
               <listitem><para>This button is used to delete the currently selected line of the
               list.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Up</guibutton>/<guibutton>Down</guibutton></term>
               <listitem><para>These buttons are used to move the currently selected line of the
               list.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>OK</guibutton></term>
               <listitem><para>This button is used to update the used
               list in memory, close the dialog window and overwrite the 
               <filename>~/.smssend/aliases</filename> file.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Apply</guibutton></term>
               <listitem><para>This button is used to update the used
               list in memory and close the dialog window.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Cancel</guibutton></term>
               <listitem><para>This button is used to cancel all changes to the aliases
               list in memory and close the dialog window.</para></listitem>
             </varlistentry>
           </variablelist>
           </para>
        </sect2>
        <sect2 id="scripts">
        <title>The Script Dialog Window</title>
           <figure>
             <title>The Script Dialog Window</title>
             <screenshot>
               <screeninfo>The Script Window Window</screeninfo>
               <graphic format="png" fileref="figs/gsmssend-scripts" srccredit="el">
             </screenshot>
           </figure>
           <para>
	   This window lets you manage the scripts that you want to use. You have a 3 columns list
	   with all the known scripts. 
           The elements of this window are as follows:
	   <variablelist>
             <varlistentry>
               <term><guilabel>Script Column</guilabel></term>
               <listitem><para>The list of all known scripts. By clicking in the columns label
	    	you can change the sort mode of the list.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guilabel>Show Column</guilabel></term>
               <listitem><para>This column is used to check the script that you want to have
	    	in the main notebook.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guilabel>Save Column</guilabel></term>
               <listitem><para>This column is used to mark the scripts that you want to be saved
	    	in a special file (<filename>~/.smssend/scripts</filename>) for the next time, you'll
		have only these scripts shown in the main GUI.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>OK</guibutton></term>
               <listitem><para>Save the scripts in <filename>~/.smssend/scripts</filename>.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Apply</guibutton></term>
               <listitem><para>Show/Hide notetab of provider scripts depending on what is selected.</para></listitem>
             </varlistentry>
             <varlistentry>
               <term><guibutton>Cancel</guibutton></term>
               <listitem><para>Cancel all changes.</para></listitem>
             </varlistentry>
	   </variablelist>
           </para>
	   <warning>
	   <para>When using the option <option>--scriptpath</option> or <option>--scriptfile</option> the saved
	   scripts list is not used.</para>
	   </warning>
        </sect2>
    </sect1>

<!-- ============= Authors ================================ -->

 <sect1 id="authors">
  <title>Authors</title>
<para>
   <application>Gnome SmsSend</application> was written by
     Eric Lassauge (<email>[e-mail]</email>).  Please send
     all comments, suggestions, and bug reports to the author.
  </para>
  <para>See updates on the authors web site: 
    <ulink type="http" url="http://lassauge.free.fr/smssend_en.html">http://lassauge.free.fr/smssend_en.html</ulink></para>
  <para>Many thanks to:</para>
      <itemizedlist>
        <listitem>
          <para>Harm Verhagen <email>[e-mail]</email></para>
        </listitem>
        <listitem>
          <para>Carlo <email>[e-mail]</email></para>
        </listitem>
        <listitem>
          <para>Heiko Armbrust <email>[e-mail]</email></para>
        </listitem>
        <listitem>
          <para>Petr Blaha <email>[e-mail]</email></para>
        </listitem>
        <listitem>
          <para>Gorka Olaizola <email>[e-mail]</email></para>
        </listitem>
        <listitem>
          <para>and of course Christophe CALMEJANE 'Ze KiLleR / SkyTech' <email>[e-mail]</email></para>
        </listitem>
      </itemizedlist>

 </sect1>

  
 <!-- ============= Application License ============================= -->

 <sect1 id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the  <ulink type="help" url="ghelp:gpl">
    <citetitle>GNU General Public License</citetitle></ulink> as
   published by the Free Software Foundation; 
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>Gnome Users
   Guide</citetitle>.  You may also obtain a copy of the
   <citetitle>GNU General Public License</citetitle> from the Free
   Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org/">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect1>


  </article>