
 ͸
                           YAPPDEX.EXE versie 7.2                          
                           Door Max PE1RCY @ DDS.NL                        
                                22 Maart 1998                              
 ;

 - Yappdex 7.2 is identiek aan 7.1 alleen de expire date is verlengd
   tot 31-december-1999. Overal waar 7.1 in deze documentatie geldt dus
   ook voor versie 7.2.

 Inhoud:

 1. Intro.
 2. Licentie.
 3. Installatie en gebruik.
 4. Verklaring diverse bestanden.
 5. Programmaverloop YAPPDEX.
 6. Geschiedenis.
 7. Binnenkort ook te verwachten.
 8. Tot Slot.


 1. Intro.

    YAPPDEX.EXE is een utility voor FBB 5.15x.
    Het is een uitbreiding op de door mij reeds eerder uitgebrachte
    YAPPSORT.EXE v3.0. !
    De sortering door YAPPDEX is dus gelijk aan die van YAPPSORT v3.0.
    YAPPDEX heeft echter extra mogelijkheden zoals hieronder beschreven,
    lees en draai nu je eigen BBS-files-lijst !

    1 Het programma sorteert de welbekende YAPPLBL.SYS file, die alle file-
      omschrijvingen bevat. (zie ook EXAMPLE.TXT)
      Alle bestanden die niet meer aanwezig zijn in de betreffende directory
      worden verwijderd uit de YAPPLBL.SYS.
    2 Maakt in elke directory een FILES.BBS file aan.
    3 Maakt een INDEX.TXT aan (met nieuwe file indicatie * ).
    4 Toont alle files tijdens YAPPDEX proces op het scherm. (voor controle)
  * 5 Maakt in elke directory een DESCRIPT.ION file aan.
  * 6 Geeft File Totalen in de INDEX.TXT, per sub-dir en totaal !

    Gebruik van een Disk-Cache-programma wordt STRIKT aangeraden, het versnelt
    de sortering enorm, en verminderd het aantal lees-acties van de harddisk !


 2. Licentie.

    YAPPDEX.EXE 7.1 is ShareWare. De auteur is NIET verantwoordelijk voor 
    enige schade veroorzaakt door of met het werken met YAPPDEX. Hoewel
    het programma geen copyrights heeft, toch de volgende beperkingen:

    Het is NIET toegestaan:
    - enige veranderingen in het programma aan te brengen
    - het programma zonder de volgende files door te geven:
        FILE_ID  DIZ           259 01-03-97   7:10a
        LEESMIJ  TXT        14,... 22-03-98
        README   TXT        14,... 01-03-97   7:10a
        EXAMPLE  TXT         8,690 01-03-97   7:10a
        YAPPDEX  INF           597 01-03-97   7:10a
        YAPPDEX  CFG           548 01-03-97   7:10a
        YAPPDEX  EXE        39,730 01-03-97   7:10a
        YDEX_NL  ZIP         1,186 01-03-97   7:10a
        YDEX_GB  ZIP         1,189 01-03-97   7:10a

    Je mag WEL:
    - dit programma voor niet-commercile doeleinden gebruiken
    - ongelimiteerd kopien maken en doorgeven



 3. Installatie en gebruik.

 3.1 Installatie.

   YAPPDEX.EXE maakt GEEN gebruik meer van de INIT.SRV file !
                     ====
   Plaats de YAPPDEX-files een directory waar je wilt !
   Bv.: C:\FBB\YAPPDEX\

   LET OP dat je niet per ongeluk je vorige .TOP,.DTP en .BOT wist !

     C:\FBB\YAPPDEX\ YAPPDEX.EXE 
     C:\FBB\YAPPDEX\ YAPPDEX.CFG 
     C:\FBB\YAPPDEX\ YAPPDEX.TOP    *    \
     C:\FBB\YAPPDEX\ YAPPDEX.DTP    *     |- YDEX_GB.ZIP / YDEX_NL.ZIP
     C:\FBB\YAPPDEX\ YAPPDEX.BOT    *    /

     ad. * :   Deze files vindt u in een zip-file, gebruik de gewenste
               taal, en zet deze in de FBB\YAPPDEX dir. (slechts 1 taal
               kan gebruikt worden)

 Edit de files YAPPDEX.CFG en YAPPDEX.TOP/.DTP/.BOT naar je eigen voorkeur.!
 (De instellingen in de YAPPDEX.DTP zijn standaard al goed.)

 De YAPPDEX.CFG file bevat commentaar/informatie over de para-
 meters in deze file. Ik denk dat het commentaar in de file zelf
 vrij duidelijk is om de functies te begrijpen. Regels beginnend met
 '#' in eerste kolom zijn tekst-regels en worden niet in beschouwing genomen.

 Voor uitgebreidere informatie over de YAPPDEX.CFG parameters zie
 hieronder.


 3.2 Gebruik.

 Start YAPPDEX wanneer de BBS NIET DRAAIT !!
 Start YAPPDEX vanuit de FBB dir, daar waar je hem hebt geplaatst.

 DE INDEX.TXT FILE WORDT GEPLAATST IN DE FBB\SYSTEM DIR, DAAR WAAR OOK
 JE YAPPLBL.SYS STAAT.!!!

 YAPPDEX gebruikt command-line parameters om bepaalde funkties te
 activeren. Dit betekend dat je achter de DOS-prompt YAPPDEX start
 met daarachter een spatie en dan vier mogelijke LETTERS.
 vb.:  C:\FBB\YAPPDEX FIST

 De LETTERS (extra commandline-parameters) hebben de volgende betekenis:
 F  - creeer FILES.BBS files in elke (sub-)DIRECTORY.       (Files.bbs)
 D  - creeer DESCRIPT.ION files in elke (sub-)DIRECTORY.    (Descript.ion)
 I  - creeer INDEX.TXT file (allfiles.txt van alle files)   (Index)
 S  - toon alle files op het scherm tijdens YAPPDEX-run.    (Show)
 T  - behoud alle files in YAPPLBL.SYS (niet meer aanwezige files worden
      toch opnieuw weggeschreven in nieuwe YAPPLBL.SYS)     (Toch)
 L  - creeer een log-files van het proces (voor debug)      (Logging)


 NORMAAL gebruik je alleen de parameters F en I, voor het sorteren van de
 yapplbl.sys, het aanmaken van files.bbs files, en een index.txt.
 vb.:  C:\FBB\YAPPDEX FI

 ALLEEN SORTEREN is mogelijk door het starten van YAPPDEX  ZONDER
 parameters.

 Kort overzicht van mogelijke combinaties:
 YAPPDEX      - alleen sorteren
 YAPPDEX I    - sorteren; index
 YAPPDEX IF   - sorteren; files.bbs files en index
 YAPPDEX FTI  - sorteren (alle files behouden); files.bbs en index
 YAPPDEX SI   - sorteren; op scherm tonen en index
 YAPPDEX FDIL - sorteren; files.bbs, descript.ion, index.txt, yappdex.log
 Zo zijn dus diverse combinaties mogelijk. Volgorde van de letters
 maakt niet uit.


