home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / view102.zip / VIEWER.DOC < prev    next >
Text File  |  1993-11-09  |  10KB  |  461 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                        IBBS FILE-VIEWER DOCUMENTATION
  17.  
  18.  
  19.                                    v1.02
  20.  
  21.  
  22.                     (C) 1993 Kristinn Tomasson and ISoft
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                             2:231/339.30@FidoNet
  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. IBBS FILE-VIEWER DOCUMENTATION                                          Page 1
  61. ───────────────────────────────────────────────────────────────────────────────
  62.  
  63. TABLE OF CONTENTS
  64.  
  65.  
  66.         1   INTRODUCTION..........................................2
  67.         1.1     INTRODUCTION (and program features)...............2
  68.         1.2     COPYRIGHT NOTICE..................................2
  69.         1.3     REGISTRATION......................................2
  70.  
  71.         2   CONTENTS OF ARCHIVE...................................3
  72.         2.1    CONTENTS OF THE ARCHIVE IVIEW100.ARJ...............3
  73.  
  74.         3   INSTALLATION..........................................4
  75.         3.1     SETUP UNDER USING DORINFO1.DEF (RA, SBBS).........4
  76.         3.2     SETUP UNDER OTHER BBS.............................4
  77.  
  78.         4   PARAMETERS............................................5
  79.         4.1     EXAMPLES OF USE...................................6
  80.  
  81.         5   HISTORY...............................................7
  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. IBBS FILE-VIEWER DOCUMENTATION                                          Page 2
  121. ───────────────────────────────────────────────────────────────────────────────
  122.  
  123. 1.1 INTRODUCTION
  124.  
  125.         This program was created because a number of people had complained
  126. about not being able to scroll up or down in an ANSI/ASCII file. I therefore
  127. decided to add it to the IBBS colection of programs.
  128.  
  129.         Thanks go to Thomas Bj¢rk, without whom I could never have created all
  130. those Fossil Routines. Henrik Dahm at the Sapphire Public Network, also gets
  131. some thanks as he testst all the IBBS routines, I create.
  132.  
  133.         The program features:
  134.  
  135.         ■ CARRIER DETECT   - if a user drops carrier, the program will
  136.                              automatically terminate.
  137.                            
  138.         ■ INACTIVITY TIMER - if a user does not press a key for more than
  139.                              5 minutes, the program will automatically return
  140.                              to the BBS.
  141.  
  142.         ■ TIMEOUT          - the program continually monitors the users
  143.                              timeleft counter, and if it goes below 5 minutes,
  144.  
  145.         ■ CLRSCR EXTRACT   - the program creates a temporary file where all
  146.                              ANSI ClearScreen codes () have been removed.
  147.  
  148.         ■ LOG FILE         - The program generates a LOG file, where all major
  149.                              events are registered, it should be deleted once
  150.                              in a while to reduce the amount of space occupied.
  151.  
  152.  
  153. 1.2 COPYRIGHT NOTICE
  154.  
  155.         This program is Copyright 1993 by Kristinn Tomasson and ISoft. It is
  156. forbidden to dissasemble or modify this program in any way. The documentation
  157. which accompanies the program is also copyright, and may not be reproduced,
  158. or modified in any way, except for personal use. Nor may the Documentation be
  159. redistributed in any way without the accompanying program; VIEWER.EXE
  160.  
  161.  
  162. 1.3 REGISTRATION
  163.  
  164.         We at ISoft have changed registration policy slightly. Previously it
  165. was necessary to register each and every BBS utility. But with the release of
  166. IBBS FILE-VIEWER v1.00 we have decided that when you register one IBBS product
  167. you register them all. In order to register please see the accompanying file
  168. REGISTER.TXT for details. The current price is DKK 75,- for one license, this
  169. however can vary, according to currency and exchange rates, and I would suggest
  170. that you write a NetMail to me at adress 2:231/339.30@FidoNet, to aquire the
  171. latest prices.
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180. IBBS FILE-VIEWER DOCUMENTATION                                          Page 3
  181. ───────────────────────────────────────────────────────────────────────────────
  182.  
  183. 2.1 CONTENTS OF THE ARCHIVE IVIEW100.ARJ
  184.  
  185.  
  186.         The following files should be contained in the archive you just
  187. recieved:
  188.  
  189.         FileName      Size (bytes)   Description
  190.         VIEW.EXE                     The Executable File.
  191.         VIEW.DOC                     This file, the documentation.
  192.         REGISTER.TXT                 The registration Form.
  193.         IBBS.LST                     The List of IBBS Products.
  194.  
  195.  
  196.         If any of these files were missing, I suggest that you call the
  197. Sapphire Public network (2:231/339@FidoNet) Tel. +45-3672 8139 for a new copy
  198. and possibly a new release.
  199.  
  200. New releases are announced in the NEWFILES_R23.PUB conference in the FidoNet.
  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. IBBS FILE-VIEWER DOCUMENTATION                                          Page 4
  241. ───────────────────────────────────────────────────────────────────────────────
  242.  
  243. 3 INSTALATION
  244.  
  245.         For the program to funktion optimally, it is necessary to set an
  246. environment variableto the directory where you have located the EXE file!
  247. In your autoexec.bat append the following line:
  248.  
  249.         SET VIEWER=d:\path to VIEWER.EXE
  250.  
  251.         example:
  252.  
  253.         SET VIEWER=D:\RA\VIEWER
  254.  
  255.         it is NOT necessary to use a trailing backslash '\'.
  256.  
  257. This results in the program will put log files to this directory, and search
  258. this directory for key files.
  259.  
  260. 3.1 SETUP UNDER USING DORINFO1.DEF (RA, SBBS)
  261.  
  262.         It is quite easy to set up the viewer under BBS's which leave a file
  263. called DORINFO1.DEF.
  264.  
  265.         Go into the RA menu configuration, and set up a new option as a
  266. type 7 menu (Call Sub-Program). With the following parameters:
  267.  
  268. VIEWER.EXE file d:\path\filname
  269.            ^^^^very important command!
  270.  
  271. where   VIEWER.EXE       is the viewer Executeable file.
  272.         file             is a parameter to tell VIEWER to use DORINFO1.DEF
  273.         d:\path\filename is the ANSI/ASCII file to view.
  274.  
  275.  
  276.  
  277. 3.2 SETUP UNDER OTHER BBS
  278.  
  279.         Here you must consider which parameters you need. See next chapter for
  280. description of what each command does, and legal values
  281.  
  282. VIEWER.EXE /C:com /B:baud /T:timeleft /N:username /S:security d:\path\filename
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300. IBBS FILE-VIEWER DOCUMENTATION                                          Page 5
  301. ───────────────────────────────────────────────────────────────────────────────
  302.  
  303. 4  PARAMETERS
  304.  
  305.         Valid parameters for the program are:
  306.  
  307.  
  308.     Parameter   Description                                     Values
  309.  
  310.         /C      ComPort where modem is located                  1..4
  311.  
  312.         /B      Baud Rate                                       38400, 19200,
  313.                         Where 0 indicates that operations       9600, 4800,
  314.                         are local                               2400, 1200,
  315.                                                                 600, 300, 0
  316.  
  317.         /T      Time Left                                       1..32000
  318.                         Where values <=5 result in the
  319.                         programs direct return to the BBS,
  320.                         as the minimum time left permited is
  321.                         5 minutes
  322.  
  323.         /N      Name                                            27 chars
  324.                         Name must be joined by an underscore
  325.                         eg. KRISTINN_TOMASSON, as the surname
  326.                         would otherwise be considered as a new
  327.                         parameter. (Sorry...)
  328.  
  329.         /S      Security
  330.                         This value is only used in the Status
  331.                         at the bottom of the screen, and has no
  332.                         other effects
  333.  
  334.         file    Utilise DORINFO1.DEF
  335.                         (other variations: FILE, File) This
  336.                         parameter tells the program to use file
  337.                         DORINFO1.DEF in the BBS directory.
  338.                         NOTE: if you use this command there should
  339.                               not be passed any other commands to
  340.                               the program as this will result in an
  341.                               error.
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350. IBBS FILE-VIEWER DOCUMENTATION                                          Page 6
  351. ───────────────────────────────────────────────────────────────────────────────
  352.  
  353. 4.1  EXAMPLES OF USE
  354.  
  355.         1. VIEWER.EXE FILE NEWS.ANS
  356.  
  357.                 This will display NEWS.ANS using the parameters from
  358.                 DORINFO.DEF
  359.                 
  360.         2. VIEWER.EXE /B:0 /T:12 MENU.ANS
  361.  
  362.                 This wil display the file MENU.ANS locally
  363.                 (it is important to pass a TimeLeft value greater than 5, as
  364.                  the program will otherwise return immediately              )
  365.  
  366.         3. VIEWER.EXE /C:2 /B:19200 /T:130 TEST.ANS
  367.  
  368.                 This will display the file TEST.ANS locally aswell as through
  369.                 COM port 2, at 19200 baud, with a max time of 130 mins.
  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. IBBS FILE-VIEWER DOCUMENTATION                                          Page 7
  401. ───────────────────────────────────────────────────────────────────────────────
  402.  
  403. 7 HISTORY
  404.  
  405.         Program History.
  406.  
  407. v1.00   - This is the first release of the program, and marks a new era for
  408.           ISoft, where all minor BBS utilities are now sold under ONE
  409.           registration. There were naturally a couple of bugs here and there
  410.           example: the program couldn't go above 19200 baud, hehe a VERY stupid
  411.           mistake, which I won't mention here!
  412.  
  413. v1.01   - I fixed the Baudrate BUG, and now time to add a tough registration
  414.           routine (Well at least I hope it's tough, I wouldn't know). I also
  415.           fixed a few bugs reported by my testers, so I decided to increment
  416.           the next version to number v1.02
  417.  
  418. v1.02   - This version, is the one you are looking at, I added the environment
  419.           check, so the LOG file now goes to this Directory.
  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.