Turquoise SuperStat 2.2 - Ett mtesstatistikprogram fr Fidonet och Usenet
(c) Copyright 1998-2001 Peter Karlsson.
A Softwolves Software Release in 2001

http://www.softwolves.pp.se/sw/


LICENS

Denna programvara distribueras i enlighet med GNU General Public License
version 2 (GNU GPL), vilken finns i den bifogade filen COPYING, med fljande
tillgg:

Detta program kan lnkas mot kllkod eller binra bibliotek fr att komma t
Fidonet- eller andra meddelandebaser vilka inte r frenliga med GNU GPL, s
lnge som inkluderingen av denna inte frhindrar den fria distributionen av
huvudkllkoden. Det mste ocks vara mjligt att kompilera huvudkllkoden utan
att anvnda denna kod eller binra bibliotek (t.ex med villkorliga
preprocessordirektiv) och fortfarande f en anvndbar binr.

Binrer som skapas genom att lnka mot dylik meddelandebaskod mste vara fritt
distribuerbara och anvndbara av vem som helst (dvs. det r inte nog att
tillta "enbart ickekommersiell anvndning"). Om detta inte kan gras fr inga
sdana binrer spridas.

ven med dessa undantag fresprkas licensiering av ny meddelandebaskod under
GNU GPL.

Detta program fr ven lnkas mot alla GUI-bibliotek som mter kriterierna fr
Debians riktlinjer fr fri programvara (DFSG), inklusive, men inte begrnsat
till, Troll Techs Q Public License. Du kan ven distribuera binrer lnkad mot
kommersiella eller icke-fria versioner av Troll Techs grafiska bibliotek Qt,
s lnge du ocks distribuerar eventuella ndringar du gjort p dessa
kllkodsfiler. Dessutom bygger filen mytime.cpp p EMX-biblioteket, vars
licens r som fljer (versatt, se den engelska dokumentationen fr
originalordalydelsen): Du har rtt att ndra och kopiera emx-biblioteket om du
behller upphovsrttstexten intakt.


VRIGA UPPHOVSRTTER

JAM(mbp) - Copyright 1993 Joaquim Homrighausen, Andrew Milner, Mats Birch,
Mats Wallin. ALL RIGHTS RESERVED.

Squish and SquishMail are trademarks of Scott J. Dudley.

mktime.c (emx+gcc) -- Copyright (c) 1990-1996 by Eberhard Mattes.


ANVNDNING (KOMMANDORADSVERSIONEN)

Turquoise SuperStat lser innehllet i en Fidonetmeddelandebas i ngot av de
stdda formaten, eller Usenetgrupper i det vanliga "news spool"-formatet, och
skapar statistik inom fljande omrden:

 * Svartlista ver citatvolym.
 * Topplista ver avsndare.
 * Topplista ver originalinnehll per meddelande.
 * Topplista ver Fidonetnt (endast Fidonet).
 * Topplista ver Internet-toppdomner.
 * Topplista ver mottagare (endast Fidonet).
 * Topplista ver renderader.
 * Topplista ver programvara.
 * Postningar per veckodag.
 * Postningar per tid p dygnet.

Alla statistikomrden kan stngas av. Statistiken lagras i en textfil.

Turquoise SuperStat r helt kommandoradsstyrd, och formatet r som fljer:

  turqstat [flaggor] utdatafil areaskvg(ar)

dr areaskvg(ar) r skvgen till meddelandebasfilen, eller mtesnumret
(beror p valt meddelandebasformat). Flera skvgar eller mtesnummer kan
anges fr att f kombinerad statistik fr flera mten. Utdatafil r skvgen
till den textfil som statistiken skall skrivas till.

Dessa extra kommandoradsflaggor r tillgngliga (notera att alla flaggor mste
freg filnamn och skvgar till meddelandebaser):

Dataurval:

-d <dagar>
   Vljer det antal dagar tillbaka som meddelanden skall rknas frn. Det
   frinstllda vrdet r 0, vilket betyder att rkna alla meddelanden.

-n <antal>
   Vljer maximalt antal poster i topplistorna. Frinstllt vrde r 15. 0
   anger att ingen grns anvnds.