*   LET OP !:
*
*   Ik raad aan om bij grote aantallen files met omschrijvingen de sortering
*   niet dagelijks in de 'housekeeping' te zetten, deze wordt dan onnodig
*   vertraagd.




4.  Verklaring diverse bestanden.

YAPPDEX maakt gebruik van diverse bestanden. Het gebruik en de
uitleg van deze bestanden volgt hieronder.

4.1.  YAPPDEX.CFG.

In deze file moet je de BBS-call veranderen en de directories welke
je in de YAPPDEX.TXT wilt terug-zien.

De volgorde van de 'parameters' is vastgelegd en kan niet veran-
dert worden !
Regels beginnend met een '#' zijn de commentaar-regels en worden
overgeslagen tijdens het inlezen van de instellingen.

#
# >>>>   YAPPDEX.CFG config-file for YAPPDEX v7.1   <<<<<
#
# Do not change the sequence/order in this file, your YAPPDEX
# simple won't work right ! Lines starting with # are comments.
#
# Callsign of the BBS.
NB1BBS
#
# NEW!!  FBB-system directory where your YAPPLBL.SYS is situated.
C:\FBB\SYSTEM\
#
# Drive and corresponding path to INCLUDE in YAPPDEX.TXT.
# You can define only 2 lines, thus only 2 different paths.
# YOU MUST END THE PATH WITH A '\'  !!
# ex.:  C: D:\USERS\
#       P: D:\P\
C: D:\USERS\
P: D:\DONATEUR\

