-
Notifications
You must be signed in to change notification settings - Fork 1
/
turqstat.dok
474 lines (356 loc) · 17.5 KB
/
turqstat.dok
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
Turquoise SuperStat 3.1 - Ett mötesstatistikprogram för Fidonet och Usenet
(c) Copyright 1998-2008 Peter Krefting.
A Softwolves Software Release in 2008
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 följande
tillägg:
Detta program kan länkas mot källkod eller binära bibliotek för att komma åt
Fidonet- eller andra meddelandebaser vilka inte är förenliga med GNU GPL, så
länge som inkluderingen av denna inte förhindrar den fria distributionen av
huvudkällkoden. Det måste också vara möjligt att kompilera huvudkällkoden utan
att använda denna kod eller binära bibliotek (t.ex med villkorliga
preprocessordirektiv) och fortfarande få en användbar binär.
Binärer som skapas genom att länka mot dylik meddelandebaskod måste vara fritt
distribuerbara och användbara av vem som helst (dvs. det är inte nog att
tillåta "enbart ickekommersiell användning"). Om detta inte kan göras får inga
sådana binärer spridas.
Även med dessa undantag förespråkas licensiering av ny meddelandebaskod under
GNU GPL.
Detta program får även länkas mot alla GUI-bibliotek som möter kriterierna för
Debians riktlinjer för fri programvara (DFSG), inklusive, men inte begränsat
till, Troll Techs Q Public License. Du kan även distribuera binärer länkad mot
kommersiella eller icke-fria versioner av Troll Techs grafiska bibliotek Qt,
så länge du också distribuerar eventuella ändringar du gjort på dessa
källkodsfiler. Dessutom bygger filen mytime.cpp på EMX-biblioteket, vars
licens är som följer (översatt, se den engelska dokumentationen för
originalordalydelsen): Du har rätt att ändra och kopiera emx-biblioteket om du
behåller upphovsrättstexten intakt.
ÖVRIGA UPPHOVSRÄTTER
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.
ANVÄNDNING (KOMMANDORADSVERSIONEN)
Turquoise SuperStat läser innehållet i en Fidonetmeddelandebas i något av de
stödda formaten, eller Usenetgrupper över NNTP eller i det vanliga "spool"-
formatet, och skapar statistik inom följande områden:
* Svartlista över citatvolym.
* Topplista över avsändare.
* Topplista över originalinnehåll per meddelande.
* Topplista över Fidonetnät (endast Fidonet).
* Topplista över Internet-toppdomäner.
* Topplista över mottagare (endast Fidonet).
* Topplista över ärenderader.
* Topplista över programvara.
* Postningar per veckodag.
* Postningar per tid på dygnet.
Alla statistikområden kan stängas av. Statistiken lagras i en textfil.
Turquoise SuperStat är helt kommandoradsstyrd, och formatet är som följer:
turqstat [flaggor] utdatafil areasökväg(ar)
där areasökväg(ar) är sökvägen till meddelandebasfilen, eller mötesnumret
(beror på valt meddelandebasformat). Flera sökvägar eller mötesnummer kan
anges för att få kombinerad statistik för flera möten. Utdatafil är sökvägen
till den textfil som statistiken skall skrivas till.
Dessa extra kommandoradsflaggor är tillgängliga (notera att alla flaggor måste
föregå filnamn och sökvägar till meddelandebaser):
Dataurval och -format:
-d <dagar>
Väljer det antal dagar tillbaka som meddelanden skall räknas från. Det
förinställda värdet är 0, vilket betyder att räkna alla meddelanden.
-n <antal>
Väljer maximalt antal poster i topplistorna. Förinställt värde är 15. 0
anger att ingen gräns används.
-r <intervall>
Väljer ett intervall av datum och tider för vilka statistik insamlas.
Intervallet anges på formen [ååååmmdd[Thhmmss]]-[ååååmmdd[Thhmmss]].
Exempel: 20000101T000000-20011231T235959 är hela 2000, -20010101 är allting
före (exklusive) 1 januari 2001, och 20010101- är allting från (och med)
1 januari 2001.
Utdataformat:
-F <fil>
Väljer vilken utdatamall som skall användas. Standardvalet är default.tpl
Val av indata:
-a <sökväg>
Väljer meddelandebassökväg för FXAPX/w-, MyPoint- och
tanstaaflmeddelandebaser, vilka har alla meddelandebaser i samma filer.
-s Väljer meddelandebaser av Squishtyp (förinställt värde). Areasökvägen skall
vara basnamnet på Squishfilerna, eller namnet på någon av datafilerna
(filtillägget tas automatiskt bort).
-m Väljer meddelandebaser av FTSC-*.MSG-typ. Areasökvägen skall vara katalogen
i vilken meddelandebasen ligger.
-o Väljer meddelandebaser av Opus-*.MSG-typ. Areasökvägen skall vara katalogen
i vilken meddelandebasen ligger.
-j Väljer meddelandebaser av JAM-typ. Areasökvägen skall vara basnamnet på
JAM-filerna, eller namnet på någon av datafilerna (filtillägget tas
automatiskt bort).
-f Väljer meddelandebaser av FDAPX/w-typ. Kräver att parametern -a används för
att välja meddelandebassökvägen. Areasökvägen skall vara mötesnumret
(1-1999).
-t Väljer meddelandebaser av tanstaafl-typ. Kräver att parametern -a används
för att välja meddelandebassökvägen. Areasökvägen skall vara mötesnumret
(1-1999).
-p Väljer meddelandebaser av MyPoint-typ. Kräver att parametern -a används för
för att välja meddelandebassökvägen (underkatalogen AREAS). Areasökvägen
skall vara mötesnumret.
-u Väljer en Usenet news-"spool". Areasökvägen skall vara katalogen i vilken
Usenetartiklarna ligger.
Du kan bara skapa statistik från ett databasformat per anrop.
Val av topplistor:
-Q Stänger av citatvolymsvartlistan (förinställt värde är på).
-W Stänger av avsändartopplista (förinställt värde är på).
-O Stänger av originalinnehållstopplista (förinställt värde är på).
-N Stänger av nättopplistan (förinställt värde är på) (enbart Fidonet).
-T Stänger av/slår på topplistan över Internet-toppdomäner. För Usenet är
förval på, varpå denna flagga stänger av det. För Fidonet är förval av,
varpå denna flagga slår på det, men endast om RFC-gate:ade meddelanden
hittas.
-R Stänger av mottagartopplista (förinställt värde är på) (enbart Fidonet).
-S Stänger av ärenderadstopplista (förinställt värde är på).
-P Stänger av programtopplista (förinställt värde är på).
-H Stänger av postningsstatistik per timme (förinställt värde är på).
-D Stänger av postningsstatistik per dag (förinställt värde är på).
-V Stänger av visning av versioner i programtopplista (förinställt värde är
på).
Utseende på utdata:
-A Visar alla siffror i topplistorna (förinställt värde är av).
-L Använd datumformatet enligt "locale"-definition (förinställt värde är
att använda ISO-8601-format, vilket sammanfaller med EU- och svensk
norm). Observera att stödet för lokala datumformat varierar beroende på
plattform och kompilatorer.
-C <teckenkodning>
Väljer teckenkodning att använda för rapportfilerna som skapas.
Teckenkodningsnamnet kan anges med antingen dess Fidonet- eller dess
MIME-namn. Förval för Win32- och OS/2-verisonen är IBMPC (teckentabell
437), och för 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 för *.MSG-meddelandebasen i
katalogen d:\msgbase\thisarea. Flaggorna är skiftlägeskänsliga.
turqstat -?
visar en snabbhjälpskärm med en översikt över tillgängliga flaggor.
ANVÄNDNING (GRAFISK VERSION)
Den grafiska versionen av Turquoise SuperStat har samma funktionalitet som
kommandoradsversionen, men med alla funktioner tillgängliga genom ett
lättanvänt grafiskt gränssnitt. Den grafiska versionen byggs med Qt.
Huvudfönstret i den grafiska versionen innehåller statistik om den för
närvarande valda datauppsättningen, vilken ursprungligen är tom. För att ladda
statistik måste du använda menyerna, enligt nedan.
Arkiv - Öppna meddelandebas
Läser statistik för en meddelandebas och visar statistik i huvudfönstret.
Arkiv - Öppna diskussionsgrupp
Läser statistik för en diskussionsgrupp på en diskussionsgruppsserver (news)
och visar statistik i huvudfönstret.
Arkiv - Töm data
Tömmer all inläst data och återställer den visade statistiken.
Arkiv - Spara rapport
Sparar en rapport för den för tillfället inlästa uppsättningen statistik till
en textfil, med hjälp av en mall som du väljer.
Arkiv - Avsluta
Lämnar programmet.
Redigera - Välj startdatum
Låter dig välja från hur många dagar bakåt statistiken skall läsas in när du
använder dig av Arkiv - Öppna meddelandebas.
Visa
Denna meny visar de olika topplistorna som finns att tillgå. Se stycket om
kommandoradsversionen för mer detaljerade beskrivningar.
TIDSSTÄMPLAR
För att bestämma vilka meddelanden som skall täckas av statistiken eller inte
används ankomsttiden, eftersom olika meddelanden kan ta olika lång tid på sig
att komma fram. Detta säkerställer 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 för att komma fram.
Dock saknar vissa meddelandebasformat, nämligen FTSC *.MSG och tanstaafls
format, dessa ankomsttider, så gör även diskussionsgrupper som hämtas över
NNTP. Därför kommer i dessa fall datumet när texten skrivits istället att
användas. För lokalt lagrad Usenet news anses filskapandedatumet vara
ankomsttiden.
USENET I FIDONETFORMAT
Turquoise har funktionalitet för att hantera Usenetmeddelanden i Fidonetformat
om de följer gängse (de facto-)standarder. Kontrolldata enligt FSC-0035
(REPLYADDR) hanteras, och adressen däri används i stället för Fidonetadressen.
Dessutom hanteras RFC-huvudrader som skrivs direkt som Fidonetkontrollrader,
eller med prefixed "RFC-", vilka båda är vanligt förekommande.
HISTORIK
1999-06-06 - v1.0 - Första släppta version
1999-07-03 - v1.1 -
Lade till stöd för revision 3 av MyPoints meddelandedatabaser.
MyPoint använder areanummer, precis som FDAPX/w.
Listan över versioner är sorterad.
Buggfixar.
1999-07-21 - v1.2 -
Använder inte längre SMAPI, utan har egna rutiner för Squish/*.MSG.
Stöder *.MSG av både FTSC- och Opustyp.
Diverse felrättelser.
Windows- och Linuxversionerna fungerar (bättre) nu.
2000-03-25 - v1.3 -
Stöder kombinerad statistik från flera möten.
OBS! Ordningen på kommandoradsparametrarna har ändrats.
Lade till topplista över medeloriginalinnehåll per meddelande.
Lade till stöd för tanstaafl-meddelandebaser.
Lade till stöd för Usenet news-"spool".
Linuxversion distribueras som .deb-fil.
Diverse felrättelser.
2000-04-14 - v1.3.1 -
Rättade *.MSG- och news-"spool"-stöd för OS/2.
Justerade tidszonsfunktioner.
2000-05-15 - v1.4 -
Använder autoconf för lättare anpassning till nya plattformar.
Topplista över Fidonetnät och Internet-toppdomäner.
OBS! Flaggan för att visa alla siffror i topplistorna har ändrats.
Stöd för "locale"-definierade datumformat.
Hittar Internetadresser i Fidonetmöten.
Kan ange för JAM- och Squishdatabaser, inte bara basnamnet.
Korrigerade manualsidan, samt lade till en svensk.
Använder Mingw32 i stället för CygWin för Win32-versionen.
Förbättrat stöd för news.
Diverse felrättelser.
2000-11-26 - v2.0 -
Egna tidsfunktioner för att motverka tidszonsproblem i C-biblioteket.
Gjorde hjälpskärmen mer lättläslig.
Förtydligade dokumentationen.
Lade till grafisk X-version (använder Qt).
Diverse felrättelser.
2001-01-09 - v2.0.1 -
Fixade fel som kraschade newsspoolstödet.
2001-02-08 - v2.0.2 -
Korrigeringar i Debianpaketering.
2001-07-04 - v2.0.3 -
Fixade big-endian-arkitekturer.
2001-07-17 - v2.1 -
Använd OS/2- och Win32-API-funktioner för att hämta lokalt datumformat.
Implementerade datumintervall.
Lade in stöd för teckenomkodning.
2001-08-30 - v2.1.1 -
Rättade ett fel som orsakade hängning när ogiltig QP-kodning påträffades.
2001-09-15 - v2.1.2 -
Rättade problem med att kompilera mot QT3.
Kosmetisk ändring för genererade rapporter.
2001-10-04 - v2.1.3 -
Delvis fungerande hack för GCC 3.0.
2001-10-10 - v2.1.4 -
Komplett stöd för GCC 3.0.
2001-12-09 - v2.2 -
Stöd för Usenet News över NNTP.
2001-12-27 - v2.2.1 -
Rättade kompileringsfel.
2003-03-17 - v2.2.2 -
Kompilera med flertrådat Qt-bibliotek som standard.
2005-08-16 - v2.2.3 -
Rättade kompileringsfel för att bygga med moderna verktyg.
2005-09-05 - v2.2.4 -
Rättade buffertspill i datuminläsningen (CAN-2005-2658).
2008-01-21 - v3.0 -
Lade till stöd för mallar som beskriver utdataformatet.
- - - v3.1 -
Lade till stöd för utdata i HTML-format.
BIFOGADE FILER
Dokumentation:
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
Källkod:
ChangeLog - Logg över ändringar i källkoden
configure - Konfigureringsskript (kräver sh-kompatibelt skal)
Makefile.in - Indatafil för Makefile (används av configure)
configure.in - Indatafil för configure (används av autoconf)
config.h.in - Indatafil för config.h (används av configure)
turqstat.kdevelop Projektfil för KDevelop
turqstat.cpp - Huvudkällkod för Turquoise
arearead.h - Prototypfil som beskriver den abstrakta överklassen för
meddelandebasläsarna
fdapxread.cpp - Källkod för läsning av FDAPX/w-meddelandebaser
fdapxread.h - Prototypfil för ovanstående
jamread.cpp - Källkod för läsning av JAM-meddelandebaser
jamread.h - Prototypfil för ovanstående
mypointread.cpp - Källkod för läsning av MyPoint-meddelandebaser
mypointread.h - Prototypfil för ovanstående
newsspoolread.cpp Källkod för läsning av Usenet news-"spool"
newsspoolread.h - Prototypfil för ovanstående
nntpread.cpp - Källkod för läsning av Usenet news via NNTP
nntpread.h - Prototypfil för ovanstående
squishread.cpp - Källkod för läsning av Squish-meddelandebaser
squishread.h - Prototypfil för ovanstående
sdmread.cpp - Källkod för läsning av *.MSG-meddelandebaser
sdmread.h - Prototypfil för ovanstående
tanstaaflread.cpp Källkod för läsning av tanstaafl-meddelandebaser
tanstaaflread.h - Prototypfil för ovanstående
convert.cpp - Källkod för teckenkonverteringsfunktionalitet
convert.h - Prototypfil för ovanstående
mappings.cpp - Källkod med teckenkonverteringstabeller
mappings.h - Prototypfil för ovanstående
mytime.cpp - Källkod med tidsfunktioner
mytime.h - Prototypfil för ovanstående
lexer.cpp - Tokeniserare för mallar
lexer.h - Prototypfil för ovanstående
template.cpp - Parser för mallar
template.h - Prototypfil för ovanstående
output.cpp - Funktioner för att visa felmeddelanden
output.h - Prototypfil för ovanstående
statengine.cpp - Statistiksinläsningsmotorn
statengine.h - Prototypfil för ovanstående
statview.cpp - "Vyn", skapar utdatafilen
statview.h - Prototypfil för ovanstående
utility.cpp - Diverse verktygsfunktioner
utility.h - Prototypfil för ovanstående
datatypes.h - Kompilatoroberoende datatypdeklarationer
version.h - Aktuellt versionnummer
turqstat.def - Applikationstitelfil för OS/2
qtbars.cpp - Postningsfrekvensfönster (Qt)
qtbars.h - Prototypfil för ovanstående
qtgui.cpp - Huvudfönster (Qt)
qtgui.h - Prototypfil för ovanstående
qtlist.cpp - Listfönster (Qt)
qtlist.h - Prototypfil för ovanstående
qtprogress.cpp - Enkel förloppsindikator (Qt)
qtprogress.h - Prototypfil för ovanstående
qtreport.cpp - Statistikspararfönster (Qt)
qtreport.h - Prototypfil för ovanstående
teal.cpp - Enkelt teckenkonverteringsprogram
Katalogen mappings:
Makefile.in - Indatafil för Makefile (används av configure)
makemappings.pl - Perlprogram som skapar C-kod från tabellfiler
*.txt - Officiella konverteringstabeller
Katalogen po:
Makefile.in - Indatafil för Makefile (används av configure)
update-po.sh - Skalprogram som uppdaterar PO-filerna
xturqstat.po - Källfil för översättningarna (Qt)
*.po - Översättningar (Qt)
Katalogen visualc:
turqstat.sln - Arbetsyta för Visual C++
turqstat.vcproj - Projektfil för Visual C++
OS/2 distribution:
config.h - config.h att använda om du inte kan köra configure (EMX)
Makefile - Makefile att använda om du inte kan köra configure (EMX)
turqstat.exe - Körbar fil (OS/2, EMX)
README.os2 - Information om OS/2-versionen
Win32 distribution:
turqstat.exe - Körbar fil (Win32 i386, Visual C++ Express)
README.Win32 - Information om Win32-versionen
Underkatalogen debian innehåller kontrollfiler för att skapa ett binärpaket för
Debian.
TACK
Tack till Dan Gohman <[email protected]> för hjälp med anpassning till
GNU C++ 3.0. Tack till Martin Michlmayr <[email protected]> för hjälp med
anpassning till GNU C++ 4.3.
KRAV FÖR KOMPILERING
Programmet utvecklades under Debian 4.0 med gcc 4.1, Mac OS X 10.5 med gcc 4.0
och Win32 med Visual C++ 2008 Express Edition. Programmet har tidigare
utvecklats under OS/2 med EMX 0.9d/GNU C/C++ 2.8.1 och Win32 med Mingw32
(gcc 2.95.2).
Den grafiska versionen kräver att Qt version 2.3 eller senare finns
installerat.
Om du vill skapa ett Debianpaket måste du installera Debians utvecklingspaket,
bland andra debhelper och fakeroot (om du inte vill kompilera som root).
Därefter skriver du "fakeroot debian/rules binary" (utan citattecknen) vid
kommandosymbolen. Om du även vill tillverka Debians arkivstyrfiler använder du
dpkg-buildpackage.
KONTAKT
Författaren, Peter Krefting, kan nås via Internet-e-post på
<[email protected]>. Information om programmet finns på webben på
http://www.softwolves.pp.se/sw/