**************************************************************************** Thank you for using Programmer's SUPER-MAINT. The program has many features, and after you become comfortable using it you'll find it saves you time and effort in building your progamming projects. **************************************************************************** **************************************************************************** You can conveniently read this file from within INSTALL, and print it to your printer (if installed on lpt1) if you want to. **************************************************************************** **************************************************************************** If you are new to make utilities print out and read the file NEW2MAKE.TXT (it is on Disk #2 (5 1/4" disks only), or in SUPER_B.ZIP). **************************************************************************** **************************************************************************** If you are a shareware VENDOR, a BBS, or USER GROUP who wants to distribute SUPER-MAINT please read the file VENDOR.DOC. **************************************************************************** **************************************************************************** If you want to order a registered copy please see the file REG.FRM. **************************************************************************** **************************************************************************** Since the manual was printed some additional features have been added. Please print out the file ADDENDUM.MAN and insert it into your manual. **************************************************************************** **************************************************************************** The topics covered in this file are: 1. Shareware 2. Installation 3. Manual (view and print) 4. Compiler Support 5. The future 6. Product Support* 7. Printing Utilities 8. The sample program 9. A note on building libraries *General notes; Special notes for users of Clipper, Mix Power C **************************************************************************** ************** A NOTE ABOUT OUR BULLETIN BOARD SYSTEM ********************* As of February 1991 the EmmaSoft Shareware Board BBS has been on line. All the LATEST VERSIONS of EmmaSoft shareware can be found here. In addition there is a growing collection of other shareware programs, most notably those written by Association of Shareware Professionals authors. There is no charge for accessing this board, and downloads are unlimited (except by the daily time limit). In addition you may order any EmmaSoft product using the BBS, and registered users may get technical support there. The EmmaSoft Shareware Board is an approved ASP BBS. 607-533-7072 2400,1200,300bps N,8,1 24 hours No access Fee **************************************************************************** If you got SUPER-MAINT on 5 1/4" disks you MUST have DISK#1 AND DISK#2. Both are contained on the 3 1/2" disk version. If you got an evaluation copy on a BBS you must have two files: SUPER_A.ZIP and SUPER_B.ZIP. On some BBSs these are both contained in a large file called SUPER.ZIP. The following files MUST be on your distribution disks, or contained in the .zip file you recieved SUPER-MAINT on. If any of these are missing PLEASE CONTACT EMMASOFT IMMEDIATELY: you have probably recieved an unauthorized package. To insure that you get a complete version you must have an authorized package. You may get the distribution disk for a small fee from EmmaSoft or from authorized shareware distributers, or get the .zip file from many bulletin boards across the US. DISK #1 (or SUPER_A.ZIP) BBS.TXT Information about EmmaSoft's BBS INSTALL.EXE Automatic Installation Program README.1st Where to find things to get started Now! README.SUP This File REG.FRM Registration Form SMAK.EXE SUPER-MAINT Files SUPER.INF Brief Description of SUPER-MAINT VENDOR.DOC File for Shareware Vendors, SysOps, User Groups DISK #2 (or SUPER_B.ZIP) ADDENDUM.MAN Recent Additions to the Manual BOR.EXE Borland Language Definition Files CLIP.EXE Clipper Language Definition Files DEMO.EXE Demo Language Definition Files/ Bogus Compilers MANX.EXE Aztec Manx Language Definition Files MIX.EXE Mix Language Definition Files MS.EXE Microsoft Language Definition Files NEW2MAKE.TXT File for programmers new to Make programs S.COM Landscape Print Utility SMUPDATE.TXT A history of updates to SUPER-MAINT SMUTIL.EXE Help files, Sample Program, Manual and Indexes SUPER-MAINT consists of four programs: SM.EXE SUPER-MAINT A make program SME.EXE SUPER-MAINT Editor Automatically generates make and other files SMSET.EXE SUPER-MAINT Setup Facility Sets up parameters needed by all four programs SMH.EXE SUPER-MAINT Help Facility Used by maker, or can be used as a stand alone program Acknowledgements: Special thanks to the beta testers: For helping with a thorny problem: Don Bowen Tom Bruce Todd Hutchinson (version 1) Herb Kraft Ralph Mace Allen Morris Peter Schulz Larry Weaver **************************************************************************** **************************************************************************** 1. SHAREWARE: The advantage to using shareware is that you get to "try before you buy" the program. There are many excellent shareware packages, and we hope you will feel SUPER-MAINT is one of them. If you do, and you use the program beyond 30 days, you must register your copy. Registration has many advantages: 1. You get the latest version of SUPER-MAINT on disk with a printed manual. 2. The version you recieve has the registration reminder screens removed. 3. You get a serial number that entitles you to technical support. 4. You will recieve upgrade notices and you will be able to upgrade at a discount. 5. You will recieve a free CompuServe Intro Pak including $15 on-line credit and a complimentary subscription to CompuServe Magazine 6. You may subscribe to Shareware Magazine for a substantial discount. Registering SUPER-MAINT is still only $55. See the file reg.frm for a registration form (you may do this by mail, or by plastic: EmmaSoft accepts phone registrations, registrations by CompuServe Mail, and on our own BBS if you have Master Card or Visa). SUPER-MAINT was written by Dan Veaner, an ASP (Association of Shareware Professionals) member. For more information about shareware and the ASP see chapter 9 in the manual. See "Product Support" below to see how to reach me. ASP (Association of Shareware Professionals) After reading chapter 9 if you are interested in learning more about the ASP log onto CompuServe and GO ASP. We also have information about the ASP on our BBS. Or write: Executive Director; ASP; 545 Grover Road; Muskegon, MI 49442-9427. If you are a shareware author, distributer, or BBS SysOp you should consider joining for the many benefits membership provides. **************************************************************************** **************************************************************************** 2. INSTALLATION: You should use the automatic installation program to install SUPER-MAINT. (You will need approximately 560K free disk space to complete an installation.) It will copy the SUPER-MAINT files to your hard disk, create directories, if needed, set up an initialization file, and perform a few other tasks. A SPECIAL NOTE: THE INSTALLATION PROGRAM WILL NOT MAKE NEW DIRECTORIES OR CHANGE YOUR AUTOEXEC.BAT FILE UNLESS YOU EXPLICITLY GIVE IT PERMISSION TO DO SO. THE PROGRAM DOES NOT TOUCH YOUR CONFIG.SYS FILE OR ANY OTHER FILES ON YOUR COMPUTER. IF YOU CHOOSE **NOT** TO LET INSTALL UPDATE YOUR AUTOEXEC.BAT FILE YOU **MUST** SET THE SUPERFILES VARIABLE IN YOUR DOS ENVIRONMENT, AND ADD THE SUPER-MAINT DIRECTORY TO YOUR PATH COMMAND FROM YOUR AUTOEXEC.BAT FILE. examples: PATH C:\;C:\DOS;C:\SUPER SET SUPERFILES=C:\SUPER ("C:\SUPER is the drive and directory containing your SUPER-MAINT files). To begin type: INSTALL Just answer the questions you are asked as you go along. If you change your mind INSTALL lets you change your answers before it begins installation. **************************************************************************** After INSTALL finishes an installation it calls SMSET in `beginner' mode so you can set the options for your installation. If you don't understand a category just accept the default. When you are done print out the manual (SME alt-t alt-m alt-p) and refer to chapter 5 while running SMSET from the command line or from inside SME. **************************************************************************** NOTE: INSTALL.EXE does NOT copy itself, the compressed (self-extracting files), S.COM, or text files to your hard drive. Only files that are needed to run SUPER-MAINT are copied. ----IMPORTANT---- WE NO LONGER SUPPORT MANUAL INSTALLATIONS. PLEASE USE THE INSTALL.EXE PROGRAM TO INSTALL SUPER-MAINT. PLEASE NOTE: WITH THE EXCEPTION OF INSTALL.EXE AND S.COM ALL PROGRAM FILES ON THE DISTRIBUTION DISKS OR IN THE ZIP FILES ARE SELF-EXTRACTING FILES. SUPER-MAINT SHOULD BE INSTALLED ON A HARD DISK, NOT ON FLOPPIES. IMPORTANT NOTE: It is assumed in these documents that your compilers are kept in directories that are included in your PATH command. If they are not SUPER-MAINT will not be able to call them. **************************************************************************** **************************************************************************** 3. MANUAL: Full documentation is included with each copy of SUPER-MAINT. On disk it is provided in a special format SUPER-MAINT can read. Here's how to view it and print it on your printer: You may view the manual on line in the SUPER-MAINT Editor, or when using the Help Facility. Most of the manual may be viewed in this way. For the complete manual you will want a printed manual. To get a printout of the manual either go into the toolbox menu in the SUPER-MAINT Editor, or call the Help facility as follows: SMH MANUAL. You will see a table of contents on your screen. Press Shift-F7. You are now prompted for a printer or filename. If you want to print directly to your printer type Enter (for lpt1), or you may type lpt2, com1, or com2 if you printer is attached to one of these ports. If you want to print to a file (for importation into a word processor, or to print later) type a file name. By the way, the manual is about 60 pages long. (If you register you may notice the manual is 80 pages long. The text is identical - it's just the way the type is set that makes the difference. The table of contents and index have been adjusted for the different page numbers.) A file called ADDENDUM.MAN has been included that has updates and additions to the manual. Please print this out and attach it to your printed manual. **************************************************************************** **************************************************************************** 4. COMPILER SUPPORT At the moment SUPER-MAINT can be configured for several brands of compiler(s): Microsoft, Borland, Aztec, Clipper and Mix. When you install using INSTALL.EXE you choose to set it up for one of these or for the demonstration (bogus) compilers. BRAND SPECIFIC NOTES: SUPER-MAINT always writes make files such that Linkers and Librarians ALWAYS use Response files. Borland, Aztec, Clipper and MIX users will want to include the full path when setting library names in SME. When generating a SUPER-MAINT file for Borland products some linker and librarian commands are appended to the memory model macros in order to end up with the proper command structure. When building a make file for AZTEC libraries SUPER-MAINT adds an action block to run the list of object files through the ORD program. **************************************************************************** The SUPER-MAINT Editor builds make files with macro sets. When the maker sees the symbol for one of these sets in a make file it calls the appropriate macros, in order, in that set. You should be aware that SUPER-MAINT calls macros in different orders for some compiler brands: BORLAND: compiler_command all_macros* file_to_compile LxF2_macro CLIPPER: compiler_command file_to_compile all_macros ALL OTHERS: compiler_command all_macros file_to_compile compiler command: CL for Microsoft, TC for Turbo C, etc. all_macros: Set of 8 macros used by SUPER-MAINT (macros are defined in LASTMACS.SM using the "Macros" choice in the "Make" menu of SME.EXE). file_to_compile: MYFILE.C, MYPROG.ASM, etc. *All macros except the LxF2 are called before the file name (x refers to the language number 1, 2, or 3) **************************************************************************** SPECIAL NOTES FOR USERS OF CLIPPER: The Clipper Language Definitions Files come set up for using PLINK86 (that comes with Clipper. You will have to replace the LINKER.SM language definition file if you set SUPER-MAINT to use a different linker. (All other brands are set to use the linker that comes with the language products.) This is easy to do: but Disk#2 in drive a:. Go to the directory you have installed SUPER-MAINT files in. If you want to use Microsoft's LINK.EXE If you want to use Borland's type "A:MS LINKER.SM (Enter)". TLINK.EXE type "A:BOR LINKER.SM (Enter)". In SMSET (setup facility), if you choose CLIPPER you are asked to choose a linker. If you choose PLINK86 or "None" you are also asked to choose a librarian, even if you won't be using one. You must set up a language definition file for the librarian you choose. Do this the same way you set up the linker language definition files, but replace "LINKER.SM" with "LIB.SM" in the command. If you choose "None" for your linker it means you are using a linker that is not supported by SUPER-MAINT. Simply write your own response files for these linkers. You may also have to change the linker action block in the make file. SPECIAL NOTE FOR USERS OF MIX POWER C: When using the MIX librarian (MERGE.EXE) the name of the library must not be the same as the name of one of the modules in it. This is because object modules and libraries both use the same (.MIX) extension. To automate this change the setting for the executable file name in the Setup menu as follows (from the main menu bar): Alt-s Setup Menu alt-n Name Defaults  Down to Executable File Name N No for "Don't use default"  6 times to get to bottom Enter Accept changes Esc Back to main menu bar /************************************************************************* * * * If you use products other than those currently supported and would * * like them supported by SUPER-MAINT We'll be happy to write them into * * the program. Contact us and we'll tell you what information we need. * * * *************************************************************************/ BOGUS COMPILERS (DEMO Setup): The "Demo" files wer written for demonstrating Programmer's SUPER-MAINT at COMDEX. The idea was to demonstrate the program without the overhead of a real compiler, assembler, etc. The demonstration uses 5 programs: a bogus compiler, bogus assembler, bogus linker, bogus librarian, and a bogus debugger. These and the requisite language definition files are placed on your disk when you choose "Demo" in INSTALL. The first two create bogus object files. These are actually ascii files with the .OBJ extension. The linker does the same, but creates a file with the .EXE extension. The librarian uses the .LIB extension. All take similar arguments to their Microsoft counterparts, but the arguments have no effect. The one exception is the /CO argument for the linker. If you use /CO the ascii file starts with a line "Debugging Information Included." The Bogus Debugger reads the first letter of the bogus .EXE file. If it is a "D" the debugger starts normally. If not it displays a message that debugging information is not included. If you want to try Programmer's SUPER-MAINT without using real compilers, etc. install the "Demo" files when INSTALL.EXE asks "Who manufactures your compiler(s)?". When you use SUPER-MAINT it will call the bogus programs to create bogus files. Use the bogus debugger to see whether "debugging information" was included (as a test of the -d and -n flags). IMPORTANT NOTE: Do NOT try to run bogus .EXE files, and do NOT link bogus .OBJ or .LIB files into real programs! ALSO NOTE: When using the Demo setup SM.EXE and SME.EXE think they are set up for Microsoft Compilers. (If you use alt-b you can confirm this.) This is NOT an error. Bogus C Compiler: EBCL.EXE Bogus Assembler: EBMASM.EXE Bogus Linker: EBLINK.EXE Bogus Librarian: EBLIB.EXE Bogus Debugger: EBDB.EXE -------- **************************************************************************** **************************************************************************** 5. THE FUTURE Note from the author: The reason I wrote SUPER-MAINT was to make life easier for myself and other programmers. If there are features you would like in SUPER-MAINT please don't hesitate to contact me. Please don't be angry at the program for not doing something you want it to do. Instead let me know what you want and there is a very good chance it will be included. I try to include as many users' suggestions into my programs as is reasonable (given the scope of the program). So please keep those cards and letters coming! If SUPER-MAINT works with your compiler that is not listed in this file please let me hear from you. I would be grateful for language definition files for your compiler. If you send them (and they are not duplicates of others sent) I will include them in a future release of the product with appropriate credit to you. **************************************************************************** **************************************************************************** 6. PRODUCT SUPPORT We make every effort to make our products happy, bug free programs. We test our software rigorously before releasing it. SUPER-MAINT has been used in it's own development since there's been enough of it to work properly. Every once in a while one of those pesky insects does get into a program, and bug reports are greatly appreciated from all users. Technical support is ONLY available to REGISTERED users with a valid serial number (when you register you are sent the latest copy of SUPER MAINT with printed documentation, a valid serial number, and WITHOUT the shareware reminder messages that are built in to the unregistered version). EmmaSoft does NOT support third party products. For example, we don't give technical support for Microsoft C, Turbo C, etc. Please call the manufacturer for support for these products. EmmaSoft is open 9 to noon, 1-5, M-F (and sometimes on Saturdays). The address is: EmmaSoft PO Box 238 Lansing, NY 14882-0238. The voice phone is (607) 533-4685. The BBS phone is (607)533-7072 (24 hrs. 2400, 1200, 300 bps N,8,1) CompuServe ID: 71460,2644. If you are a registered user you may have access to the tech support conference on EmmaSoft's BBS. Leave a note for the SysOp, including your serial number, and within a day or so you will have access there. Meanwhile you may leave support questions in private messages on the main board. If you call and get the answering machine please leave a message. If you want me to call you back please leave a number where we can call collect, and some good times to reach you. **************************************************************************** **************************************************************************** 7. PRINTING UTILITY A source code landscape printing utility for LasetJet users is included with SUPER-MAINT. Users of version 1 may wonder why there are no longer 2 utilities: the functions of both have been included in the new S.COM. If you have the 2 disk set S.COM is on Disk 2. If you downloaded SUPER_A.ZIP and SUPER_B.ZIP it will be in the latter file. INSTALL does not copy S.COM to your disk. **************************************************************************** **************************************************************************** 8. THE SAMPLE PROGRAM Included with this package is a set of sample files that you can use to experiment with. These consist of: SAMPLE.C C Code SAMPLE1.C C Code SAMPLE2.C C Code { use one or the other } SAMPLEA.ASM Assembly Code { but not both modules } SAMPLEA.OBJ Object made from SAMPLEA.ASM for C Programmers who don't own MASM SAMPLE.EXE An executable version. SAMPLE.EXE is a simple multi moduled program addition using C and Assembly language. It contains 5 functions: 2 in each C module, and one in the assembler module. To call it you type SAMPLE and two numbers (ex: SAMPLE 5 67). It will add the numbers and report on whether it is exiting properly or with an error condition. NOTE: You may only use SAMPLEA.ASM if you have Microsoft MASM. If you do you must compile the program in the small model. Otherwise, replace SAMPLEA.ASM with SAMPLE2.C and compile in any model. It contains the C version of the assembly module. **************************************************************************** **************************************************************************** 9. A NOTE ON BUILDING LIBRARIES Because SUPER-MAINT depends on response (command) files you may find building libraries minorly awkward if you are building the same library in more than one memory model. What you need to do is to build the library using the name you have chosen. For each memory model you build RENAME the final library. For example if you are building three versions of the MYLIB library you build it once for each memory model: sm -1 MYLIB then rename the library for that model: ren MYLIB.LIB SMYLIB.LIB Now rebuild for the medium model: sm -er -2 MYLIB and rename the final file: ren MYLIB.LIB MMYLIB.LIB and so on. Library maintainance is on the slate for major improvements in version 3. ****************************************************************************