De drive en path indicatie werken alsvolgt:
Je geeft eerst op wat je in de yappdex.txt wilt zien als drive/path
aanduiding. bv.  C:  Daarachter zet je het werkelijke path ! bv. D:\USERS\

Zo kun je eenvoudig een P: drive tonen, terwijl het in werkelijkheid in
de D:\DONATEUR\ dir staat.


Het resultaat, INDEX.TXT, wordt geplaatst in de FBB\SYSTEM dir, daar waar
ook de YAPPLBL.SYS file staat.

Vb. van de INDEX.TXT file:
͸
 Dir : P:\DONATEUR\                                                           
   Donateur dir.                                        
;

 INFO.ZIP          133  28-07-95    Info file donators.
 TEST.ZIP        13756  28-07-95    Test for this doc.
 NEW.ZIP         14698  28-07-95    New donators info.

͸
 Dir : C:\7PLUS\                                                              
   Diverse 7plus-files.                                 
;

 7INF.ZIP          133  28-07-94    Info file over 7+.
 7MIN.ZIP        13756  28-07-94    ?
 7P.ZIP          13756  28-07-94    7+ makkelijker uploaden/verzenden.

 //-- END Yappdex --//



4.2.  YAPPDEX.TOP

De YAPPDEX.TOP file is een text-file die bovenin de INDEX.TXT wordt
gezet. De tekst-file kan maximaal 100 regels (80 kar.) omvatten.

Standaard-inhoud YAPPDEX.TOP:
/***************************************************************************/
/*                           YAPPDEX.TOP                                   */
/*               PLAATS HIER BV. ALGEMENE INFO OVER DE FILES               */
/*                            IN JE BBS                                    */
/***************************************************************************/




4.3.  YAPPDEX.DTP

YAPPDEX.DTP is een file die speciale aandacht vraagt.

Hij ziet er standaard alsvolgt uit:
͸
 Dir : $dir70$                                                                
   $label40$                                            
;

Het draait hier om de woorden $dir70$  en  $label40$ .

$dir70$ geeft aan dat hier een Directory-path-lengte van maximaal 70 karakters
        komt te staan. Minimaal is het ook 70 karakters ! Zorg dus dat je dit
        woord ergens links in de eerste 10 kolommen hebt staan, anders valt
        het pad eraf..
$label40$ geeft aan dat hier het label van bovengenoemde directory wordt
          geplaatst. Maximum en Minimum 40 karakters..
          Ergens in de 1e 40 kolommen vanaf links laten starten..

Je kunt met deze file experimenteren, maar de resultaten kunnen verrassend
zijn.
Verder heeft de YAPPDEX.DTP file een limiet van 10 regels van 80 karakters
breed.

vb. dat ook werkt:
͸
͵
   $label40$                                 
 Dir :  $dir70$                                                               
͵
;

4.4.  YAPPDEX.BOT

YAPPDEX.BOT is een tekst-file die aan het einde van de INDEX.TXT wordt
geplaatst. De tekst-file kan maximaal 100 regels (80 kar.) omvatten.

Standaard-inhoud YAPPDEX.BOT:
/***************************************************************************/
/*                           YAPPDEX.BOT                                   */
/*               PLAATS HIER BV. INFO OVER JE BBS O.I.D.                   */
/*                                                                         */
/***************************************************************************/

4.5   YAPPDEX.DAT

YAPPDEX.DAT is een file die wordt aangemaakt indien hij nog niet bestaat.
YAPPDEX plaatst deze file in dezelfde dir (C:\FBB).
De file wordt gebruikt om te bepalen wanneer er de laatste keer een INDEX
is gedraaid. Als deze file niet aanwezig is, krijgen alle files die de
laatste maand (vanaf dag draaien) zijn ingevoerd in YAPPLBL.SYS een * in
de INDEX.TXT-file.



