                 *******************
                      startppp
                 *******************

(C) 1995 by Matthias Ott
E-Mail: msott@cip.informatik.uni-erlangen.de
WWW: http://wwwcip.informatik.uni-erlangen.de/user/msott
------------------------------------------------------------------

Startppp is a X11-interface for your PPP-connection or 
term-connection to the internet.
It also displays the units you were already online.
I have included a preconfigured version for Germany (new units!).
Feel free to send me your unitsfiles for other countries.

------------------------------------------------------------------

REQUIREMENTS:
-------------

Startppp needs Tcl 7.4 and Tk 4.0 to work. 
(Hopefully newer versions also work.)

Startppp can be installed without being root.
However, to run startppp as a normal user, the <pppd>-program
must have the SUID-flag.

NEW:
If you press the right mouse button in the icon or the small
helper window, you can see some useful information.
In addition to that, you can display a small helper window, which
then simulates the icon window (for the case that you have no icons).
There is also a small helper application called startppp_info which
you can use to display your net traffic.


PROGRAMS:
---------

PPPDIR/ppp-up: a script, that performs the connection-procedure
PPPDIR/ppp-down: a script, that performs the connection-termination 
PPPDIR/options: dto.
  you should configure these programs before you install them!
  they are necessary for <pppd>, because the phonenumber, etc.
  is included there 
PPPDIR/ip-up, PPPDIR/ip-down: used to get line-info
INSTLIB/startppp_interp: the advanced Tk interpreter
INSTDIR/startppp: the main program
INSTLIB/Startppp: the ressourcefile

If you use the program for <term> the names of all the files
begin with "term" (e.g. startterm)


INSTALLATION:
-------------

1. extract the package:
     tar zxvvf startppp.tar.gz
2. change these files to suit your local installation:
     ppp-up, ppp-down, options: start and stop your PPP-connection
		or
     term-up, term-down: start and stop your term-connection

     startppp_expect or startterm_expect:
         expect-files for the login to your server
         this files have the form: receive-string
                                   send-string
                                   receive-string
                                   send-string
                                    and so on ...         

     the files included are only examples !!!

3. make the binaries:
     I have included a compiled ELF-binary. 
     If you don't want to use it, make the binary with:

     make all

4. install <startppp>
     make install
   to change the destination-directories enter the 
   appropriate path
5. if your are using <tcsh>: type <rehash>
6. change the $HOME/.startppp/.startppp_holidays file to include your local 
   holidays; the format is: ddmm
7. start <startppp>
8. configure <startppp> with the menuitems <alter options>, <alter modem>
   for example: your local zonelength, the length of one unit
                your currency, your modem-specifications

----------------------------------------------------------------------------

Configuring Startppp for Germany
--------------------------------

Copy the appropriate <startppp-units.*>-file to <startppp-units>


Configuring Startppp for other countries than Germany
-----------------------------------------------------

1. start Startppp
2. Choose <Units...> in the <Configs>-Menu
3. type in how much money one unit costs
4. type in your currency
5. Press <Edit Classes>
6. Press <New Class>
7. Enter name of new class
   A class stands for a special scheme of units:
   e.g.:
   Weekdays:
     0.00 -  8.00 : One unit lasts for 120 seconds 
     8.00 - 18.00 : One unit lasts for  60 seconds
    18.00 - 24.00 : One unit lasts for 120 seconds 
8. DoubleClick on Class to make it active
9. Adjust Starttime, Stoptime and new length of one units
   Press <Add Time>
10. Repeat 9 until class is finished
11. Repeat 6-10 until all necessary classes are created
12. Press <Ok>
13. Choose day you want to change
14. Press <Assign Class>
15. Choose scheme ypu want to assign by DoubleClicking on name
16. Press <Ok>
17. Repeat 13-16 until all days are updated
18. Press <Save>
19. For defaultname press <save>
20. Press <Ok>
21. Everything should be finished now
