/*
 * TWCW README
 */

Welcome to twcw.

Here you will find:

I.  DESCRIPTION -   a breif description of the program and its features

II. INSTALLATION -  First, follow the direction in the INSTALL file to
                    compile and install the program.  Then you may want
                    to follow the directions here to improve operation.

                    Maintainers can use:
                    ./configure --bindir="path" --datarootdir="path"
                    and
                    make install DESTDIR="rootpath"
                    to build their distrobution trees.
                   

III RESOURCE FILE - This is a short description where you can create
                    your own copy of the resource file - Twcw.


I.  DESCRIPTION:

   This program sends Morse code and is implemented with a Motif interface.
   It was written using openMotif.  Earlier versions used lessTif.

   Code is sent by typing the text into a window, or you can select a file,
   and the contents of the file will be sent.  As the text is read from the
   file, twcw looks for any words that start with an "*", for example *RST
   or *Name.  If one is found, a dialog box is displayed and you can enter
   the text you want to send.  

   The program will send you code practice by clicking on the Controls
   button in the main menu, and then selecting the Practice button.  Random
   five letter groups will be sent, while the Xmit and Practice buttons
   are set.

   The WPM speed can be adjusted with the Farnswort control. When the 
   Farnsworth control is on, letters will be sent at the WPM speed, and
   the overall speed will be the speed displayed in the Farnsworth control.

   The transmitter is keyed by switching the serial port's Request To Send
   (RTS) line.  A line in the resource file, Twcw, allows you to specify
   which serial port you want to use,  A cheap and simple circuit is used
   to interface the PC with the rig.  The interface circuit fits inside the
   serial port's RS232 connector and does not require a power supply.
   


II.  INSTALLATION:

     First, follow the directions in the INSTALL file.

     IMPROVED TIMING

     The program uses the real time clock device as its time base for
     generating CW.  Some systems limit the users to a RTC rate of 64 Hz.  
     While this will work, it does not provide the best timing to generate
     CW accurately.  The CW generated will be a 2 or 3 WPM faster than the
     WPM control indicates.

     If you want to have more precise timing, you will need to increase
     the rate to 1024 Hz.  There are several ways to change the rate.  One
     way to do this is to put this command -

        echo 1024 > /proc/sys/dev/rtc/max-user-freq

     into the /etc/rc.d/rc.local file.

     A second way is to use the sysctl command.  As root do the command - 

        sysctl -w dev.rtc.max-user-freq=1024

     This method modifies the file /etc/sysctl.conf by adding the line
        dev.rtc.max-user-freq = 1024     


III  RESOURCE FILE

     The "make install" put a copy of the resource file (Twcw)
     in one of many places where X looks for resource files (most likely
     /etc/X11/app-defaults).  You will want to make changes to
     Twcw to tailor it to your needs.

     The easiest way is to edit the copy of Twcw just installed
     in /etc/X11/app-defaults.  But, you must be root!

     You can also:

        copy Twcw to your home directory.   -OR-

        cat it to the end of your .Xdefaults file.  -OR-

        use XAPPLRESDIR or XUSERFILESEARCHPATH and copy Twcw to
        your own resources directory.
        I have this line in my startup script

           XUSERFILESEARCHPATH=/home/ted/app-defaults/%N

        See the X manual pages for more information

     Now edit the new copy of Twcw (root is not needed).  There are
     comments (lines beginning with an !) in Twcw explaining the values.
     After you change the values, restart the program to have them take effect.
  

Pls send comments to:       wa0eir@mchsi.com

73,  
Ted - WA0EIR