-r <intervall>
   Vljer ett intervall av datum och tider fr vilka statistik insamlas.
   Intervallet anges p formen [mmdd[Thhmmss]]-[mmdd[Thhmmss]].
   Exempel: 20000101T000000-20011231T235959 r hela 2000, -20010101 r allting
   fre (exklusive) 1 januari 2001, och 20010101- r allting frn (och med)
   1 januari 2001.

Val av indata:

-a <skvg>
   Vljer meddelandebasskvg fr FXAPX/w-, MyPoint- och
   tanstaaflmeddelandebaser, vilka har alla meddelandebaser i samma filer.

-s Vljer meddelandebaser av Squishtyp (frinstllt vrde). Areaskvgen skall
   vara basnamnet p Squishfilerna, eller namnet p ngon av datafilerna
   (filtillgget tas automatiskt bort).

-m Vljer meddelandebaser av FTSC-*.MSG-typ. Areaskvgen skall vara katalogen
   i vilken meddelandebasen ligger.

-o Vljer meddelandebaser av Opus-*.MSG-typ. Areaskvgen skall vara katalogen
   i vilken meddelandebasen ligger.

-j Vljer meddelandebaser av JAM-typ. Areaskvgen skall vara basnamnet p
   JAM-filerna, eller namnet p ngon av datafilerna (filtillgget tas
   automatiskt bort).

-f Vljer meddelandebaser av FDAPX/w-typ. Krver att parametern -a anvnds fr
   att vlja meddelandebasskvgen. Areaskvgen skall vara mtesnumret
   (1-1999).

-t Vljer meddelandebaser av tanstaafl-typ. Krver att parametern -a anvnds
   fr att vlja meddelandebasskvgen. Areaskvgen skall vara mtesnumret
   (1-1999).

-p Vljer meddelandebaser av MyPoint-typ. Krver att parametern -a anvnds fr
   fr att vlja meddelandebasskvgen (underkatalogen AREAS). Areaskvgen
   skall vara mtesnumret.

-u Vljer en Usenet news-"spool". Areaskvgen skall vara katalogen i vilken
   Usenetartiklarna ligger.

Du kan bara skapa statistik frn ett databasformat per anrop.

Val av topplistor:

-Q Stnger av citatvolymsvartlistan (frinstllt vrde r p).

-W Stnger av avsndartopplista (frinstllt vrde r p).

-O Stnger av originalinnehllstopplista (frinstllt vrde r p).

-N Stnger av nttopplistan (frinstllt vrde r p) (enbart Fidonet).

-T Stnger av/slr p topplistan ver Internet-toppdomner. Fr Usenet r
   frval p, varp denna flagga stnger av det. Fr Fidonet r frval av,
   varp denna flagga slr p det, men endast om RFC-gate:ade meddelanden
   hittas.

-R Stnger av mottagartopplista (frinstllt vrde r p) (enbart Fidonet).

-S Stnger av renderadstopplista (frinstllt vrde r p).

-P Stnger av programtopplista (frinstllt vrde r p).

-H Stnger av postningsstatistik per timme (frinstllt vrde r p).

-D Stnger av postningsstatistik per dag (frinstllt vrde r p).

-V Stnger av visning av versioner i programtopplista (frinstllt vrde r
   p).

Utseende p utdata:

-A Visar alla siffror i topplistorna (frinstllt vrde r av).

-L Anvnd datumformatet enligt "locale"-definition (frinstllt vrde r
   att anvnda ISO-8601-format, vilket sammanfaller med EU- och svensk
   norm). Observera att stdet fr lokala datumformat varierar beroende p
   plattform och kompilatorer.

-C <teckenkodning>
   Vljer teckenkodning att anvnda fr rapportfilerna som skapas.
   Teckenkodningsnamnet kan anges med antingen dess Fidonet- eller dess
   MIME-namn. Frval fr Win32- och OS/2-verisonen r IBMPC (teckentabell
   437), och fr alla andra versioner LATIN-1 (iso-8859-1).

