gsms.sgml

这个项目里有两个关于收、发GSM 手机短信的C语言程序

<!DOCTYPE book PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
<book id="gsms">
  <bookinfo>
    <title>Gnome SMS Client User's Guide</title>
    <authorgroup>
      <author>
	<firstname>Gerhard</firstname> <surname>Khueny</surname>
	<affiliation>
	  <address>
	    <email>[e-mail]</email>
	  </address>
	</affiliation>
      </author>
      <author>
        <firstname>Michael</firstname> <surname>Jochum</surname>
	<affiliation>
	  <address>
	    <email>[e-mail]</email>
	  </address>
	</affiliation>
      </author>
    </authorgroup>
    <copyright>
      <year>2000</year> <holder>Gerhard Khueny, Michael Jochum</holder>
    </copyright>
    <legalnotice>
      <para>This documentation is free software; you can redistribute
	it and/or modify it under the terms of the GNU General Public
	License 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 GNU General Public License for more details.</para>
      
      <para>You should have received a copy of the GNU General Public
	License along with this program; if not, write to the Free
	Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
	MA 02111-1307 USA</para>
      
      <para>For more details see the file COPYING in the source
	distribution of GNOME.</para>
    </legalnotice>
  </bookinfo>

  <toc></toc>

  <chapter id="intro">
    <title id=introduction.title> Introduction </title>
      <para>  GSms is an application for sending SMS over the internet. 
            In the chapter  <link linkend=firststeps endterm="firststeps.title"></link>  you will get 
            information about sending SMS with this tool.  
            The chapter  <link linkend=advanced endterm="advanced.title"></link> 
            contains information about configuration, 
            the addressbook and plugins. 
      </para>
  </chapter>
 
  <chapter id="firststeps">
    <title id=firststeps.title> First steps </title>
    <para> This chapter contains the most important things for sending a SMS. </para>
    <sect1><title>Send a SMS </title>
        <para> To send a SMS to one or more people do: </para>

        <OrderedList> 
         <ListItem> <para>
	  Enter a number at the recipients field. You can enter more numbers 
	  by pressing the enter key in the recipients field. </para>
           <important> <para> You should enter the complete number including the state 
          prefix. e.g [phone].</para> </important>
         </ListItem>
         <ListItem><para>
	  Enter the message in the textfield TEXT. The number of characters is limited. 
         </para></ListItem>
         <ListItem><para>
	  Push the SEND button on  the toolbar.
        </para></ListItem>
        </OrderedList>
        <para>
	After sending you'll see if the message could have been send at the 
	queue on the left. If it fails you can check the log to find out where
	an error has been occured. You open the log window by pressing the LOG 
	button on the toolbar.
        </para>
       
    </sect1>

    <sect1>
	<title>The queue</title>
        <para>
	If you want to send the SMS later or write more SMS and send them all at
	once, you should press the QUEUE button instead of the SEND button.</para>
        <para> Every message in the queue will be sent by pressing the SEND button.
	You will be asked if you want to send the failed messages again.</para>
        <para> You are able to edit or delete messages or recipients by selecting
	a row from the queue. Press the left mouse button to select the row and then
	press the right mouse button tho select what you to do with.</para>
    </sect1>
    <sect1> 
	<title>Use the addressbook</title>
        <para>
	If you have entries in your addressbook (See Chapter 
        <link linkend=advanced endterm="advanced.title"></link> for adding entries)
	you can simply enter the nick at the recipients field. If you press the
	TO button near the recipeint field, a window with you addressbook entries opens 
        and you can choose one.
        </para>
    </sect1>
  </chapter>
  
  <chapter id="advanced">
      <title id=advanced.title >Advanced GSms </title> 
      <para> In this chapter you'll find some detailed infomation about Gsms.</para>
      <sect1> <title> The adressbook </title> 
        <sect2> <title> Create an abook entry </title>
             <para>
              Before you can use the addressbook you have to insert some entries by pressing the 
              NEW button on the toolbar. You have to specify a nickname and a phonenumber. 
              If you like fill in a realname. 
            </para>
        </sect2>

         <sect2> <title> Create an alias entry </title>
             <para>
              It is possible to create a mailing list in the addressbook. You create them similar 
              to a normal entry except you specify the the nicks in the number/nick field instead 
              of a phonenumber. Only nicks you have created first are accepted in the alias entry.
             </para>
        </sect2>
        <sect2> <title> Edit an abook entry </title>
             <para>
              If you want to edit an entry you have to choose first the entry in the list and  
              then press the EDIT button. It's not possible to edit an entry from the alias list.
             </para>
        </sect2>
         <sect2> <title> Remove an abook entry </title>
             <para>
              If you want to remove an entry you have to choose first the entry in the list and  
              then press the REMOVE button. If you choose an entry in the alias list, 
              this entry will be removed from the alias list. If you remove an entry it will be 
              removed in the aliases too. 
             </para>
        </sect2>
      </sect1>
      <sect1> <title> Log window  </title> 
       <para>
         If you open the log window by pressing the LOG button on the toolbar you'll see 
         Information about sending a sms. </para> <para> You can choose the loglevel on the top. 
         The lowest level is DEBUG (default). For that you get the most but probably uninportant 
         inforamtion. With loglevel WARNING you'll only get messages which contain information 
         about failed events. </para><para> The CLEAR button cleans up the messages. </para> 
         <para>
        </para>
      </sect1>

      <sect1> <title> Preferences </title> 
       <para>
          With the preferences dialog in the Configuration menue you can change some settings. 
          GSms has two differnent ways for sending a SMS. The first and mostly used method 
          is to send a http request to a webserver where you can send a sms. The other way is to 
          send a email to your handy provider. 
          It depends on the provider which method will be used.</para> 
          <para> If you want to send sms with email you must have an email account. 
          For that you have to fill in the entries for sending and receiveing email. 
          An option in the Receiving Mails section is delete messages from GSms. That means 
          wheather GSms should delete the messages which are received for sending a SMS or not.
          </para> 
          
          <para>
          In the network section you can enter a proxy for sending http requests. The network 
          timeout says how long should GSms wait when it gets no response from the other side 
          until it closes the connection. The maximum number of threads while sending can also 
          be changed. 
       </para>
      </sect1>
      <sect1> <title> Plugins </title> 
          <para>
          With each plugin you can send SMS to one or more provider. GSms automaticly choose a 
          plugin for the specified number. It depends on the plugin which providers are supported. 
          Therefore you have to install a plugin for the provider you want to send sms to.
          </para>
          <sect2> <title> Install a new plugin </title>
          <para> If you want to use your own plugin all you have to do is, copy the shared object 
                in your $HOME/.gsms/plugins directory. After restarting GSms you can use it.
          </para>
          </sect2>
          <sect2> <title> Configure installed plugins </title>
          <para> If you choose plugins in the Configuration menue you'll see the installed plugins 
                on your system. If you choose a plugin you'll get some general information and 
                the supported provider(s) inculding the prefix. If suported you can configure  
                the plugin by pressing the Configure button. </para> 
                <para> An nice feature is that you are able to set priorities for your plugins. 
                For example if you have plugins which support the same provider you  
                can favour a plugin to be used by changeing the Plugin Priority on top.
                
          </para>
          </sect2>
      </sect1>
   </chapter>


</book>