home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / Y3_00.ZIP / Y_LIST.DOC < prev    next >
Text File  |  1993-03-28  |  12KB  |  391 lines
  1. Y_LIST versie 3.00 (28/03/93)          Copyright (c) Berry Van Hombeeck, 1993
  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.                           Allfiles list generator
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. INHOUD
  40. ------
  41.  
  42.  
  43.     1. Wat is Y_List ? .......................... 2
  44.  
  45.     2. Installatie .............................. 2
  46.  
  47.     3. Y_List.cfg ............................... 2
  48.  
  49.     4. Y_List.dsc ............................... 4
  50.  
  51.     5. Opstarten ................................ 5
  52.  
  53.     6. Normaal verloop .......................... 6
  54.  
  55.     7. Omgekeerd verloop ........................ 6
  56.  
  57.     8. Rekening gehouden met .................... 7
  58.  
  59.     9. Beperkingen .............................. 7
  60.  
  61.  
  62.  
  63.  
  64. 1. Wat is Y_List ?
  65. ----------------
  66. Wel, Y_List is eigenlijk een eenvoudige en beknoptere versie van het befaamde
  67. X_List.
  68.  
  69. Y_List analyseert het freq-bestand van FrontDoor en maakt een allfiles lijst
  70. aan. Het bazeert zich op een eventuele vorige versie om de file-beschrijvingen
  71. te vinden.
  72.  
  73.  
  74.  
  75.  
  76. 2. Installatie
  77. --------------
  78. Niets eenvoudiger dan het installeren van Y_List.
  79.  
  80. Het Y_List-pakket komt ge-arj-t en bestaat uit deze 5 files :
  81.  
  82.     Y_LIST.EXE    67866 bytes    Het eigenlijke programma
  83.     Y_LIST.CFG     3860 bytes    De config-file
  84.     Y_LIST.DOC    12148 bytes    Deze documentatie-file
  85.     Y_LIST.HDR     1102 bytes    Een voorbeeld van een header-file
  86.     Y_LIST.DSC        214 bytes    Een voorbeeld van een desc-file
  87.  
  88. Plaats Y_LIST.EXE en Y_LIST.CFG bij voorkeur in uw FD-directory. Dit is 
  89. niet verplichtend, maar plaats beide files wel TESAMEN in 1 directory.
  90.  
  91.  
  92.  
  93.  
  94. 3. Y_List.cfg
  95. -------------
  96. Nu het moeilijkste stuk : het aanpassen van de Y_LIST.CFG file.
  97.  
  98. Y_LIST.CFG is een ASCII-file met daarin een aantal belangrijke lijnen,
  99. die gemakkelijk te editeren zijn met een programma- of Ascii-editor.
  100. (Elke lijn beginnend met een ; wordt genegeerd)
  101.  
  102. Volgend formaat MOET behouden blijven :
  103.  
  104. NAAM <commando>
  105.  
  106. Voorbeeld met uitleg over de cfg-file:
  107.  
  108. DIR C:\Fd\Req_Dir.Fd_
  109.     Dit naar eigen instelling veranderen.
  110.     Dit verwijst naar het freq-bestand dat door FrontDoor wordt gebruikt
  111.     om file-request te honoreren.
  112.  
  113.  
  114.  
  115.                                      Blz 2
  116.  
  117.  
  118.  
  119. LIST C:\Files\Allfiles.lst
  120.     De naam en het path van de eigenlijke allfiles lijst.
  121.     De beschrijvingen hieruit zullen gebruikt worden om de nieuwe aan
  122.     te maken.
  123.  
  124. NEWLIST C:\Files\Newfiles.lst   (facultatief)
  125.     De naam en het path van de lijst met de nieuwe files sinds xx dagen.
  126.     Het aantal dagen wordt bepaald door het keyword NEWDAYS.
  127.     Zet een ; voor de lijn om geen Newfiles lijst aan te maken.
  128.  
  129. NEWDAYS 7                       (facultatief)
  130.     De maximale ouderdom, in dagen, van de files in de Newfiles lijst.
  131.  
  132. NEWSTAR                         (facultatief)
  133.     Geeft aan dat er in de Allfiles lijst een sterretje (*) moet komen
  134.     voor de beschrijving van een bestand wanneer dit werd geselecteerd
  135.     om in de Newfiles lijst te komen.
  136.  
  137. LOG  c:\Fd\Log\Y_List.log
  138.     Dit is de naam van het log-bestand dat door Y_List wordt aangemaakt.
  139.  
  140. HEADER c:\Fd\Y_List.Hdr        (facultatief)
  141.     Dit is het path en de naam van het bestand hetwelke bovenaan de
  142.     Allfiles lijst zal geplaatst worden. Hierin kan eventueel de naam van
  143.     het BBS komen, samen met de gevoerde magic-names. (Zie ook bijgeleverd
  144.     voorbeeld)
  145.  
  146. NEWHEADER c:\Fd\Y_Listnw.hdr    (facultatief)
  147.     Dit isd het path en de naam van de tekst-file dewelke bovenaan de
  148.     Newfiles lijst zal geplaatst worden.
  149.  
  150. DESC c:\Fd\Y_List.dsc
  151.     Het path en de naam van het bestand waarin Y_List de beschrijving
  152.     vindt van de areas. (Zie ook bijgeleverd voorbeeld)
  153.  
  154. NO_COMMENT <No description given yet>  (facultatief)
  155.     Deze beschrijving wordt aan een bestand gegeven indien er geen
  156.     andere of vorige werd gevonden.
  157.  
  158. EXCL_DIR c:\files\files007        (facultatief)
  159.     De files uit deze freq-directory zullen niet mee in de allfiles lijst
  160.     worden opgenomen.
  161.  
  162. EXCL_FILE files.bbs            (facultatief)
  163.     Deze file (uit eender welke directory) zal niet mee in de lijst worden
  164.     opgenomen.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                                      Blz 3
  171.  
  172.  
  173.  
  174. BBS [c:\files]                (facultatief)
  175.     Het path van het bestand FILES.BBS (Wordt ook door GoldED gebruikt)
  176.     Indien er van een bepaalde file geen beschrijving gevonden is in de
  177.     vorige lijst, zal Y_List geen zoeken in het bestand FILES.BBS.
  178.     Laat u het path weg, dan zal gezocht worden in het bestand FILES.BBS
  179.     dat zich in de file-area zelf bevindt (zoals RA dit verwacht).
  180.     (Zie ook punt 3. hieronder)
  181.  
  182. DOS ARJ a -jm -e d:\allfiles.arj c:\files\allfiles.lst    (facultatief)
  183.     Indien bvb de lijst moet verwerkt worden in een arj-archief, geef hier
  184.     dan de VOLLEDIGE lijn zoals die ook vanuit DOS zou gegeven worden.
  185.  
  186. Deze lijnen mogen naar eigen goeddunken veranderd en/of geschikt worden.
  187.  
  188.  
  189.  
  190.  
  191. 4. Y_List.dsc
  192. -------------
  193. Dit bestand heeft twee doelen. Ten eerste een beschrijving geven van de
  194. verschillende areas, en ten tweede aangeven welke hoofding er bij een bepaalde
  195. area hoort. Een voorbeeld-lijn :
  196.  
  197. D:\FILES\GENERAL  #2Algemene Area
  198. ^^^^^^^^^^^^^^^^  ^^
  199.         |         | ^^^^^^^^^^^^^
  200.         |         |        |_ Beschrijving van de area
  201.         |         |
  202.         |         |__________ Nummer van de hoofding (#1, #2 of #3)
  203.         |                     OPGELET! Dit is niet het nummer van de area
  204.         |
  205.         |____________________ De directory die bij de area hoort
  206.  
  207. Wanneer geen nummer van de hoofding (#x) werd gegeven wordt automatisch
  208. hoofding 1 aangemaakt. Wanneer geen beschrijving wordt gegeven, wordt auto-
  209. matisch de naam van de directory als beschrijving verondersteld.
  210. Ter info het formaat van de verschillende hoofdingen :
  211. #1:
  212. ┌─────────────────────────────────────────────────────────────────────────────┐
  213. │ ░░▒▒▓▓██ Area : GENERAL [ Algemene files en DOS utilities ]        ██▓▓▒▒░░ │
  214. └─────────────────────────────────────────────────────────────────────────────┘
  215.  
  216. #2:
  217. ╓──────────╥──────────────────────────────────────────────────────────────────╖
  218. ║ Area   3 ║ MODEM   [ Modem en communicatieprogramma's ]                     ║
  219. ╙──────────╨──────────────────────────────────────────────────────────────────╜
  220.  
  221. #3:
  222. ╒═══════╤═════════════════════════════════════════════════════════════════════╕
  223. │ #   6 │ BETATEST [ Beta-release programma's ]                      ██▓▓▒▒░░ │
  224. ╘═══════╧═════════════════════════════════════════════════════════════════════╛
  225.                                      Blz 4
  226.  
  227.  
  228.  
  229. 5. Opstarten
  230. ------------
  231. Om nu een Allfiles lijst aan te maken typ je gewoon vanuit het DOS-prompt :
  232.  
  233.     C\FD> Y_List
  234.  
  235. Mocht u Y_List willen runnen met een andere cfg bestand dan kan dit door simpel-
  236. weg de naam van het andere cfg bestand in te typen als command-line optie :
  237.  
  238.     C\FD> Y_List ANDERE.CFG
  239.  
  240. Als u geen opzoekingen wil doen in uw vorige, oude Allfiles lijst, maar enkel
  241. in de bestanden FILES.BBS, dan kan u de optie /I (van Ignore) meegeven :
  242.  
  243.     C\FD> Y_List /I
  244.  
  245. U kunt Y_List ook gebruiken om vertrekkende van uw Allfiles lijst de bestanden
  246. FILES.BBS te creeren, die nodig zijn voor bvb Remote Access.
  247. Hiervoor geeft u de command-line optie /R (van Reverse).
  248.  
  249.     C\FD> Y_List /R
  250.  
  251. Een combinatie van de verschillende opties is eveneens mogelijk, bvb
  252.  
  253.     C\FD> Y_List ANDERE.CFG /R
  254. of
  255.     C\FD> Y_List /I NOGEEN.CFG
  256.  
  257. Er dient wel gezegd dat volgende combinatie toegelaten doch zinloos is :
  258.  
  259.     C\FD> Y_List /I /R WEETNIET.CFG
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.                                      Blz 5
  281.  
  282.  
  283.  
  284. 6. Normaal verloop
  285. ------------------
  286. Hoe loopt nu het programma :
  287.  
  288. - De bestanden HEADER en NEWHEADER worden voor de respectievelijke lijst
  289.   geplaatst.
  290.  
  291. - Het REQ_DIR.FD_ bestand wordt ingelezen en geanaliseerd. De verschillende
  292.   directories worden ingelezen en voorzien van een hoofding. Indien er een
  293.   description-file is gegeven (DESC) zal elke area voorzien worden van zijn
  294.   beschrijving. Is die er niet, dan is de directory-naam de area-beschrijving.
  295.   Y_List zal uit een eventuele vorige versie de beschrijvingen halen van de
  296.   verschillende files, tenzij de optie /I is meegegeven. Moest de naam hier
  297.   niet in voorkomen dan kan ook gezocht worden in het bestand FILES.BBS. Hierin
  298.   kan ook een ruimere bestandsnaam gegeven worden. Bvb voor de nodediffs die
  299.   telkens een andere extentie krijgen, kan het volgende in dat bestand staan :
  300.     NODEDIFF.  Laatste FidoNet Nodediff
  301.   Wanneer hiermee gezocht wordt, zal elke nodediff die beschrijving meekrijgen.
  302.   Wildcard, ook jokers genoemd zijn echter NIET toegelaten.
  303.   Indien toch niets werd gevonden, zullen de bestanden voorzien worden van de
  304.   bescchrijving die ingegeven is met het keyword NO_COMMENT. Deze lijnen
  305.   kunnen dan met een eventuele tekst-editor veranderd en aangepast worden.
  306.   Als er een Newfiles lijst naam is ingegeven dan wordt er gekeken of het
  307.   bestand qua datum voldoet aan de gestelde eisen en zo ja dan wordt dit
  308.   opgenomen in de Newfiles lijst.
  309.  
  310. - In de LOG file worden enkele statistieken bijgehouden, zoals aantal files,
  311.   aantal nieuwe files, gescande directories, fouten, etc...
  312.  
  313. - Indien één of meerdere keywords DOS worden gevonden worden deze uitgevoerd.
  314.  
  315.  
  316.  
  317.  
  318. 7. Omgekeerd verloop (/R)
  319. -------------------------
  320. Wanneer de commando-lijn optie /R werd meegegeven dan zal het programma als
  321. volgt lopen :
  322.  
  323. - Het bestand REQ_DIR.FD_ wordt ingelezen en geanaliseerd. De verschillende
  324.   directories worden gelezen en van elk bestand dat in een bepaalde directory
  325.   aanwezig is, wordt de beschrijving uit de Allfiles-lijst gehaald. De naam
  326.   wordt dan samen met de beschrijving weggeschreven naar een bestand
  327.   FILES.BBS in diezelfde directory.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                      Blz 6
  336.  
  337.  
  338.  
  339. 8. Rekening gehouden met...
  340. ---------------------------
  341. Bij het aanmaken wordt rekening gehouden met :
  342.  
  343.     - De area waarin de file geplaatst is.
  344.  
  345.     - De beschrijving die reeds werd gegeven.
  346.  
  347.     - Het ingeven van een hoofding is facultatief.
  348.  
  349.     - De beschrijving van de areas indien ze voorzien zijn.
  350.  
  351.     - Het type hoofding van de areas.
  352.  
  353.     - Als het getal achter NEWDAYS kleiner is dan 1, dan wordt er geen
  354.       Newfiles lijst aangemaakt.
  355.  
  356.  
  357.  
  358. 9. Beperkingen
  359. --------------
  360.  
  361. Zoals elk goed programma heeft ook dit zijn beperkingen.
  362.  
  363.     - Zowat de grootste en belangrijkste beperking is het feit dat
  364.       de extentie van de allfiles.lst uit EXACT 3 karakters moet bestaan.
  365.  
  366.     - De beschrijving van een directory mag maximaal 51 karakters lang
  367.       zijn.
  368.  
  369.     - De beschrijving van een bestand mag hooguit 48 karakters tellen.
  370.  
  371.     - Er mogen slechts 20 lijnen zijn van elk volgend keyword :
  372.         EXCL_DIR
  373.         EXCL_FILE
  374.  
  375.     - Van het keyword DOS zijn slechts 5 lijnen toegestaan.
  376.  
  377.     - Uw OS moet de datum weergeven in het Europees formaat (dd-mm-yy)
  378.  
  379.  
  380.  
  381. Met dank aan...
  382. ---------------
  383. Het A-Team en zijn sympathisanten voor het testen en aanbrengen van ideeen.
  384.  
  385.  
  386. Berry Van Hombeeck
  387. FidoNet  2:292/901
  388. ZyXELNet 16:900/140
  389.  
  390.                                      Blz 7
  391.