
                                  X-PLog

                                Version 0.14 

                            Release Feb. 28 1999

                                 Kontakt: 
                           skraus@weserbergland.de

                                 Homepage: 
                   http://www.weserbergland.de/privat/kraus

                                 Adresse:
                                Stefan Kraus
                                Leipzigerstr. 3a
                          31848 Bad Mnder
                                - Germany -

GNU-LIZENZ
==========

 XPLog -- an PPP-Dialer and Phonecost Program
 Copyright (C) 1998 Stefan Kraus

 This program 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.

 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.

 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.

FEATURES
========

 - PPP-Dialer fr Modems ( durch Aufruf von PPP-Skripte )
 - Online Zeit und Kosten Anzeiger
 - Online Log-Datei erstellung
 - Log-Datei Anzeiger
 - Gebhrenberechnung mit Protokolierung ( Aufschlsselung einzelner 
   Verbindungen )
 - Gebhrenberechnungs Protokol Anzeiger
 - Drei freidefinierbare Buttons zum starten von Applikationen.
 - Einfache Konfiguration ber eine komfortable Oberflche
 - Gebhrenberechnung mit anschliessender Ausgabe einer Statistik 
   ber maximal 93 Tage
 - Info Fenster ber die gesamten Telefongebhren
 - Messages-LogDatei Import ( nur fr den System-Administrator )

HISTORIE
========

Version 0.14    - Fliekommaumwandlung berarbeitet.
                - Neue Telekom Tarife integriert (ausser ISDN ).

Version 0.13    - Iconify eingebunden 
(26.12.1998)    - XPLog kann jetzt in einem Normalen Fenster
                  gestartet werden.

Version 0.12    - Default-Gebhreneinstellung Farblich hervorgehoben.
(11.09.1998)    - Info- und Gebhreninfo jetzt auch whrend einer
                  Verbindung angesehen werden. VORSICHT !!!

Version 0.11    - ISDN berwachung integriert
(10.20.1998)    - diverse Routinen berarbeitet

Version 0.10    - XPLog Neustart berarbeitet
(08.15.1998)    - Snapshot Modus im Gebhrenrechner eingebaut
                - Telefongebhren Infofenster berarbeitet.
                - ...

Version 0.9     - Voreinstellungen um Dateiauswahlfenster erweitert.
(08.03.1998)    - zwei alternative Oberflchen integriert. Diese ist kleiner
                  als die Original-Oberflche.
                - die diversen Hinweistexte knnen abgeschaltet werden.
                - ...

Version 0.8     - Telefontarife Im- und Exportieren.
(07.25.1998)	- Monatliche Zusatzkosten werden jetzt Bercksichtigt.
                  ( Nur im Gebhrenprotokol zu sehen. )
		- Gebhrenprotokol erweitert.

Version 0.7	- Fehler im Gebhren Protokol behoben 
(07.18.1998)	- Deutsche Lokalisierung ( siehe TODO-Datei )
		- Interne Pref-Variablen in eine Include-Datei
                  verlegt.
		- Konfigurationsdatei verndert. Alte 
                  Konfigurationsdatei wird weiter untersttzt.

Version 0.6	- Gebhrenberechnungsfehler behoben
(07.11.1998)	- /var/log/messages LogDatei Import
	
Version 0.5     - Gebhrenberechnungsfehler behoben
(07.05.1998)	- Informationsfenster ber Telefongebhren implementiert
		- Gebhren Voreinstellung berarbeitet.
		- ...

Version 0.4
(07.01.1998)

Version 0.3
(06.26.1998)

Fehlerbehebungen
================
X-PLog Versionen kleiner 0.6 beinhalten einen berechnungsfehler. Dieser
Fehler befindet sich im Gebhrenberechnungsbereich ( calc.c ). X-PLog 
hngte sich in einer endlos Berechnungs-Schleife auf.
 
Die Hauptoberflche
===================

 CONNECT/DISCONNECT --- um die entsprechenden PPP-Skripte zu starten
 LOG ------------------ die XPLog-LogDatei anzeigen
 INFO ----------------- das Gebhren Info Fenster anzeigen
 PHONEBILL ------------ der Gebhrenrechner
 
 Nutzer 1/Nutzer 2/Nutzer 3 - drei freibelegbare Buttons um 
                              Applikationen zu starten.
 
 QUIT ----------------- beendet XPLog
 PREF ----------------- die Programm-Voreinstellungen.
 HELP ----------------- zeigt diese Hilfedatei an.

 <Beginn:> ------------ Start Zeit einer PPP-Verbindung.
 <Ende:> -------------- End Zeit ( Aktuelle Zeit ) einer PPP-Verbindung.
 <Gebhr:> ------------ Kosten und Online Zeit.

 Iconify -------------- Um XPLog zu iconifizieren muss man in denn 
                        Ausgabebereich klicken ( Beginn, Ende, Gebhr ).