5.1 Werkingswijze:

    - YAPPDEX zoekt naar de YAPPLBL.SYS file in de system-dir, zoals je
      die hebt opgegeven in de YAPPDEX.CFG.!!
    - Je kunt YAPPDEX.EXE handmatig opstarten met bv.:
      C:\FBB\YAPPDEX>YAPPDEX FI<ENTER>
    - YAPPDEX kan meerdere volumes aan. (C:, D:)
      Yappdex moet dan wel toegang hebben op deze drives !
      CDROM-drives moet een/DE CD-bevatten..!
    - Mocht er een fout optreden tijdens de sortering, dan stopt het programma.
      De originele YAPPLBL.SYS file is dan onverandert en beschikbaar voor FBB.
      Mogelijkerwijs is er dan een file onvolledig aangemaakt met de naam
      YAPPLBL.NEW. Deze kan niet gebruikt worden.
      Pas na bestaanbaarheids- en korrektheid-controle wordt de originele
      YAPPLBL.SYS hernoemt naar YAPPLBL.OLD. Een reeds bestaande YAPPLBL.OLD
      file wordt eerst verwijderd ! Vervolgens wordt YAPPLBL.NEW hernoemt tot
      YAPPLBL.SYS.


 5.2 Programmaverloop YAPPDEX.

    - Bepaal aantal records.
    - Inlezen van tabel met yapplabel pointers.
    - Controle bestaanbaarheid van files.
    - Sorteren van de tabel.
    - Schrijven YAPPLBL.NEW.
    - Optie afdrukken op scherm.     C:\FBB\>yappdex S 
    - Optie FILES.BBS files creeeren in alle (sub-)dirs.
    - Optie DESCRIPT.ION files creeeren in alle (sub-)dirs.
    - Optie INDEX.TXT aanmaken.
    - Verwijderen oude YAPPLBL.OLD.
    - Hernoemen YAPPLBL.SYS naar YAPPLBL.OLD.
    - Hernoemen YAPPLBL.NEW naar YAPPLBL.SYS.

    - Vb. voor de wijze van sorteren voor en na YAPPDEX zie de file
      EXAMPLE.TXT

 6. Geschiedenis.

    Ver. 3.1  Februari 1995
    - Eerste versie van YAPPDEX.EXE, nooit vrijgegeven.

    Ver. 5.2  7 October 1995
    - Programma gestroomlijnd, niet vrijgegeven.

    Ver. 6.0  16 December 1995
    - Programma vrijgegeven, van DOCUMENTATIE voorzien.

    Ver. 7.0  23 Januari 1997
    - Programma aangepast, snelheid verhoogt, opties toegevoegd.
    - Beta versie in test bij NL3ONB.

    Ver. 7.1  15 Februari 1997
    - Programma documentatie aangepast.
    - Gereed maken voor vrijgeven versie 7.1.

 7. Over een aantal maanden te verwachten:

    - IMPORT v2.0    Import programma dat files.bbs files importeerd in de
                     yapplbl.sys.
                     Ik ben er helaas nog niet aan toegekomen om hier tijd
                     in te stoppen zodat het programma vrijgegeven kan
                     worden. Hopelijk kan ik er z.s.m. aan werken.


 8. Tot Slot.

    Ik heb de YAPPDEX ontwikkeld wegens gebrek aan een goed index prg voor
    de YAPPLBL.SYS.

    Dit programma is geen poging om te concurreren met reeds bestaande
    YAPPLBL-index programma's.

    Speciale dank aan NL3ONB voor het beta-testen van de YAPPDEX, het heeft
    geleid tot een nog betere YAPPDEX !

    Ok, succes met YAPPDEX !

    73 de Max, PE1RCY @ WORLDACCESS.NL (Internet)
               PE1RCY @ PI8GCB.#NH2.NLD.EU (Packet-Radio)

- EOF -
