home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / COMUNICA / USERB14.ZIP / USERBAR.DOC < prev    next >
Encoding:
Text File  |  1996-09-17  |  10.3 KB  |  240 lines
  1.  
  2.  
  3.            ██   ██ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ██████▄ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  4.            ██   ██                         ██   ██                  █
  5.            ██   ██ ▄█████▄ ▄██████ ██████▄ ██▄▄▄█▀ ▄█████▄ ██████▄  █
  6.            ██   ██ ██▄▄▄▄  ██▄▄▄▄  ██   ██ ██▀▀▀██ ██▄▄▄██ ██   ██  █
  7.            ██   ██  ▀▀▀▀██ ██▀▀▀▀  ██████  ██   ██ ██▀▀▀██ ██████   █
  8.            ▀█████▀ ▀█████▀ ▀██████ ██  ▀██ ██████▀ ██   ██ ██  ▀██  █
  9.                                                                     █
  10.           ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  11.  
  12.  
  13.                         ProBoard 2.15 PEX Version 1.4
  14.                          FreeWare by Olivier Debonne
  15.                     Documentation enhanced by Garrick Darts
  16.  
  17.                      Copyright (C) 1996 by Olivier Debonne
  18.                        Free Corner BBS, +32-56-XX.XX.XX
  19.                                (not online yet!)
  20.  
  21. ╔══════════════════════════════════════════════════════════════════════════╗
  22. ║ ▒▒ Introduction ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  23. ╚══════════════════════════════════════════════════════════════════════════╝
  24.  
  25.  UserBar is a PEX for ProBoard 2.15 that will show the user a tiny graphical
  26.  bar with the amount of Time/Kb he/she has left. It is totally user
  27.  configurable, including the characters and all colors used.
  28.  
  29.  UserBar is configured by an .INI file. New in this version is that you can
  30.  have multiple .INI files; one for every menu. This means total flexibility!
  31.  
  32.  UserBar needs ANSi to run smoothly. If you have users who use ASCii,
  33.  don't panic! The program will recognize their terminal setting and they
  34.  won't see a thing.
  35.  
  36.  UserBar is, like all my other ProBoard utilities, FREEWARE.
  37.  
  38.  I'd like to encourage more programmers to write FreeWare instead of
  39.  ShareWare, because there are a lot of programmers (I won't name names)
  40.  who spend more time on their registration key system than the actual
  41.  program...
  42.  
  43. ╔══════════════════════════════════════════════════════════════════════════╗
  44. ║ ▒▒ Disclaimer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  45. ╚══════════════════════════════════════════════════════════════════════════╝
  46.  
  47.  This software and its documentation is copyrighted material of Olivier
  48.  Debonne.
  49.  
  50.  I reserve the right to quit giving support or releasing updates for the
  51.  software at any time.
  52.  
  53.  The software and other material included in the distribution archive are
  54.  provided "AS IS" without warranty of any kind. We do not guarantee the
  55.  correct functioning and/or reliability of the software. The author will
  56.  not be liable for any direct or indirect damage resulting from the use
  57.  of the software.
  58.  
  59.  You may not reverse-engineer this software in any way and you may certainly
  60.  not add, change or delete any files in the distribution archive !
  61.  
  62.  You are free to distribute the original, unmodified UserBar archive
  63.  provided no fee is charged for its distribution. This excludes charges
  64.  for online time on electronic bulletin boards or other communication
  65.  services.
  66.  
  67. ╔══════════════════════════════════════════════════════════════════════════╗
  68. ║ ▒▒ Changes ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  69. ╚══════════════════════════════════════════════════════════════════════════╝
  70.  
  71.  - Version 1.4
  72.  
  73.     ■ Bugfix: When the Time/Kb-amount is equal to or less than zero, the
  74.       bar is displayed empty. (Thanks to Gilles Hemberg)
  75.  
  76.  - Version 1.3
  77.  
  78.     ■ Bugfix: In the PEX and its documentation was stated that your
  79.       configuration file could have any extension. This is false, your
  80.       file needs to have to extension .INI!
  81.     ■ Added program header when displaying error messages.
  82.     ■ "Better" English documentation included. (Thanks to Garrick Darts)
  83.     ■ More distribution sites and Internet Web-Site :)
  84.  
  85.  - Version 1.2
  86.  
  87.     ■ Boolean variables added to control Time/Kb Bar
  88.     ■ Multiple configuration files
  89.     ■ Compiled with ProBoard SDK 2.15
  90.     ■ Some optimalisation!
  91.  
  92.  - Version 1.1
  93.  
  94.     ■ Bugfix: When Time/Kb Limit is set to 0, for New Users, eg. UserBar gave
  95.       a nice Divide Error and returns to the DOS Prompt. This is now FIXED !
  96.  
  97.  - Version 1.0
  98.  
  99.     ■ This is the first public release.
  100.     ■ Almost everything user definable through an .INI file.
  101.     ■ Amount in Percent (%) or in minutes/Kb left on the screen?
  102.  
  103. ╔══════════════════════════════════════════════════════════════════════════╗
  104. ║ ▒▒ UserBar in the Future ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  105. ╚══════════════════════════════════════════════════════════════════════════╝
  106.  
  107.  ■ Faster, 486/Pentium optimized version?
  108.  ■ ASCii terminal support?
  109.  
  110. ╔══════════════════════════════════════════════════════════════════════════╗
  111. ║ ▒▒ Installation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  112. ╚══════════════════════════════════════════════════════════════════════════╝
  113.  
  114.  Copy the PEX file (USERBAR.PEX) to the PEX directory. Copy the sample
  115.  configuration file USERBAR.INI to any directory.
  116.  
  117.  Make, in a menu, an entry to run UserBar. If you have an automated entry
  118.  to show your menu ANSi file, add another automated entry right after it.
  119.  Use a #60 -  Run SDK File with USERBAR in the data line. Add after that
  120.  a parameter which names the configuration file, so that you have the
  121.  following syntax:
  122.  
  123.  USERBAR <Path and Filename of a configuration file>
  124.  
  125.  eg. USERBAR C:\PB\USERBAR\MAIN.INI
  126.  
  127.  Modify the configuration file to your needs. There's no need for a
  128.  description of it in this file; the .INI file is well commented.
  129.  
  130.  As you can see, you can have several configuration files. Now, you can
  131.  make one for every menu on your BBS! Just make sure that the extension
  132.  of your configuration file is .INI! If not, the PEX would work because
  133.  ProBoard needs .INI for its function GetIniVar(). By now, this PEX is
  134.  completely configurable.
  135.  
  136.  For compatibility reasons, there's backwards support with my older
  137.  versions. If you just enter 'USERBAR' on the data line, then the program
  138.  will search for USERBAR.INI in the ProBoard System Directory.
  139.  
  140. ╔══════════════════════════════════════════════════════════════════════════╗
  141. ║ ▒▒ Credits ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  142. ╚══════════════════════════════════════════════════════════════════════════╝
  143.  
  144.  This program was made by Olivier Debonne. I used Borland C++ 2.0 for DOS
  145.  to edit and compile the source. The source contains about 220 lines, which
  146.  totals 5.5 KB of code, including all commentary.
  147.  
  148.  This document (USERBAR.DOC) file was edited with the Editor (EDIT.COM)
  149.  supplied with Windows 95. Thanks to Garrick Darts for rewriting this
  150.  documentation in correct English!
  151.  
  152.  The following names/products mentioned in this document are copyrighted
  153.  material, trademarks or registered trademarks.
  154.  
  155.  Borland C++                   Borland International, Inc.
  156.  Fidonet                       Tom Jennings.
  157.  ProBoard                      Philippe Leybaert
  158.  Windows 95, MS-Editor         Microsoft, Inc.
  159.  
  160.  My home address is : Olivier Debonne
  161.                       Kozakstraat 201
  162.                       B-8560 Wevelgem
  163.                       Belgium
  164.  
  165.  I monitor both PROBOARD and PROBOARD.029 Fidonet echoes. My Fidonet address
  166.  is 2:291/1501.61. Leave a NetMail if you have a specific question!
  167.  
  168.  My Internet E-Mail address : odebonne@texas.knooppunt.be
  169.  
  170.  If you are able to "Surf" the World-Wide-Web, be sure to take a look at the
  171.  Virtual Soft Production Web-Site. All the latest PEXes can be found over
  172.  there. The URL is http://www.dma.be/p/bewoner/odebonne/v_soft.htm !
  173.  My files will also be available to FTP in the near future.
  174.  
  175. ╔══════════════════════════════════════════════════════════════════════════╗
  176. ║ ▒▒ Greetings ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  177. ╚══════════════════════════════════════════════════════════════════════════╝
  178.  
  179.  Greetings go to (in order of appearence) :
  180.  
  181.   Ruben Provoost, Stefaan Ovaere, Garrick Darts, Jurre Van Dijken, Tom Van
  182.   Overbeke, Steven Leeman, Gilles Hemberg, Tom Torfs, Jonathan Cloots, Jeroen
  183.   Jacobs, Pieter Dom, Wim Jans, Eric Delaet, Ronny Minjou, Chuck King,
  184.   Branislav Slantchev, all points at Texas Van Vlaanderen, all readers of
  185.   the PROBOARD.029 and PROBOARD echo, all students at the P.I.H. in Kortrijk,
  186.   everybody who ever wrote a mail to me and all the FreeWare authors. Keep
  187.   up the good work! And I forget to mention all the ones I forgot <g> ;-)
  188.  
  189.   Special thanks to Phillipe Leybaert for developing ProBoard!
  190.  
  191. ╔══════════════════════════════════════════════════════════════════════════╗
  192. ║ ▒▒ Distribution Sites ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  193. ╚══════════════════════════════════════════════════════════════════════════╝
  194.  
  195.  - USS Aurora - Belgium/Europe distribution site
  196.  
  197.       Sysop   : Ruben Provoost [JMJ] (Ruben.Provoost@student.kuleuven.ac.be)
  198.       BBS #   : +32-16-490588 (V.34)
  199.       Fidonet : 2:292/628
  200.  
  201.  - Orbit - The Netherlands distribution site
  202.         
  203.       Sysop   : Jurre Van Dijken (jvdijken@pi.net)
  204.       BBS #   : +31-592-51561 (V.34)
  205.       Fidonet : 2:282/223
  206.  
  207.  - The Slice of Lime BBS - UK/Eire distribution site
  208.  
  209.       Sysop   : Garrick Darts (garrick@wortz.demon.co.uk)
  210.       BBS #   : +44-121-6226601 (V.34)
  211.       Fidonet : 2:2500/623
  212.  
  213.  - Pacific Coast Micro - USA distribution site
  214.  
  215.       Sysop   : Mike Ehlert (mike@pcmicro.com)
  216.       BBS #   : +1-805-494-8327 (V.34)
  217.       Fidonet : 1:102/1001
  218.       FTP-Site: ftp://pcmicro.com/proboard_pex/
  219.  
  220.  - X-Technologies - Canada distribution site
  221.  
  222.       Sysop   : Doug Crone (decrone@saskmaple.net)
  223.       BBS #   : +1-306-545-5941 (V.34)
  224.       Fidonet : 1:140/46
  225.  
  226.  - Graph BBS - Argentina distribution site
  227.  
  228.       Sysop   : Mariano Defelipe (mardef@graph.turdera.com)
  229.       BBS #   : +54-1-551-2417 (V.34)
  230.       Fidonet : 4:900/758
  231.  
  232.  - I'm searching for distribution sites in other countries/districts. Please
  233.    write a message to me if you want to be my distribution site. All you need
  234.    is a 24/24h BBS with Fidonet and/or TGPBN support and an E-Mail account!
  235.    Other ProBoard alike nets are recommended, but not necessary.
  236.  
  237.       ───────────────═════════════════════════════════────────────────
  238.                  E  N  D    O  F    D  O  C  U  M  E  N  T
  239.       ───────────────═════════════════════════════════────────────────
  240.