Die Voreinstellung (PREF)
=========================

Fenster Position:

 Auswahl der Position der Hauptoberflche. Ein von den vier Ecken des 
 Bildschirms sind mglich.

PPP-Skripts:

 Provider Name: -------------------- Name des Providers der in der 
                                     LogDatei erfasst wird.
 Connect Skript oder Kommando: ----- StartUp Skript oder Kommando um eine 
                                     PPP-Modem-Verbindung einzuleiten.
 DisConnect Skript oder Kommando: -- StartUp Skript oder Kommando um eine
                                     PPP-Modem-Verbindung zu beenden.

#######################################################################
#                                                                     #
# WARNUNG !!! SICHERHEITS PROBLEM !!!                                 # 
#                                                                     #
#  Sicherheits Problem. Folgende Zugriffsrechte fr XPLog sind        #
#  Korrekt -rwxr-xr-x . Dieses Program benutzt zum starten von        #
#  Skripte und Programmen die "System"-Funktion.                      #
#                                                                     #
#######################################################################

Nutzer Buttons:

 Name: ----------------- Name des Nutzer Buttons ( eines von dreien ) 
 Skript oder Kommando: - StartUp Skript oder Kommando eines Nutzer
                         Buttons. (eines von dreien) (z.B.: "browser &")

#######################################################################
#                                                                     #
# WARNUNG !!! SICHERHEITS PROBLEM !!!                                 # 
#                                                                     #
#  Sicherheits Problem. Folgende Zugriffsrechte fr XPLog sind        #
#  Korrekt -rwxr-xr-x . Dieses Program benutzt zum starten von        #
#  Skripte und Programmen die "System"-Funktion.                      #
#                                                                     #
#######################################################################

Grundgebhren:

 Grundgebhr - Die Monatliche Grundgebhr ( in DM, Dollar ).
 Gertemiete - Die Zustzliche Miete ( in DM, Dollar ).
 Guthaben ---- Das Monatliche Guthaben ( in DM, Dollar ).   

Optionen:

 Erstelle Gebhren Protokol -------- Bei der Gebhrenberechnung wird ein
                                     Berechnungsprotokol erstellt.
 nach Berechnung Protokol anzeigen - Protokol wird nach der Gebhren-
                                     berechnung angezeigt.
 GUI A / GUI B / GUI C ------------- die drei Oberflchen von XPLog.
 Meldungen verbieten --------------- dieverse Fehler-Meldungen unterdrcken.
 XPLog Iconifiziert starten -------- XPlog startet als Icon bzw. minimiert.

Gebhren:
 
 Std. -------- Start Zeit ( Stunden ) fr den Gebhrenbereich. 
 Min: -------- Start Zeit ( Minuten ) fr den Gebhrenbereich.
 Takt: ------- Taktlnge in Sekunden.
 Preis: ------ Kosten einer Einheit ( in Pfennig, Cent, New Penny ).
 So-Sa ------- Wochentage 
 Info -------- das Gebhren Info Fenster anzeigen
 Defaults ---- Gebhrenauswahl fr die Gebhrenvorgaben.

 Cut --------- Kopiert alle angezeigten Eintrge in den Puffer.
               Zustzlich werden die angezeigten Eintrge gelscht.
 Copy -------- Kopiert alle angezeigten Eintrge in den Puffer.
 Paste ------- Kopiert den Puffer in die angezeigten Eintrge. 
 Clear ------- lscht alle Eintrge des angezeigten Wochentags.	

LogFile Import: ( nur System-Administrator )

 Import ------ LogDatei Importieren in die XPLog-LogDatei.
               ( /var/log/messages -> $HOME/.xplog.log )

  Import Fenster:

  Jahr ------------- Die Jahresangabe fr die Message-Logdatei-Eintrge. 
                     Tag und Monat sind in der Message-Logdatei 
                     vorhanden.

  Import Logfile --- Importieren der Message Logdatei.

  EXIT ------------- Schliessen des Import-Fensters.

  Clear xplog.log -- Entfernt alle xplog.log Eintrge.

 Save -------- Voreinstellung sichern 
 Save & Exit - Voreinstellung sichern und Voreinstellung verlassen.
 Exit -------- Voreinstellung verlassen.
 Help -------- Zeigt diesen Text an.

Dateien 
=======

 Datei                      Funktion                      Zugriffsrechte
 $HOME/.xpl.rc ------------ X-PLog Voreinstellung ------- -rw-------
 $HOME/.xplog.calculation - X-PLog Gebhren Protokol ---- -rw-------
 $HOME/.xplog.log --------- X-PLog LogDatei ------------- -rw-------
 $HOME/.xplog.stat -------- X-PLog Statistik-Daten ------ -rw-------
 $HOME/.xplog.snap -------- X-PLog Snapshot-Daten ------- -rw-------
 $HOME/.xplog.range ------- X-PLog Berechnungsbereich --- -rw-------
