home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Magic 1995 #1 / CDM_5.ISO / shell / graph / ansi / ssansi.arj / SSANSI.DOC < prev    next >
Encoding:
Text File  |  1989-11-15  |  5.5 KB  |  118 lines
  1.                           Suburban Software
  2.                       Written by Chuck Valecek
  3.                              11/13/89
  4.                             Version 2.0
  5.  
  6.     Here is another feeble attempt by me to write docs for a program. I hate
  7. writting documentation even at work!
  8.  
  9. This door is an ANSI Viewer which allows users to view ansi screens created by 
  10. other users and sysops. The door is very simple to install and should not
  11. require any work by the sysop to keep it up and running.
  12.  
  13. The door supports categories of screens. This allows you to assign a category
  14. to your screens. You can have BBS screens, Holiday screens or just plain old
  15. ansi screens. The decession is up to you. To create categories assign the
  16. screens a unique file extension. Holiday screens can be ThankG.HOL bbs screens
  17. can be SUBSOFT.BBS or what ever you decide. You determine the extension and
  18. in the config file neter the extension, the location of the files and a
  19. description of the screens. It very simple!
  20.  
  21. Look at the example of a config file that I supplied. The door will support up
  22. to 25 categories and 500 screens per category. The number after the registration
  23. number is the number of categories. Followed by the description of the category,
  24. the path and then the file extension. There MUST be all three for each category
  25. you specified.
  26.  
  27. When the door is entered by the user it will display the categories that you
  28. have defined. From this list the program will select the file extension that you
  29. associated with the category and search the path you specified for the screens.
  30.  
  31. Example: If yoou had a category called BBS screens and specified the file
  32. extension of BBS and you said the BBS screens would be in d:\ansi the door would
  33. search the directory ANSI and display a list of ALL screens that had a file 
  34. extension of BBS. Once this list is compiled the program displays a menu of the
  35. screens for the user to select from. It will halt the display after 72 screens,
  36. if there where more than the user would be prompted to enter the screen numbers
  37. or press return to continue with the display of screens to choose from.
  38.  
  39. The user can enter more than one screen number if the number is seperated by a
  40. space or comma or any character. When the screen selected is displayed it will
  41. pause and pressing any key will either display the next screen or return the
  42. user to the menu. If the user entered Q to quit the display and you had more
  43. than one category specified than the user would be returned to the category menu
  44.  
  45. There is a filter option in the program also. This option will blank out the 
  46. screen that the user viewed so when the screen menu was diplayed the screens
  47. already viewed will not be shown but in its place will be a blank field.
  48.  
  49. The config file is the basic config file for ProKit type doors.
  50. INTERRUPT    
  51. Suburban Software
  52. Chuck
  53. Valecek
  54. 999999 <-----The registration Number
  55. X <----------The number of categories
  56. Ansi Screens <------ The description of the screens   -------------|
  57. c:\ans <-------- The path where the screens are located -----------|
  58. .ans   <------ The file extension to search for  ------------------|
  59.  
  60. The three lines above must be repeated X many times, one for every category
  61. specified
  62.  
  63. Thats it for the config file. To run the door a batch file must be present in
  64. the PCBoard directory.
  65.  
  66. cd \ansi
  67. ssansi ssansi.cnf C:\pcb
  68. cd \pcb
  69. board
  70.  
  71.  
  72. The file ssansi.hlp can be edited as you wish and the file ssansi.scr can be
  73. redone to your liking as long as you dont exceed 16 lines. I am no artist so
  74. be creative and mak you own screen. I just supplied a simple one.
  75.  
  76. Now what I did was create a ANSI conference. In this conference I created a
  77. directory of all the scrrens ANSI. In PCBoard I stated that all uploads would
  78. go into the directory ANSI. The Config file tells the door to look in the ANSI
  79. directory for the screens. Now users upload the appropiate screen into this
  80. conference with the appropiate file extension. Then the door searches the 
  81. directory for the sleceted extension and displays them to the user. So there
  82. isnt any extra work needed by the sysop. You may want to review some of the
  83. screens to make sure they are being displayed correctly. This way when a new
  84. screen is uploaded it can be viewed right away.
  85.  
  86.  
  87. This door is another in a series of doors from Suburban Software. Some of the
  88. Doors that I have written using ProKit routines are:
  89.  
  90. King of the Board - Trivia Game now supporting King & Queen
  91. Strike 9 
  92. SS01-14 - PCBoard bbs lister, using the BLT1 from Salt Air
  93. SS02-14 - Displays the Daily caller log
  94.  
  95. Doors requiring Doorpch 3.5
  96. SS04-14 - Text file viewer door that supports 500 text files
  97.  
  98. And MORE to come!!!
  99.  
  100. Thank you for reviweing this door. I support all my software through a support
  101. conference on my Board (Conference 7). All the latest release will be posted
  102. there plus any support that is needed. I do support my software. I have been
  103. known to call a sysop having problems installing my doors and step them
  104. through the installation even before the product is registered. Nothing like
  105. a HAPPY sysop!!
  106.  
  107. Chuck Valecek
  108. Suburban Software
  109. (708) 312-636-6694 1200/2400 (Public)
  110. (708) 312-636-6697 1200/2400/9600/19200 USR HST (Private & Visting sysops)
  111.  
  112. You must request access to this node if you are a visting sysop. I have been
  113. plagued by PHONEY sysops using this node so I was forced into requiring the
  114. sysops to request access. Sorry!
  115.  
  116. Please use the registration form if you plan on registrating the door.
  117. And PLEASE make the check out to ME not Suburban Software.
  118.