Flaggorna kan kombineras p kommandoraden, till exempel:

  turqstat -mWRSPHDON d:\text\output.txt d:\msgbase\thisarea

kommer att skapa (enbart) en citatvolymsvartlista fr *.MSG-meddelandebasen i
katalogen d:\msgbase\thisarea. Flaggorna r skiftlgesknsliga.

  turqstat -?

visar en snabbhjlpskrm med en versikt ver tillgngliga flaggor.


ANVNDNING (GRAFISK VERSION)

Den grafiska versionen av Turquoise SuperStat har samma funktionalitet som
kommandoradsversionen, men med alla funktioner tillgngliga genom ett
lttanvnt grafiskt grnssnitt. Den grafiska versionen byggs med Qt.

Huvudfnstret i den grafiska versionen innehller statistik om den fr
nrvarande valda datauppsttningen, vilken ursprungligen r tom. Fr att ladda
statistik mste du anvnda menyerna, enligt nedan.

 Arkiv - ppna meddelandebas

Lser statistik fr en meddelandebas och visar statistik i huvudfnstret.

 Arkiv - Tm data

Tmmer all inlst data och terstller den visade statistiken.

 Arkiv - Spara rapport

Sparar en rapport fr den fr tillfllet inlsta uppsttningen statistik till
en textfil, i samma format som kommandoradsversionen anvnder.

 Arkiv - Avsluta

Lmnar programmet.

 Redigera - Vlj startdatum

Lter dig vlja frn hur mnga dagar bakt statistiken skall lsas in nr du
anvnder dig av Arkiv - ppna meddelandebas.

 Visa

Denna meny visar de olika topplistorna som finns att tillg. Se stycket om
kommandoradsversionen fr mer detaljerade beskrivningar.


TIDSSTMPLAR

Fr att bestmma vilka meddelanden som skall tckas av statistiken eller inte
anvnds ankomsttiden, eftersom olika meddelanden kan ta olika lng tid p sig
att komma fram. Detta skerstller att om du tar ut sju dagars statistik varje
vecka, s kommer du alltid f samtliga meddelanden som ankommit under veckan,
utan att missa meddelanden som har tagit en halv vecka fr att komma fram.

Dock saknar vissa meddelandebasformat, nmligen FTSC *.MSG och tanstaafls
format, dessa ankomsttider. Drfr kommer i dessa fall datumet nr texten
skrivits istllet att anvndas. Fr Usenet news anses filskapandedatumet vara
ankomsttiden.


USENET I FIDONETFORMAT

Turquoise har funktionalitet fr att hantera Usenetmeddelanden i Fidonetformat
om de fljer gngse (de facto-)standarder. Kontrolldata enligt FSC-0035
(REPLYADDR) hanteras, och adressen dri anvnds i stllet fr Fidonetadressen.
Dessutom hanteras RFC-huvudrader som skrivs direkt som Fidonetkontrollrader,
eller med prefixed "RFC-", vilka bda r vanligt frekommande.


HISTORIK

1999-06-06 - v1.0 - Frsta slppta version
1999-07-03 - v1.1 -
  Lade till std fr revision 3 av MyPoints meddelandedatabaser.
  MyPoint anvnder areanummer, precis som FDAPX/w.
  Listan ver versioner r sorterad.
  Buggfixar.
