DCTEdit v0.04 Gamma By Dan Traczynski Released January 5, 1998. Copyright (C) 1997, 1998 Dan Traczynski. All rights reserved. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³ Table of Contents ³³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ¯ Contact Information ® ¯ Introduction ® ¯ Installation ® ¯ Command-Line Parameters ® ¯ Tagline Management ® ¯ Language Support ® ¯ Menu Editor ® ¯ SysOp Function Keys ® ¯ Global DCT Files ® ¯ SCRUTIL.EXE Explained ® ¯ Imbedded Codes ® ¯ Distribution & Disclaimer ® ¯ Author's Notes and Support Info ® ¯ History - Notes from the Past ® ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³ Contact Information ³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ E-mail dant@sfu.ca (best method of contacting the author) Netmail Dan Traczynski, 1:153/757 FidoNet EchoMail RA_UTIL WWW http://www.sfu.ca/~dant/ http://www.worldnet.net/~island/dct.htm FTP ftp://ftp.canbbs.net/pub/DCT_Productions/ Mailing List dctprod@madmanmark.ml.org To subscribe: Send a message to with only the text "subscribe dctprod" (sans quotes) in the message text. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³³³³ Introduction ³³³³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTEdit is a full-screen message editor which should run under any BBS that supports external editors. DCTEdit was designed to be more like a word processor than a remote text editor, and employs an easy to use pull-down menu interface. Offline mail readers are also supported. DCTEdit has been tested with and found to work under the following BBSs: RemoteAccess 2.xx Ezycom 1.20 ProBoard 2.15 Tornado 1.52g Telegard 3.02 This does not mean that DCTEdit will not work with other systems, it just means that I haven't personally had the opportunity to test it with any other systems. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³ Installation Guide ³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ To install DCTEdit on your BBS, simply follow the steps listed below. If you are upgrading from a previous version of DCTEdit, please refer to UPGRADE.DOC. 1. Unzip DCTEdit into its own directory. The directory C:\BBS\DOORS\DCTEDIT will be used throughout this text. 2. Run CONFIG.EXE and configure DCTEdit to your system. If you run RA 2.xx, Telegard 3.xx, ProBoard 2.1x, or Ezycom 1.20/newer, and CONFIG detects the BBS on your system, you will be prompted if you would like to do an auto-install. This means that CONFIG will extract any relevant information from your BBS setup and then automatically install itself as the external full-screen editor into the BBS for you. If you answer YES to this prompt, you can skip installation step 3. 3. Add DCTEdit to your BBS configuration. Each system is different, so a command-line that will work under every setup cannot be given. The best and recommended method of invoking DCTEdit would be "C:\BBS\DOORS\DCTEDIT\DCTEDIT.EXE /P /N". Batch files are not needed and DCTEdit does not have to be run in the current directory. DCTEdit will look for the drop file and the MSGTMP/MSGINF files in the path to the drop file. If your BBS uses a different file than MSGTMP, you may use the /F command-line parameter to instruct DCTEdit to load this different file. Please see the "Command-Line Parameters" section for a detailed list of parameters. 4. Add any inappropriate words you want filtered out to 'CONFIG.Editor.Filters'. No words have been pre-defined to filter out, so I leave it up to your imagination to pick the words. 5. DCTEdit should now be working on your system. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³ Command-Line Parameters ³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The switch for each command-line parameter can be either a hyphen or a slash. For example, "-L" will yield the same result as "/L". A colon may also be used between the parameter and the data following it, so "/N:1" is the equivalent of "-N1". /A Forbids the user from aborting the message. Useful for new user messages when you want to make sure the user posts you a message. /Bnnn Specifies the locked baud rate. This parameter overrides anything set in the configuration. ie. /B38400 - Sets the locked baud rate to 38400 baud. /Dxxx Loads an alternate screen definition instead of the one specified in 'CONFIG.System.Settings.Images File'. Any path or file extension given is stripped. ie. /DCUSTOM - Loads the screen definition file CUSTOM.EDS in the DCTEdit directory. /E Tells DCTEdit that it is loading a text file rather than a message for editing. DCTEdit will ignore the uppercase and quote limits and will also suppress adding a tagline or signature at the end. Please also refer to the note at the end of this section on this parameter. ie. DCTEDIT /E /FC:\BBS\*.BAT - Lets the SysOp (or anyone else with the access) edit any .BAT file in the C:\BBS directory remotely. /Fxxx Specifies an alternate file to load and save instead of MSGTMP. This is useful when using DCTEdit with an offline reader or a BBS which uses its own naming convention. ie. /FC:\BBS\MSGTMP.1 - Loads and saves C:\BBS\MSGTMP.1. /L Used for testing DCTEdit in local mode. /Nnn Passes the node number to DCTEdit. This parameter must be specified on multinode systems or conflicts may arise when two users enter the door and both windows of DCTEdit think they're on the same node. If this parameter is not specified (ie. on single node systems), node 1 is assumed. ie. /N2 - Tells DCTEdit the user is on node 2. /O Instructs DCTEdit that it is being run from an offline reader. This parameter is usually accompanied by the /F parameter. ie. DCTEDIT -O -F@F - Command-line used if running DCTEdit from Blue Wave. ie. DCTEDIT /O /PC:\TERMINAT - Command-line used if running DCTEdit from Terminate. The /P parameter indicates that the MSGINFO.SYS file is in the C:\TERMINAT directory. /Pxxx Specifies the path to the drop file and the MSGTMP/MSGINF files. ie. /PC:\BBS\NODE1 - DCTEdit will then look for the drop file in C:\BBS\NODE1. /R Loads the file read-only (useful for using DCTEdit as a text file viewer). Only allowed if used in conjunction with the /E parameter. /Snnn Passes the user's security level to DCTEdit. ie. /S1000 - Gives the user security level 1000 regardless of what the drop file says. /Tnnn Passes the user's time remaining to the door. This setting overrides anything in the drop file. ie. /T20 - Gives the user 20 minutes of time regardless of what the drop file says. /W A DOS only network is present. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ NOTE ABOUT /E PARAMETER! ³ ³ ³ ³ This is a very powerful and useful option that can also be very ³ ³ destructive if access is given to the wrong person. DCTEdit ³ ³ should only be executed with the /E parameter from the SysOp menu ³ ³ or some other place that only the SysOp can access. You ³ ³ essentially have the power to view and edit almost any file on ³ ³ the hard drive remotely with this feature. If the /E parameter ³ ³ is not specified, DCTEdit will never allow the user to select ³ ³ which file to edit. DCTEdit will only load ASCII text files (ie. ³ ³ batch files) and will not allow editing of any file which ³ ³ contains characters below ASCII 32 (which means ANSI files can't ³ ³ be loaded either). If there is even a remote chance that a user ³ ³ might be able to access this option, I strongly urge you to set ³ ³ the 'CONFIG.System.Settings.Edit Password' field so that a ³ ³ password must first be entered before allowing remote access to ³ ³ this option. The password is stored as a CRC-32 value and thus ³ ³ cannot easily be decrypted. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³ Tagline Management ³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTEdit implements its own internal tagline support, so there is no need for an external tagline door like DCTTag. Approximately 1400 taglines have been supplied with this program, but you may wish to add your own or edit the existing ones. To do so, simply edit the file DCTEDIT.TAG with any text editor (DOS' EDIT.EXE works very well). DCTEDIT.TAG is a plain ASCII file in the format of one tagline per line, and no compiling to a tagline database file is required. Taglines cannot be longer than 74 characters. If they are, only the first 74 characters will be used. No sorting utility has been provided as the SORT.EXE that is packaged with DOS is quite capable of performing this job. If you wish to sort the tagline file, a command-line similar to the following may be used: SORT.EXE DCTEDIT.TAG Imbedded codes, such as the name of the recipient, may also be used in the taglines. The following codes may be used: @BBS@ Name of BBS @D@ Current date (DD-Mmm-YY) @F@ Sender's full name @FF@ Sender's first name @FL@ Sender's last name @FN@ Recipient's first name @FROM@ Sender's full name @LN@ Recipient's last name @N@ Recipient's full name @TO@ Recipient's full name DCTEdit also has the capability of stealing taglines out of the quoted text of a message the user is replying to. To enable this option, set 'CONFIG.System.Taglines.Adopt Taglines' to YES. Taglines are saved to the binary data file NEWTAG.ED which you can view from the Acquired Tagline Manager. More on this manager is explained below. If 'CONFIG.System.Taglines.Log Additions' has been enabled, any custom taglines that users add to their messages will be logged to the binary data file NEWTAG.ED. You can then view this file and copy any taglines you like to DCTEDIT.TAG via the Acquired Tagline Manager. The Acquired Tagline Manager allows you to view taglines which DCTEdit has obtained and decide what to do with them. You can export each tagline to the DCTEDIT.TAG file, remove the "Add Tagline" access of the user who added the tagline, or simply delete it. The manager may be accessed from 'CONFIG.Editor.Taglines'. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³³ Language Support ³³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTEdit supports multiple language files so that each user can run DCTEdit in his or her own native language (provided that the language file exists). Language files can be edited from 'CONFIG.Editor.Languages', and the following imbedded codes may be used in the applicable strings. %U User's name. %S Board name. %1 A temporary string that varies with each language prompt. %% Displays a single per cent symbol. @1..9 Changes the colour to one selected in 'CONFIG.Colours': 1 Box 2 Lightbar 3 Highlight 4 Disabled 5 Message text 6 Quoted text 7 Title 8 Window text 9 Input Fields ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³³³³ Menu Editor ³³³³³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Don't want a certain option in the pull-down menu? Do you want "Abort" to come before "Save"? Or how about displaying the menus in a different language? This can all be configured through 'CONFIG.Editor.Menus'. You may configure up to 6 pull-down menus and 6 items per menu, for a total of 36 user options (DCTEdit currently has 14 menu options to play with). You will first be presented with a list of the 6 menus, from which you may choose one to edit. In the editing screen, simply select the item to change, then hit [Enter] to make the changes. The following text should help explain what each option means. TYPE Instructs DCTEdit as to what it should do when this option is selected. DISPLAY Text which is displayed to the user in the menu picklist. A caret (^) symbol is used to denote what the item's hotkey will be (ie. S^ave tells DCTEdit to use 'A' as the item's hotkey). If there are two items in the same menu with the same hotkey, only the first one will be honoured. SECURITY You wouldn't want your users to have the ability to import text files from anywhere on your hard drive into the message, so setting the SECURITY option tells DCTEdit to restrict access to certain people only. "SysOp" will restrict access to only those with security level greater than or equal to 'CONFIG.System.Site Info.SysOp Security' and "Local" forces DCTEdit to only make the option available when running in local mode. HOTKEY This item cannot be configured directly, rather it simply displays what you have selected as the hotkey in 'DISPLAY'. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³ SysOp Function Keys ³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTEdit allows you to define up to 9 function keys to run external programs. Some possible uses are editing files locally in DOS' edit, running an external SysOp-User chat door, running an external user editor, running a "who's online" program, etc. The F2 through F10 keys may be configured, F1 being the key that displays what the rest do in DCTEdit. The function keys may be configured through 'CONFIG.Editor.Fn Macros'. The following imbedded codes may be used in the command-line: *Axxx; Tells DCTEdit to change to the directory 'xxx' before shelling out. The trailing backslash is not required. Many programs require that you change to their directory first and creating a batch file to simply change directories before executing the program is a waste of space, thus the need for this parameter. ie. *AC:\RA; - Shells to DOS in the C:\RA directory. *B User's baud rate, 0 if logged in locally. *C Full path and name to COMMAND.COM or other operating system obtained via COMSPEC environment variable. *D Instructs DCTEdit to create a DORINFO1.DEF drop file in the DCTEdit directory. If used in conjunction with the *R option, you could execute an external door from within DCTEdit. *N The current node number, as specified by DCTEdit's /Nx command-line parameter. *P Communications port being used. *R Normally, DCTEdit does not redraw the screen remotely after the program has completed execution. If this shell will run a program which displays text remotely (ie. a door), specifying '*R' in the command-line will force DCTEdit to redraw the screen remotely upon returning. *S User's security level. *T Time remaining (in minutes). *Uxxx; If you wish to obtain user input before running the external program, you can use this code. The text 'xxx' will be displayed to the user, and whatever the user enters will be inserted into the command-line where the '*U' is placed. You can specify multiple *U user inputs in one command-line. *W Instructs DCTEdit to wait for a local keypress after the external program has terminated and DCTEdit has not yet redrawn the screen. Useful if doing a directory listing. ** Replaced by a single asterisk. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ USEFUL TIPS ³ ³ ³ ³ * If running an external door, be sure to add the *D and *R codes ³ ³ to the command-line. You can also add the *A code if the door ³ ³ requires you to change to its directory before running it (thus ³ ³ avoiding another batch file). ³ ³ ie. '*AC:\RA\DCTCALL;DCTCALL.EXE *D *R' would execute DCTCall ³ ³ after changing to the C:\RA\DCTCALL directory. ³ ³ (Technically, DCTCall doesn't need to be run from its own ³ ³ directory.) ³ ³ ³ ³ * A "*C /C" prefix is not required to run a batch file (it's ³ ³ handled internally), but it is required if you want to run an ³ ³ internal DOS command (ie. DIR). ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³³ Global DCT Files ³³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Any files with a .DCT extension can be copied to other DCT Productions which support them thus making setup just a little bit quicker. As of this release, the following files may be interchanged: FILTER.DCT Text to censor from user input. À> DCTEdit v0.03 À> DCT UserChat v0.02 XLAT.DCT Translation table. À> DCTEdit v0.03 À> DCT UserChat v0.02 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³ SCRUTIL.EXE Explained ³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ SCRUTIL.EXE is the program which will allow you to customise the way DCTEdit looks to the users. It is completely command-line driven, and will import or export ANSI images to/from the screen definition file. Command-Line Parameters ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ SCRUTIL [Def File] [/?] [/CREATE] [/ADD ] [/EXTRACT ] [/IMPORT [Ctl File]] [/EXPORT [Ctl File]] [/BORDER] [Def File] The definition file is the image file that SCRUtil will work with and what DCTEdit will load and use. If it is not specified, the default DCTEDIT.EDS will be used. [/?] Displays a brief help screen summarising the commands. [/CREATE] Creates a default definition file with no images in it. It is then up to you to add the images in. [/ADD ] This option will add an ANSI file into the definition file. The variable is the image number that the ANSI file will be added as. specifies the ANSI file to add. [/EXTRACT ] This option is the reverse of ADD. Instead of adding the ANSI, SCRUtil will extract it and save it as . [/IMPORT [Ctl File]] This option will allow you to import a group of images at once. In order to do this, you must first create a control file listing all of the file names and image numbers. The format is the same as with the ADD parameter. If [Ctl File] is not specified, the default SCRUTIL.CTL is used. The following is a sample control file: 0 CMDLIST.ANS 1 GENHELP.ANS 2 PROGINFO.ANS 3 TOPBORD.ANS 4 BOTBORD.ANS If this were the file, CMDLIST.ANS would be added as image 0, GENHELP.ANS as image 1, and so on. [/EXPORT [Ctl File]] This parameter is the reverse of the IMPORT parameter, and takes the same arguments as the IMPORT parameter. If the above sample control file were used, image 0 would be exported to HDR.ANS, image 1 would be exported to FTR.ANS, and so on. A sample SCRUTIL.CTL file has been included with this archive. [/BORDER] Allows you to edit what characters to use as border lines in the pull-down menus. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³ Imbedded Codes in the Screen Definition File ³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Each code follows a simple format, that being an @ sign followed by the code, then the data field, then the terminating pipe symbol. Codes may be imbedded as many times as you wish, so long as the fully translated code is no longer than 255 characters. The file SCRUTIL.CTL contains the specific information on what each screen in the images file is used for. Name Description Example -------- ------------------------- --------------------------------------- AREANAME Message area name @AreaName| Returns the area that the message has been posted in. AREANUM Area number @AreaNum| Returns the number of the area the message is being posted in. BBSNAME System name @BBSName| Returns the name of the BBS configured in 'CONFIG.System.Site Info.BBS Name'. CLEARWIN Clear window @ClearWin.2,2,80,10,1| Clears a window of the screen, making the background blue (1). In this example, the window cleared would start at (2, 2) and end at (80, 10). COLOUR Change to colour @Colour.1| Changes the colour to blue (1). CURTIME Current time @CurTime.0| Returns the current time in HH:MMp format. If the hour is less than 10, the '0' in the data field specifies that the hour field should be padded with a '0' (ie. 09:00p). If nothing is specified in the data field, a zero is used. DEFCOL Return default colour @DefCol.5| Returns the colour of the fifth item in the colour configuration, that being "message text." An optional "," may be used after the number, defining whether to change to the bright or normal colour (ie. @DefCol.5,H| returns 15, @DefCol.5,L| returns 7, assuming the item is set to 7, white). See the Language Support section for a list of the configurable colours. EVAL Evaluate math @Eval.20-4/2*4| Evaluates a mathematical string. In this case, the result will be 32 and the order of operations (BEDMAS) are always ignored (so it evaluates 20-4=16, then 16/2=8, then 8*4=32). Valid characters are '+', '-', '/', and '*'. Parentheses are not supported in this version. FROMNAME Sender's name @FromName| Returns the name the message is from. LENGTH Return length of string @Length.@ToName|| Returns the length of the string @ToName|, that being the name of the person the message is to. LNG Language string @Lng.2| Returns language string #2. NUMLINES Number of lines on screen @NumLines| Returns the number of lines on the screen available to the user. For example, if the screen is in 25 line mode and there is a status line, @NumLines| will return 24. If there is no status line, @NumLines| returns 25. PAD Pad string @Pad.@ToName|,20| Pads the string @ToName| with spaces so that it equals 20 characters. PADC Pad char @PadC.-,20| Returns the character '-' 20 times. PAUSE Pause @Pause| Waits for a keypress while displaying a pulsing prompt. RAND Random write @Rand.ÄÄÄÄÄÄ,4,12| Writes the string "ÄÄÄÄÄÄ" in the random colours red and bright red (4,12). RESTSCR Restore screen @RestScr.1,1,80,24| Restores a segment of the screen saved by @SaveScr|, starting at (1, 1) and ending at (80, 24). SAVESCR Save screen @SaveScr| Saves the current screen. SUBJECT Message subject @Subject| Returns the subject of the message. If in module mode, this will return the title to be displayed. TIMELEFT Time left @TimeLeft| Returns the number of minutes left. TONAME Recipient's name @ToName| Returns the name the message is to. TRUNC Truncate variable @Trunc.@AreaName|,20| If the length of @AreaName| is greater than 20 characters, only the first 20 characters will be displayed. Otherwise, it is displayed as is without any whitespace padding added to the end. UPDOFF Disallow screen updates @UpdOff| Turns off screen updates (ie. the time and time left being displayed in the header). UPDON Allow screen updates @UpdOn| Turns on screen updates (ie. the time and time left being displayed in the header). VER Version number @Ver| Returns the version number of DCTEdit. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³ Distribution & Disclaimer ³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ DCTEdit is copyright (C) 1997, 1998 by Dan Traczynski. All rights reserved. I encourage you to distribute it, but DO NOT by any means alter any of the files within the original archive. DCTEdit may not be included on any CD-ROM collections. The archive should be named DCTED004.ZIP, preferably kept in its ZIP format. The author, Daniel Traczynski, will take no responsibility to anything that this program may or may not do to your system. Although the program has been tested thoroughly by the support team, no guarantee can be given that it will do what it was made to do. Nevertheless, if anything should happen, the user is totally responsible and the author will be under no obligations what- soever. By using this program you agree to this disclaimer. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³ Author's Notes/Support ³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Many of the features that I add to this door are requests made by SysOps, so if you would like to see a new feature added to this door, by all means send me e-mail and I will try to add in your request. I can be reached at dant@sfu.ca. If you do not have Internet e-mail access, I can also be contacted via the FidoNet RA_Util echo or by netmail at 1:153/757. DCTEdit and other DCT Productions can be found on the Internet at: http://www.worldnet.net/~island/dct.htm http://www.sfu.ca/~dant/bbs/dct.htm ftp://ftp.canbbs.net/pub/DCT_Productions/ Thanks go to Francois Massonneau for hosting the worldnet site and Jason Feasby for hosting the FTP site. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³³³³³ Release Notes ³³³³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ + Added a new feature/Something was improved. - Removed something. * General comment. > Bug fix. Version 0.04 Gamma -=- January 5, 1998. + Added spell checking routines. + DCTEdit now auto-configures itself to RA/PB/TG/EZY BBSs when CONFIG is first run. + Added Telegard 3.0x and Ezycom 2.10/newer support to the override manager. + Improved the override manager; it's now much easier to change the flag settings of areas. + DCTEdit can now 'adopt' taglines out of the quoted text in message replies. + Added the MAKEDICT.EXE program to compile DCTEdit's dictionary. Run it without any parameters for program usage information. > Fixed a bug when DCTEdit was reformatting quoted text. > Users could add their own taglines to messages regardless of whether it was enabled in CONFIG; DCTEdit just wouldn't display the option on the screen if it was disabled. Fixed. * The System.Preferences, System.Limits, and System.General menus in CONFIG have been merged into two new System.Site Info and System.General menus. > Pressing the left or right cursor keys in the user setup menu no longer exits it. + Added the /A parameter. + Added CLASSIC.EDS screen definition file. > Fixed a problem when @F@ was used in the default signature for new users. + The character that begins a kludge line may now be configured. + DCTEdit now supports node 0. + DCTEdit will now properly display the message area name under Ezycom systems. Version 0.03 Gamma -=- October 4, 1997. + Improved the censoring system. DCTEdit no longer uses messy text files but rather it reads in FILTER.DCT which may be edited through CONFIG. + The maximum length of each line of quoted text may now be configured. + Added macros/AutoCorrect/whatever you want to call it. + Added message area overrides (RA/PB). > Fixed some display bugs. + Added @BBS@, @F@, @FF@, @FL@, and @FROM@ macro support to taglines. + Added a new user default setup to CONFIG. Any valid tagline macros may also be used in the default user signature and are translated when the user's record is first created (not every time s/he enters the door). + Added code to automatically convert 'TExt LIke THis' to 'Text Like This'. > DCTEdit was creating a log file if the user's time exceeded (normally it only creates a log file if something goes wrong). Fixed. + Added the menu editor. All of the pull-down menus can now be configured. + Added a print message option. Printing is always done to LPT1, so if your setup is different, you can remove the option from within the menu editor. This option may only be activated by someone with SysOp access who is logged in locally. These security settings can be modified in the menu editor if so desired. + You can now have DCTEdit append text files to the end of messages posted by message area or globally. + Added Alt-J: Shell to DOS. + Added the SysOp Fn key macros. + The border characters in the pop-up windows may now be configured. The /BORDER command-line parameter has been added to SCRUTIL to accommodate this new feature. + DCTEdit now supports ProBoard. Note that in the user editor, flag A1 equals ProBoard's user flag 'A' through to flag D8 which equals ProBoard's user flag '6'. + DCTEdit now searches both the real name and alias fields of each user record rather than just the real name when editing the recipient's stats. + Quote reformatting is now optional. You can now opt to truncate lines which are too long or split them and add the rest of the text to one or more new lines underneath via 'CONFIG.System.Quoting.Quote Formatting'. + Added Ctrl-C: Centre Line. + Added Ctrl-J: Left justify line. > Fixed a bug when Enter was pressed on the first column of a quoted line. + Added two more colours to configure: Picklist and Menu Title. + Added a German language file, written by Grischa Brockhaus. + Added /T parm. + Added imbedded codes "BBSNAME" and "TRUNC" to screen definition files. + DCTEdit now checks that the user's terminal has ANSI capabilities before letting him/her in. + Added code to prevent duplicate taglines from appearing in the selection box when saving the message. > Fixed a problem when a user whose terminal supported 25 lines entered the door and the SysOp's monitor was in 50-line mode. + Added Ctrl-K: Paste Text. Version 0.02 Gamma -=- August 11, 1997. * Default uppercase limit changed to 35%. + DCTEdit can now also be used as a remote text editor (useful for the editing of batch files remotely by the SysOp). The /E and /R parameters have been added to support this. + The lightbar colour may now be configured (before it would simply be the box colour inverted). + DCTEdit now reformats the quoted text so it doesn't look chunky. + Hitting Enter somewhere on a quoted line now splits it in two with the quoting initials added automatically. + Added imbedded code "RAND" to screen definition files. * Changed DCTEdit's appearance a bit; it now looks brighter and is more fun to look at. * Many changes made to the colour configuration. You can now select the background colour for most items. + DCTEdit now converts codes such as "@TO@" in the taglines. + Added Ctrl-F: Find Text. + Added the translation table. + Added support for the Ctrl-Home and Ctrl-End key combinations. They can be accessed remotely with Ctrl-\ and Ctrl-], respectively. > DCTEdit would always force the uppercase ratio regardless of what it was set to in CONFIG. Fixed. Thanks to Alan Ianson for spotting this one. + Added the SysOp menu. + DCTEdit can now import files into the message. The shortcut hotkey on the local end is Alt-I. + DCTEdit now allows those with SysOp access to edit the recipient's stats on a RemoteAccess 2.xx BBS. Support for additional BBS software may be added in future versions. + DCTEdit now supports the MSGINFO.SYS file created by Terminate in offline reader mode. Version 0.01 Gamma -=- July 31, 1997. * Initial release of DCTEdit. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³³³³³³³³³³³³³³³³³³³³³³³³ End of documentation ³³³³³³³³³³³³³³³³³³³³³³³³³³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