home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / lcvt_11s.zip / LCVT.DOC < prev    next >
Text File  |  1995-09-29  |  6KB  |  199 lines
  1. (*
  2. ** LCVT/DOS and OS/2 version 1.1 Tosh Maddox (c) 1995
  3. **
  4. ** Released: 9/29/1995 version 1.10
  5. **
  6. *)
  7.  
  8. DISCLAIMER:
  9. ~~~~~~~~~~~
  10.     LCVT/DOS and OS/2 is provided *AS IS* without any warranty,
  11.     expressed or implied.  All Rights are reserved.  The author will
  12.     assume no liability for damages either from the direct use of this
  13.     product or as a consequence of the use of this product.
  14.  
  15.  
  16. COPYRIGHT
  17. ~~~~~~~~~
  18.     This  program is provided at no cost to you.  However, it is  NOT
  19.     public  domain;  it  is  copyrighted  by  the  author.   You  may
  20.     distribute  this  program  freely, so long as all  files  in  the
  21.     distribution  archive  remain  intact,  without  any  changes  or
  22.     modifications.   The  distribution  archive  is  in  ZIP  format;
  23.     however, you may convert the archive to any format you choose, so
  24.     long as the above requirements are met.
  25.  
  26. REGISTRATION
  27. ~~~~~~~~~~~~
  28.    There are *none*.  However if you use it, sending me a message just
  29.    to let know if it stinks or works for you would appreciated.
  30.  
  31.  
  32. FILES LIST:   (Depending on what archive you downloaded)
  33. ~~~~~~~~~~~
  34. LCVT.EXE      Main executable
  35. LCVT.DOC      This file you are reading now (hopefully)
  36. FILE_ID.DIZ   BBS file description
  37. LCVT1.CFG     Sample configuration file.
  38.  
  39.  
  40. WHAT DOES IT DO?
  41. ~~~~~~~~~~~~~~~~
  42.    Creates MSGINF which most external editors use to display
  43.    the To: From:  and Subj: in the following file format.
  44.  
  45. FORMAT:
  46. ~~~~~~~
  47. FROM
  48. TO
  49. SUBJECT
  50. MESSAGENUMBER
  51. MESSAGEAREA
  52. PRIVATE = YES/NO
  53.  
  54. this utility will read lorainfo.t0? and from the information contain in
  55. there, it will write MSGINF in the above format.  Which is the most common.
  56.  
  57. This will allow you and your users to use those external editors and see the
  58. FROM, SUBJ fields.
  59.  
  60. LCVT will *NOT* write to LORAINFO.T0x.  ReadONLY.  MSGINF is NOT read back
  61. by LORA by the way.
  62.  
  63.  
  64. GETTING STARTED
  65. ~~~~~~~~~~~~~~~
  66.  
  67. ** DOS version requires SHARE.EXE or VSHARE **
  68.  
  69.  
  70. 1.  You MUST SET LCVT=Drive\Path
  71.     This is where LCVT looks for it's configuration files.
  72.     LCVT?.CFG where '?' is the task/node.
  73.  
  74.     You can simply have it as SET LCVT=D:\LORA
  75.     LCVT will then look in D:\LORA for LCVT?.CFGs
  76.  
  77. 2.  Edit your LCVT?.CFG files.  Samples are included for you do edit.
  78.     You can have up to eight (8) config files.
  79.  
  80.     LCVT1.CFG <---- at least one is required as a minimum for a single node.
  81.     LCVT2.CFG and so on.
  82.  
  83.  
  84.     ------ LCVT1.CFG -------- Node 1
  85.     d:\lora
  86.                               PLEASE SEE SAMPLE provided for more
  87.                               details
  88.     --------------------------
  89.  
  90.     Case does not matter and trailing slash is not required.
  91.  
  92.     Line1 shows d:\lora as the directory that L2MSG should look for
  93.     LORAINFO.T0? and to writeln MSGINF
  94.  
  95.     In a single line system this is ok.  In multi line, you should have it
  96.     point to each of your specific node directories.
  97.  
  98.     Otherwise MSGINF will be overwriten by another nodes execution of
  99.     LCVT.  However, it has been tested under that condition and only time
  100.     it will get weird results, if 2 or more nodes execute their fullscreen
  101.     editor at the **EXACT SAME** time.
  102.  
  103.     Though this will have no reflect on ACTUAL messages save to Lora.
  104.     Since Lora does not read MSGINF, once returning from the editor,
  105.     All the information are taken from Lorainfo.t0?
  106.  
  107.     The MSGINF file mainly for external editors to allow users to
  108.     see FROM TO SUB fields.  *MOST* BBSs do not read back MSGINF to
  109.     the BBS.
  110.  
  111.  
  112.     ** Example using TOPED **
  113. 3.  In LSETUP, in General Options, I have in external editor as
  114.     the following.  The * parameter *MUST* be in that *ORDER*
  115.     *No Less*
  116.  
  117.     TOP.CMD *N *P *B *G *T
  118.              ^  ^  ^  ^  ^
  119.              │  │  │  │  │
  120.              │  │  │  │  └─────── Users Time Remaining (Used for DORINFO)
  121.              │  │  │  └────────── Users Graphics mode  (Used for DORINFO)
  122.              │  │  └───────────── Users BAUD           (Used for DORINFO)
  123.              │  └──────────────── SYSTEM PORT          (Used for DORINFO)
  124.              └─────────────────── SYSTEM TASK #        (Used for BOTH)
  125.  
  126. ** THOSE FIVE (5) paramaters must be used in order for LCVT to work
  127.    correctly.  They are needed to help in creating DORINFO.
  128.    In that *ORDER* exactly.
  129.                               *N *P *B *G *T
  130.                               %1 %2 %3 %4 %5
  131.  
  132. ** You can still use L2WORLD or DORINFO.BBS it you like.  Just invoke those
  133.    *AFTER* the execution of LCVT *BUT* you still need at least *N as
  134.    the *first* parameter.
  135.  
  136.     Where *N is the task parameter pasted from Lora.  That task number is also
  137.     read by LCVT to read the appropriate LORAINFO.T0? file.
  138.  
  139.     the below is what is contained in top.cmd (I'm using TopED)
  140.  
  141.     --- top.cmd ---  TopED Sample
  142.     LCVT %1 %2 %3 %4 %5
  143.     e:\ed\toped.exe %1
  144.     -----------------
  145.  
  146.     --- ice.cmd --- IceEdit Sample
  147.     LCVT %1 %2 %3 %4 %5
  148.     e:\ice\iceedit.exe /N:%1 /D:F:\LORA
  149.     -----------------------------------
  150.  
  151.     If you log on with LORA -l -n1 and execute your fullscreen editor
  152.     Lora will pass *N as '1' and passed on to LCVT to read LORAINFO.T01
  153.     locating it in the directory in LCVT1.CFG and then finally, writing
  154.     MSGINF and DORINFO1.DEF to the directory specified in LCVT1.CFG.
  155.  
  156.     That's all there is too it.  Hope you like it.
  157.  
  158.  
  159. Technical Info:
  160. ~~~~~~~~~~~~~~~
  161. For those of you currious.
  162.  
  163. LCVT/DOS was compile using Turbo Pascal 7.0 RTL 1.2
  164. LCVT/OS2 was compile using Borland Pascal 7.0/OS2 c't patched.
  165.  
  166.  
  167.                            Acknowledgements
  168.                            ~~~~~~~~~~~~~~~~
  169.  
  170. TRADEMARKS
  171. ~~~~~~~~~~
  172.   The  following are trademarks of and/or the copyrighted works  of
  173.   the following persons/companies:
  174.  
  175. LoraBBS is a trademark of Marco Maccaferri
  176. Norbert Juffa's Pascal (RTL) Run Time Library update 1.2
  177. Turbo Pascal/Pascal is a trademark of Borland International Inc.
  178. PKZIP/UNZIP is a trademark of PKWare Inc.
  179. OS/2 is a trademark of IBM International.
  180. IceEdit is a trademark of IceTechnologies.
  181. TopED is a trademark of TopSoft.
  182.  
  183. Trademarks of other companies mentioned are registered to thier respective
  184. companies.
  185.  
  186. I may be reached via the SHAREWARE_SUPPORT echo on Fidonet
  187. or LORA echo.
  188.  
  189. or
  190.  
  191. Tosh Maddox 1:102/1319.2 (route via my bossnode)
  192.  
  193. or
  194.  
  195. tosh.maddox@miles.tbie.hms.com
  196.  
  197. Lots of 'ors'
  198. (* End LCVT doc *)
  199.