home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / main / BBS / FED_103B.ZIP / FEDIT.DOC next >
Encoding:
Text File  |  1991-03-08  |  10.8 KB  |  319 lines
  1. Quick instructions:
  2.  
  3. Editor name : FEdit
  4. Command line: Remote: Fedit %1 %2 %3 %4
  5.               Local : Fedit %1 %2 %3 %4 S
  6.  
  7. =================================================================
  8.  
  9.                             FEDIT 1.03a
  10.  
  11.                    Copyright 1990 by Rob Raper
  12.              a.k.a One Eyed Willy #1 @18852 WWIVlink
  13.  
  14.                            About FEDIT
  15.                            ~~~~~~~~~~~
  16.  
  17.      FEDIT is a full-screen editor written for use with the
  18. WWIV BBS Software version 4.x written by Wayne Bell.  It is very
  19. easy to install, and is simple to use as it works by the standard
  20. WWIV editing commands. 
  21.      
  22.      A while back, I decided to take a stock copy of WWIV 4.12 and
  23. very heavily modify it to be similar to Emulex/2 systems.  I modded
  24. away, but when I reached the message editor, I realized that the
  25. standard WWIV editor was not going to do, as Emulex has a very nice
  26. built in full screen editor.  Frantically looking for a good
  27. editor, I could come up with nothing that "fit" my system. 
  28. "FSED"'s commands were terrible (Ctrl-K S to save), and there was
  29. a lack of extended ASCII.  Zedit crashed my system too often and
  30. had ridiculous registration requirements (No color until
  31. registration... Gimme a break.).  So I decided to write my own.  I
  32. had first made it an external executable file, and a few people
  33. noticed it and requested it.  I gave them a copy, and the editor
  34. found its way to Amber, upon which I immediately got a mass of
  35. network E-mail with comments on it.  I had no idea it had even
  36. gotten out, but the response was incredible.  
  37.  
  38.                           Installation
  39.                           ~~~~~~~~~~~~
  40.  
  41.      To install the editor, copy it and the help screen into any
  42. directory you wish.  Then run INIT, and choose "Full Screen
  43. Editors", choose "Insert", and enter the following info:
  44.  
  45. Editor name: FEdit
  46.  
  47. Remote command line: \dirname\FEDIT %1 %2 %3 %4
  48.  
  49. Sysop command line : \dirname\FEDIT %1 %2 %3 %4 S      
  50.  
  51. There are also other options you may add to the end of these
  52. command lines.  All options must have a space before it:
  53.  
  54. S   SysOp Side local editing
  55.  
  56. I   Change inputting method.  Rather than go through DOS routes,
  57.     hooks itself directly to WWIV's keyboard getting routine.  This
  58.     has the side effect of disabling macros entirely, but may work
  59.     when the other inputting method fails.
  60.  
  61. E   Use an ASCII text divider rather than the extended ASCII bar. 
  62.     This is useful for primarily non-IBM based boards.
  63.   
  64. So, for example, if you wanted all options, the command line might
  65. look like this:
  66.  
  67. FEDIT %1 %2 %3 %4 S I E 
  68.  
  69. The S I E are not order sensitive, they can be in any order you
  70. like.
  71.  
  72.                              Macros
  73.                              ~~~~~~
  74.  
  75. Fedit v1.03 and above support macros without any kind of
  76. modification to the WWIV source.  However, if you are using the "I"
  77. option, macros, like older versions of Fedit, will refuse to work,
  78. even with a Ctrl-P before the macro.  To enable them,
  79. load EXTRN.C and remove the line that reads:
  80.  
  81. okskey=0;
  82.  
  83.                      /TI, /SN, /SY Abilities
  84.                      ~~~~~~~~~~~~~~~~~~~~~~~
  85.  
  86.      Fedit now supports use of the above commands in the editor. 
  87. WWIV, however, does not normally support these commands from an
  88. editor.  To enable these options, a file must be passed to Fedit
  89. and back to WWIV.  Fedit 1.03a and above support this.  To make it
  90. work however, a modification must be installed.  The modification
  91. is as follows:
  92.  
  93. Load MSGBASE.C
  94.  
  95. Search for:
  96.  
  97. "void inmsg("...
  98.  
  99. Just before the void, insert and modify lines to make it read:
  100.  
  101. =================================================================
  102.  
  103. typedef struct     /* Add */
  104. {                  /* Add */
  105.     char tlen,     /* Add */
  106.     ttl[81],       /* Add */
  107.     anon;          /* Add */
  108. } infstruct;       /* Add */
  109.  
  110. void inmsg(messagerec *m1, char *title, int *anony, in ...
  111. {
  112.   char s[LEN],s1[LEN],s2[LEN],ro[81],fnx[81],chx,*ss,* ...
  113.   int maxli,curli,done,save,savel,i,i1,i2,i3,i4,i5,f,s ...
  114.   messagerec m;
  115.   long ll,l1;
  116.   char *lin, *b;
  117.   int real_name=0;
  118.  
  119.   FILE *stream;          /* Add */
  120.   infstruct fedit_data;  /* Add */
  121.  
  122.   if ((fsed!=0) && (!okfsed()))
  123.  
  124.  
  125. =================================================================
  126.  
  127. Now, search for "Aborted", and make all lines near it read:
  128.  
  129. =================================================================
  130.  
  131.   pl("Aborted.");
  132.   m.stored_as=0xffffffff;
  133.   *m1=m;
  134.   if (!fsed)
  135.     farfree((void *)lin);
  136.   return;
  137. }
  138.  
  139. if (fsed) {                                         /* Add */
  140.  
  141.   fedit_data.tlen=60;                               /* Add */
  142.   strcpy(fedit_data.ttl,title);                     /* Add */
  143.   fedit_data.anon=0;                                /* Add */
  144.    
  145.   stream=fopen("FEDIT.INF","wb");                   /* Add */
  146.   fwrite(&fedit_data,sizeof(infstruct),1,stream);   /* Add */
  147.   fclose(stream);                                   /* Add */
  148. }                                                   /* Add */
  149.  
  150. =================================================================
  151.  
  152. That will make it write out the file.  Now, we must read in the
  153. "results" from Fedit.  Search for the string "Reading" and make
  154. lines around it read:
  155.  
  156. ================================================================
  157.  
  158.       if (save) {
  159.         pl("Reading in file...");
  160.       }
  161.       use_workspace=0;
  162.     }
  163.   }
  164.  
  165.   if (fsed) {                               /* Add from here */
  166.     stream=fopen("FEDIT.INF","rb");
  167.     fread(&fedit_data,sizeof(infstruct),1,stream);
  168.     fclose(stream);
  169.  
  170.     strcpy(title,fedit_data.ttl);
  171.     setanon=fedit_data.anon;
  172.     unlink("FEDIT.INF");
  173.   }                                       /* To here. */
  174.  
  175.  
  176. ================================================================
  177.  
  178. And that should do it.
  179.  
  180.  
  181.  
  182.                          Technical Stuff
  183.                          ~~~~~~~~~~~~~~~
  184.  
  185.      FEDIT requires a WWIV BBS system to operate.  WWIV must be
  186. running for FEDIT to operate properly, as it hooks itself up with
  187. some of WWIV's special I/O commands, as well as color codes.  I've
  188. tried to add checks for an "Existing" WWIV system, but they aren't
  189. 100% foolproof, if you try using FEDIT without WWIV's
  190. "supervision", you may be subject to lock-ups. 
  191.  
  192.      FEDIT has many advantages over a line editor, wich becomes
  193. plainly obvious when you go to do a "TEDIT".  You can easily edit
  194. files with the option in the editor.  But another useful feature
  195. I've implimented is FEDIT at the //DOS shell.  If you see a file
  196. you want to edit when in a DOS shell, you can execute FEDIT with
  197. the following syntax:
  198.  
  199. FEDIT filename.ext
  200.  
  201. FEDIT realizes it doesn't have all the parameters that are used for
  202. a normal WWIV-edit and takes on some "Defaults".  These defaults
  203. are:
  204.  
  205. Screen columns: 80   Maximum lines: 300   Screen lines: 24   
  206.  
  207. The full FEDIT command string is:
  208.  
  209. FEDIT Filename.ext CharsPerLine Columns LinesPerPage MaxLines [SIE]
  210.  
  211. If there are neither 1 nor 4 parameters, FEDIT will refuse to run. 
  212.  
  213. FEDIT will not accept a MaxLines of over 300.  This is a reasonable
  214. limit that will satisfy most memory conditions.  If you find the
  215. need for more lines than 300, but the limit is set just incase WWIV
  216. gives the editor some incredible value which could never be
  217. handled.
  218. Due to color handling, FEDIT does many calculations at "word-wrap"
  219. time.  For this reason, I do not suggest running FEDIT on anything
  220. slower than an 8mhz XT.  
  221.  
  222.                            Disclaimer
  223.                            ~~~~~~~~~~
  224.  
  225.      FEDIT has been used on many systems to this date and has not
  226. caused any major problems what-so-ever.  However, I will not be
  227. responsible for any problems indirectly or directly related to this
  228. editor.  Nor will I be responsible if a spaceship comes down and
  229. magnetizes all your floppies.
  230.  
  231.  
  232.                           Registration
  233.                           ~~~~~~~~~~~~
  234.  
  235.      Many hours of hard work went into Fedit.  If you like and use
  236. FEDIT, a $10 registration fee is requested.  Registration will get
  237. you a registration number and registration instructions which will
  238. remove the minor unregistered notices which appear when you first
  239. load Fedit.  It will personalize your executable file to your name
  240. and BBS only.  To get this registration number to you, you must do
  241. one of two things:
  242.  
  243. 1)  Have a WWIVNet or WWIVLink address taht I can email you the
  244. registration number for your board information.
  245.  
  246. 2)  Send a self addressed stamped envelope with your registration
  247. so I can send you the registration number.
  248.  
  249. Send check and registration form to:
  250.  
  251. Rob Raper
  252. 11042 Hillhaven Ave
  253. Tujunga, CA 91042
  254.  
  255. If you have any questions or comments, you may get in contact with
  256. me either at 1@18852 WWIVlink, or on my BBS "The Treasure Chest" at
  257. (818)-352-8959.  
  258.  
  259. Source code for this version of FEdit will NOT be available unless the
  260. user is registered and needs it FOR A GOOD REASON.
  261.  
  262.                         Revision History
  263.                         ~~~~~~~~~~~~~~~~
  264.  
  265. 1.00b   The one that got out.  Was 90% functional.
  266.  
  267. 1.01    The first real release, DEL, Home, and End keys added.    
  268.         Added /LI function due to user attempts.  Fixed some      
  269.         small bugs concerning Ctrl-Y and screen updates.
  270.  
  271. 1.02    Added sysop side scrolling. Fixed bugs
  272.  
  273. 1.03    Informal release of Fedit.
  274.  
  275. 1.03a   Added line joining ability, and /SY,/SN, and /TI
  276.         abilities. Fixed homing bug, and colors now represent
  277.         what they should when they are changed.  Due to the amount
  278.         of people who flat out forgot to register, I've included
  279.         a "reminder" routine. Fixed CHARACTER DROPPING problem.
  280.  
  281. 1.03b   Arrghh, fixed /CLR and /C: conflict bug, /C: now works
  282.         instead of clears screen.
  283.  
  284.  
  285. ================================================================= 
  286.                       (Registration Form)
  287.  
  288.  
  289. User Alias/Handle     ________________________________
  290.  
  291. Full Real Name        ________________________________
  292.  
  293. Phone Number          ( ___ ) ___ - ____ 
  294.  
  295. Address               ________________________________
  296.  
  297.                       ________________________________
  298.  
  299. BBS Name              ________________________________
  300.  
  301. Computer Type         ________________________________         
  302.  
  303. Birth Date            ___ / ___ / ___
  304.  
  305. Password (In case you might ever log onto The Treasure Chest).
  306.  
  307.                       ________________________________
  308.  
  309.  
  310. Network Node:         _________  [ ] WWIVlink  [ ] WWIVNet
  311.                                  [ ] I do not belong to either.
  312.                                      I have, however, included
  313.                                      A self addressed stamped 
  314.                                      envelope.
  315.  
  316. This info is needed as I create a user account for each registered
  317. user to keep tabs on who's registered. 
  318.  
  319.