1999-07-21 - v1.2 -
  Anvnder inte lngre SMAPI, utan har egna rutiner fr Squish/*.MSG.
  Stder *.MSG av bde FTSC- och Opustyp.
  Diverse felrttelser.
  Windows- och Linuxversionerna fungerar (bttre) nu.
2000-03-25 - v1.3 -
  Stder kombinerad statistik frn flera mten.
  OBS! Ordningen p kommandoradsparametrarna har ndrats.
  Lade till topplista ver medeloriginalinnehll per meddelande.
  Lade till std fr tanstaafl-meddelandebaser.
  Lade till std fr Usenet news-"spool".
  Linuxversion distribueras som .deb-fil.
  Diverse felrttelser.
2000-04-14 - v1.3.1 -
  Rttade *.MSG- och news-"spool"-std fr OS/2.
  Justerade tidszonsfunktioner.
2000-05-15 - v1.4 -
  Anvnder autoconf fr lttare anpassning till nya plattformar.
  Topplista ver Fidonetnt och Internet-toppdomner.
  OBS! Flaggan fr att visa alla siffror i topplistorna har ndrats.
  Std fr "locale"-definierade datumformat.
  Hittar Internetadresser i Fidonetmten.
  Kan ange fr JAM- och Squishdatabaser, inte bara basnamnet.
  Korrigerade manualsidan, samt lade till en svensk.
  Anvnder Mingw32 i stllet fr CygWin fr Win32-versionen.
  Frbttrat std fr news.
  Diverse felrttelser.
2000-11-26 - v2.0 -
  Egna tidsfunktioner fr att motverka tidszonsproblem i C-biblioteket.
  Gjorde hjlpskrmen mer lttlslig.
  Frtydligade dokumentationen.
  Lade till grafisk X-version (anvnder Qt).
  Diverse felrttelser.
2001-01-09 - v2.0.1 -
  Fixade fel som kraschade newsspoolstdet.
2001-02-08 - v2.0.2 -
  Korrigeringar i Debianpaketering.
2001-07-04 - v2.0.3 -
  Fixade big-endian-arkitekturer.
2001-07-17 - v2.1 -
  Anvnd OS/2- och Win32-API-funktioner fr att hmta lokalt datumformat.
  Implementerade datumintervall.
  Lade in std fr teckenomkodning.
2001-08-30 - v2.1.1 -
  Rttade ett fel som orsakade hngning nr ogiltig QP-kodning ptrffades.
2001-09-15 - v2.1.2 -
  Rttade problem med att kompilera mot QT3.
  Kosmetisk ndring fr genererade rapporter.
2001-10-04 - v2.1.3 -
  Delvis fungerande hack fr GCC 3.0.
2001-10-10 - v2.1.4 -
  Komplett std fr GCC 3.0.
2001-12-09 - v2.2 -
  Std fr Usenet News ver NNTP.


BIFOGADE FILER

OS/2- och Win32-distribution:

turqstat.doc  - Dokumentation p engelska
turqstat.dok  - Denna dokumentation
turqstat.1    - Unixmanualsida
turqstat-sv.1 - Unixmanualsida p svenska
xturqstat.1   - Unixmanualsida, grafisk version
xturqstat-sv.1- Unixmanualsida p svenska, grafisk version
COPYING       - GNU General Public License, version 2

src/-katalogen:
  ChangeLog       - Logg ver ndringar i kllkoden
  configure       - Konfigureringsskript (krver sh-kompatibelt skal)
  Makefile.in     - Indatafil fr Makefile (anvnds av configure)
  configure.in    - Indatafil fr configure (anvnds av autoconf)
  config.h.in     - Indatafil fr config.h (anvnds av configure)
  acconfig.h      - Indatafil fr config.h.in (anvnds av autoconf)
  turqstat.cpp    - Huvudkllkod fr Turquoise
  arearead.h      - Prototypfil som beskriver den abstrakta verklassen fr
                    meddelandebaslsarna
  fdapxread.cpp   - Kllkod fr lsning av FDAPX/w-meddelandebaser
  fdapxread.h     - Prototypfil fr ovanstende
  jamread.cpp     - Kllkod fr lsning av JAM-meddelandebaser
  jamread.h       - Prototypfil fr ovanstende
  mypointread.cpp - Kllkod fr lsning av MyPoint-meddelandebaser
  mypointread.h   - Prototypfil fr ovanstende
  newsspoolread.cpp Kllkod fr lsning av Usenet news-"spool"
  newsspoolread.h - Prototypfil fr ovanstende
  nntpread.cpp    - Kllkod fr lsning av Usenet news via NNTP
  nntpread.h      - Prototypfil fr ovanstende
  squishread.cpp  - Kllkod fr lsning av Squish-meddelandebaser
  squishread.h    - Prototypfil fr ovanstende
  sdmread.cpp     - Kllkod fr lsning av *.MSG-meddelandebaser
  sdmread.h       - Prototypfil fr ovanstende
  tanstaaflread.cpp Kllkod fr lsning av tanstaafl-meddelandebaser
  tanstaaflread.h - Prototypfil fr ovanstende
  convert.cpp     - Kllkod fr teckenkonverteringsfunktionalitet
  convert.h       - Prototypfil fr ovanstende
  mappings.cpp    - Kllkod med teckenkonverteringstabeller
  mappings.h      - Prototypfil fr ovanstende
  mytime.cpp      - Kllkod med tidsfunktioner
  mytime.h        - Prototypfil fr ovanstende
  output.cpp      - Funktioner fr att visa felmeddelanden
  output.h        - Prototypfil fr ovanstende
  statengine.cpp  - Statistiksinlsningsmotorn
  statengine.h    - Prototypfil fr ovanstende
  statview.cpp    - "Vyn", skapar utdatafilen
  statview.h      - Prototypfil fr ovanstende
  utility.cpp     - Diverse verktygsfunktioner
  utility.h       - Prototypfil fr ovanstende
  datatypes.h     - Kompilatoroberoende datatypdeklarationer
  version.h       - Aktuellt versionnummer
  turqstat.def    - Applikationstitelfil fr OS/2
  qtbars.cpp      - Postningsfrekvensfnster (Qt)
  qtbars.h        - Prototypfil fr ovanstende
  qtgui.cpp       - Huvudfnster (Qt)
  qtgui.h         - Prototypfil fr ovanstende
  qtlist.cpp      - Listfnster (Qt)
  qtlist.h        - Prototypfil fr ovanstende
  qtreport.cpp    - Statistikspararfnster (Qt)
  qtreport.h      - Prototypfil fr ovanstende
  teal.cpp        - Enkelt teckenkonverteringsprogram

src/mappings/-katalogen:
  Makefile.in     - Indatafil fr Makefile (anvnds av configure)
  makemappings.pl - Perlprogram som skapar C-kod frn tabellfiler
  *.txt           - Officiella konverteringstabeller

src/po/-katalogen:
  Makefile.in     - Indatafil fr Makefile (anvnds av configure)
  update-po.sh    - Skalprogram som uppdaterar PO-filerna
  xturqstat.po    - Kllfil fr versttningarna (Qt)
  *.po            - versttningar (Qt)

os2/-katalogen:
  config.h        - config.h att anvnda om du inte kan kra configure (EMX)
  Makefile        - Makefile att anvnda om du inte kan kra configure (EMX)
  turqstat.exe    - Krbar fil (OS/2, EMX)
  README.os2      - Information om OS/2-versionen

win32/-katalogen:
  turqstat.exe    - Krbar fil (Win32 i386, Mingw32)
  README.Win32    - Information om Win32-versionen

Unixdistributionen bestr av en .tar.gz-fil med all kllkod listad ovan, plus
dokumentationsfilerna. Inga exekverbara filer medfljer. Den innehller ven
en underkatalog debian, vilken innehller kontrollfiler fr att skapa ett
binrpaket fr Debian.


CREDITS

Tack till Dan Gohman <gohmandj@mrs.umn.edu> fr hjlp med anpassning till
GNU C++ 3.0.


KRAV FR KOMPILERING

Programmet utvecklades under OS/2 med EMX 0.9d/GNU C/C++ 2.8.1, Debian 2.2
med gcc 2.95.4 och Win32 med Mingw32 (gcc 2.95.2).

Den grafiska versionen krver att Qt version 2.1 eller senare finns
installerat.

Om du vill skapa ett Debianpaket mste du installera Debians utvecklingspaket,
bland andra debhelper och fakeroot (om du inte vill kompilera som root).
Drefter skriver du "fakeroot debian/rules binary" (utan citattecknen) vid
kommandosymbolen. Om du ven vill tillverka Debians arkivstyrfiler anvnder du
dpkg-buildpackage.


KONTAKT

Frfattaren, Peter Karlsson, kan ns via ntpost p 2:204/254.222, eller via
Internet-e-post p peter@softwolves.pp.se. Information om detta program finns
p webben p http://www.softwolves.pp.se/sw/