home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 14 Text / 14-Text.zip / fileid03.zip / README.DOC < prev   
Text File  |  1998-01-31  |  14KB  |  259 lines
  1.  
  2.                     Short Lesson on using the FILE_ID.DIZ
  3.                     ─────────────────────────────────────
  4.                           Revision 0.03 - Jan.31.98
  5.  
  6. To whom does this concern?
  7. ──────────────────────────
  8.     This information is being written to inform all those programers who are
  9. writing shareware with the belief that a FILE_ID.DIZ is actually a README.DOC
  10. or a README.TXT guide to their software. If you intend on using BBSs (Bulletin
  11. Board Systems) to distribute your shareware software the FILE_ID.DIZ is a
  12. method in which this small file is imported into the BBS file base for users
  13. to view the short description of the software while they are online. Should
  14. this software interest them, they would download the file and extract the
  15. archive at home and further read what else the programer/author has to say
  16. about their product. FILE_ID.DIZ is short form for "File Identification
  17. Description" just as README.1ST is short for "Read Me First", and the list
  18. goes on, this text will try to describe in short each of these later on. Over
  19. the past few years and increasingly worse, the FILE_ID.DIZ is being used lately
  20. as a History Document, a Short Story Book, an Install help File, a "What's New
  21. History Document", and in many cases it is actually more informative than the
  22. actual program/software "Installation Document" and over all "Program Help
  23. Documents". Contained in this text file is basically some guidelines for
  24. certain files and their meanings.
  25.  
  26.     It is interesting to note now that many of these files can and are also
  27. used with names using an extension ".TXT" which is short for Text.
  28.  
  29. FILE_ID.DIZ  - File Identification Description - Short and to the point!
  30. FILES.BBS    - A text file containing a list of Files on a Bulletin Board
  31.                System and the Files with descriptions.
  32. HISTORY.DOC  - History of the version releases. Removed from the previous
  33.                WHATSNEW.DOC and thrown in here for history record keeping.
  34. INSTALL.DOC  - Many times this is used as a reference on how to install the
  35.                product.
  36. README.1ST   - This is a file which contains much of "What to do first!"
  37.                information. Like how to deal with the install files etc..
  38. WHATSNEW.DOC - Usually this file contains updates since the last release.
  39.  
  40.         The above files names are not written in stone and are only used to
  41. help explain where to deal with excess bagage that should not be in the
  42. FILE_ID.DIZ.
  43.  
  44. Abbreviated Terms Used.
  45. ───────────────────────
  46. BBS(s)  - Bulletin Board System(s)
  47. SysOp   - System Operator
  48.  
  49. The Shareware Philosophy!
  50. ─────────────────────────
  51.           Shareware is a distribution/marketing method which permits
  52.           potential buyers to thoroughly evaluate a computer program
  53.           prior  to purchase.  Usually through an evaluation period.
  54.  
  55.           The  shareware  philosophy  is  to pay smaller amounts for
  56.           well-crafted and useful software from developers who can't
  57.           spend the millions of  dollars  on  marketing necessary to
  58.           compete with the large software development companies. You
  59.           benefit by being able to try a  wider  variety of software
  60.           products  to  find  the  ones  that  suit  your particular
  61.           purpose.  And the trial is free.  The  shareware developer
  62.           benefits from being able to distribute his work to a wider
  63.           audience than would be possible  through  normal channels.
  64.  
  65.           Your  share  of  the  responsibility  for  shareware is to
  66.           continue to support the development of  further and better
  67.           products, to distribute the  original  released  shareware
  68.           archived  programs  to  others  and to become a registered
  69.           user of those products you like and use.
  70.  
  71.  
  72. Who cares?
  73. ──────────
  74.         In order to make some sense into the FILE_ID.DIZ one has to realize
  75. that BBSs are still one of the leading distribution methods of Shareware. Even
  76. though many use the Internet to get these files the FILE_ID.DIZ is still used
  77. as the leading method to get the decription information across to the consumer.
  78. Many SysOps who have run BBSs for years are now using the Internet to display
  79. Shareware files online using that same BBS. Only now they are using the
  80. Internet to attract the customer/user base because the Internet allows access
  81. around the world using a very cost efficient medium.
  82.  
  83.         Building HTML text files from a FILES.BBS is simple. What is not so
  84. simple are those that deviate from the FILE_ID.DIZ standards and try to make a
  85. clean looking HTML to please readers. SysOps are still the number one reason
  86. why Shareware is being registered. Internet Service Providers are still telling
  87. everyone that they have FREE software. Technically yes, it is FREE to download
  88. and FREE access to their sites, but the Software 95% of the time is NOT FREE.
  89. It is Shareware! If it was truly FREE it will say FREEWARE in the FILE_ID.DIZ
  90. or someplace that is noticeable to the public. Just a side note here, FreeWare
  91. does not always mean it is in the public domain. Make sure you read the
  92. licensing agreement information!
  93.  
  94. FILE_ID.DIZ format!
  95. ───────────────────
  96.     The standard FILE_ID.DIZ format was developed years ago (By CDC makers of
  97. PCBoard) and was used as a method to utilize the FILES.BBS even further. The
  98. FILES.BBS is used to hold the information extracted from the FILE_ID.DIZ and
  99. is then in turn used for the user to view and download the files (Software,
  100. etc.). The standard format for the FILE_ID.DIZ is set to 10 lines down by 45
  101. characters across. Many BBSs will extract this file and append the information
  102. into the FILES.BBS list. If you have a story to tell while you are creating
  103. your FILE_ID.DIZ the information will wrap the lines and crop the typed text
  104. until what the reader sees is a anything but the information you had originally
  105. planed your software product description.
  106.  
  107. in other words this paragraph would look like this:
  108.  
  109.     The standard FILE_ID.DIZ format was deve
  110. PCBoard) and was used as a method to utilize
  111. FILES.BBS is used to hold the information ex
  112. is then in turn used for the user to view an
  113. etc.). The standard format for the FILE_ID.D
  114. characters across. Many BBSs will extract th
  115. into the FILES.BBS list. If you have a story
  116. your FILE_ID.DIZ the information will wrap t
  117. until what the reader sees is a anything but
  118. planed your software product description.
  119.  
  120.     Or maybe like this:
  121.  
  122.     The standard FILE_ID.DIZ format was deve
  123. loped years ago (By CDC makers of PCBoard) a
  124. nd was used as a method to utilize the FILES
  125. .BBS even further. The FILES.BBS is used to
  126. hold the information extracted from the FILE
  127. _ID.DIZ and is then in turn used for the use
  128. r to view and download the files (Software,
  129. etc.). The standard format for the FILE_ID.D
  130. IZ is set to 10 lines down by 45 characters
  131. across. Many BBSs will extract this file and
  132.  
  133.     As you can see it is not that pretty, lacks luster and description.
  134.  
  135.     Bellow is a cut from a PCBoard DIR or FILES.BBS file that has imported the
  136. FILE_ID.DIZ from the original Shareware Archive. Just a note for those using
  137. Archive Formats: Many Archives are distributed in RAR, ZIP, LZH, ARJ and SFX
  138. (Self Extracting which can also be RAR, ZIP etc...). Almost all of these can
  139. be utilized on any BBS. So there is no worry about what Compressor you use
  140. with your software releases.
  141.  
  142. File Name    Size      Date     Description
  143. ============ ========  ======== ==========================================
  144. SE172A.EXE     291076  11-29-97  ─────────────────────────────────────────
  145.                                | │▌█▐│    SabreEDIT Version 1.72a    │▌█▐│
  146.                                | ─────────────────────────────────────────
  147.                                |  SabreTech Software's  full  screen  on- 
  148.                                |  line message editor, offering taglines, 
  149.                                |  censoring,  spellchecker, custom colors 
  150.                                |  & screens, user setups & sigs, quoting, 
  151.                                |  bad user handling, color setup, import, 
  152.                                |  export, OLMR support, language support, 
  153.                                |  quote fix, phrase expand, text filters, 
  154.                                |  & more!  Runs FAST! under OS/2 & Win95. 
  155.                                |  Works w/any MSGTMP type BBS, with extra 
  156.                                |  features available for Concord, EzyCom, 
  157.                                |  QuickBBS, RA, and RA v2.50.      [DH97] 
  158.                                | ─────────────────────────────────────────
  159.                                | 
  160. SEDIC103.EXE   227297  11-29-97  ─────────────────────────────────────────
  161.                                | │▌█▐│  SabreEDIT Dictionary v1.03a  │▌█▐│
  162.                                | ─────────────────────────────────────────
  163.                                |  SabreEDIT's 50,000+ word  spellchecker 
  164.                                |  dictionary file, for use with SabreEDIT 
  165.                                |  versions 1.72a  and up.  Also  includes 
  166.                                |  dictionary editor and sort util. [DH97] 
  167.                                | ─────────────────────────────────────────
  168.  
  169.     As you can see from the above, the format width of your FILE_ID.DIZ is more
  170. critical then the length or row of lines. HOWEVER, is you go past 25 lines many
  171. BBS software will crop anything past 10 lines and over! If one would deviate
  172. to far from the standard FILES_ID.DIZ format you run the risk of your file
  173. identification description looking sloppy and no one using a BBS looking for
  174. Shareware Software will bother ever reading it.
  175.  
  176.     Many SysOps just delete these file for noticing the lack of effort the
  177. software programer put into his research to utilizing the correct FILE_ID.DIZ
  178. format. Another and worse senario is software authors that do not even use the
  179. FILE_ID.DIZ. I know of no SysOp that will go out of their way after running
  180. their BBS for more than 3 months, go through that Software Archive and write
  181. the short Diz for you! "Why not?", I hear many yell. For one thing, to the
  182. majority of SysOps running a BBS, it is a hobby. They do not get paid for it
  183. and in actual fact it cost many SysOps thousands of dollars a year to run these
  184. BBSs. They use software to automate most of the work involved otherwise a
  185. SysOp could spend 8 hours a day at their hobby. :-( They will just delete it
  186. and not even blink while doing it! If these two later instances alone do get
  187. your gray matter motivated into utilizing the FILE_ID.DIZ for what it was
  188. originally intended for are a lost cause and at best will never see your
  189. Shareware Software used past your best friends. If your best friend is your
  190. dog... well, that takes us into another dimension. <g>
  191.  
  192. A note about CD-ROMS.
  193. ─────────────────────
  194.      Another method to distribute Shareware, also using a FILES.BBS with the
  195. FILE_ID.DIZ extracted from archives, are Shareware CDs. The FILES.BBS is used
  196. by BBS software all over the world and many of these BBSs have 10+ CDs online.
  197. Again, many of those who create these CDs do not bother formating the DIZ for
  198. the software because of many factors. Once on the CD you can not change things
  199. as easily and you run the risk of others never bothering to look at your
  200. software because of a poorly formated FILE_ID.DIZ.
  201.  
  202.         Another should be added here is that although many BBS do not use the
  203. FILES.BBS for their BBS software, the BBS software itself usually has utilities
  204. to take the information from the FILES.BBS and format it to it's own data type.
  205. Many times this is also not the case and the BBS utilities will directly access
  206. the files and search for a FILE_ID.DIZ internally then extract it from each
  207. archive.
  208.  
  209. Ending thoughts!
  210. ────────────────
  211.     Think of the FILE_ID.DIZ as a label. It does not go into detail about how
  212. each ingredient is produced, manufactured, grown etc., but rather what the
  213. finished product is about and take that selling point to the consumer.
  214.  
  215.         Points to Consider:
  216.                 a) Many times the looks and format of the FILE_ID.DIZ is why
  217.                    the file is downloaded in the first place.
  218.                 b) No one likes to visit when there is a mess. SysOps know
  219.                    this and will delete your files if they make their BBS
  220.                    look messy. Many SysOps take a great deal of pride in
  221.                    their BBS. (Of course many don't either.)
  222.                 c) Get your act together! If you can't say what you have to
  223.                    in 75 words or less then use the correct files. Those who
  224.                    want to read a novel will buy one. Even a Novel has less
  225.                    words on the cover than a properly formated FILE_ID.DIZ.
  226.  
  227. Questions and Answers!
  228. ──────────────────────
  229.     If you have any questions regarding any of the above, I will be more than
  230. happy to help answer them. You can contact me, Darrell Harder, at any of the
  231. addresses below:
  232.  
  233.                       BBS/Fax  - 604-535-1077
  234.                       FidoNet  - 1:153/9117
  235.                       E-Mail   - sabretech@sabretech.com
  236.                       Web      - http://www.sabretech.com
  237.  
  238.                     Copyright (c) 1998 SabreTech Software
  239.                              by Darrell Harder
  240.  
  241. Changes?
  242. ────────
  243.         You are free to change anything in this file and post it on your BBS or
  244. anywhere you think this information will help others to learn a bit about the
  245. FILE_ID.DIZ format. If you want to update it with more information please send
  246. me a copy. :-)
  247.  
  248. Guarantees?
  249. ───────────
  250.         HAHAHAHA! I guarantee you were not laughing as hard as I was while I
  251. was typing this up thinking you were really expecting one.
  252.  
  253. Sources:
  254. ────────
  255.         SabreEDIT - Copyright (c) 1997-1998 SabreTech Software
  256.         PCBoard   - Copyright (c) Clark Development Company
  257.         And many of the BBS softwares products that are too numerous to
  258.         mention here.
  259.