================================ README ================================== This CD-ROM contains a sampling of programs from the OS/2 Archives at the Internet site ftp-os2.cdrom.com. Although you may own this disk, you do not own the programs recorded on it. Many programs on this disk are shareware. You are free to try each program for a limited amount of time. If you are satisfied, and want to continue to use the program, you are expected to register the program. You register by sending a specified amount of money directly to the author of the program. Often the author will send you the most up to date version of the program and a printed manual. Please check the individual files for specific information. =========================================================================== Here is a list of important files: 00readme.txt This file. 00index.txt List of all the files. 00index.zip Zipped copy of 00index.txt bin/ Ready to run applications. book/ Program documentation in the .inf format. cidinst/ The 2.1 Service Packs CDROM install directory cidinst/disks The 2.1 Service Packs floppy install directory dirs.txt Listing of directories and their contents. fonts/ 248 Post Script Shareware and Freeware fonts help/ .hlp files for PM aplications icons/ 4,803 icons to browse and customize your desktop. info/ Info files for the gnu 'info' program. lib/ Program support files man/ Manual pages for the 'man' program and Documentation for utilities in /bin. src/ Source code for many of the ready to run programs wav/ 350 wave audio files All OS/2 users will benefit from reading the Internet's OS/2 Frequently Asked Questions list which can be found as /man/21faq.txt or /book/21faq.inf. All files on this disc are OS/2 specific, and many files will not be accessible through MSDOS. ============================================================================= Disclaimer: This CDROM comes with a full money back guarantee. If you are dissatisfied for any reason, you can return it for a full refund. If the CDROM is unreadable, you may exchange it for a working version. Walnut Creek CDROM makes no warranty about any program on this CDROM, including any written by Walnut Creek. You, not Walnut Creek CDROM, assume all risk of using any program on this CDROM. We reserve the right to limit any effort on our part to rectify problems with any software on this CDROM. ============================================================================== If you have any questions about this CD-ROM, or if you would like a catalog of other CD-ROM titles, please write or call: Walnut Creek CDROM +1 510 674 0783 1547 Palos Verdes, Ste 260 1 800 786 9907 Walnut Creek CA 94596 +1 510 674 0821 (fax) USA info@cdrom.com (internet) 72147,3425 (compuserve) -------------------------------------------------------------------- Walnut Creek CDROM is an approved vendor and associate member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536. =============================== README =================================== Introduction: ============= What follows is a slew of information to introduce you to new features and to guide you through the use of this disc. Most of the modifications are to the system "Config.sys" file. This file can be found in the root directory of the drive to which you installed OS/2. Modifications to the Config.sys file do not effect the system until a reboot. OS/2 treats all files that are on a CDROM as being read only. This attribute is carried with the file when it is either copied or "dragged and dropped" to a hard disk or floppy. This attribute must be cleared before the file can be deleted. From the command prompt type "attrib -r ". From the Program Manager, open the settings pages for the file, select file, go to the third page, and un-check the "read-only" box. Before using any of the utilities pre-installed on this disk, read the following general instructions. You may find additional information under specific program or group headings bellow. Anytime an instruction uses "" replace the text with the drive letter of your CDROM. For example, if your CDROM was assigned the drive letter 'E', all instances of "" would be come "E". We have also included a sample config.sys file to help guide you through the installation of the packages on this CDROM. The sample uses the E: drive as the CDROM drive, and comes from a machine with a Toshiba 3401 CDROM drive IBM's TCP/IP package, and Novell Netware OS/2 Client software installed. We have tried to document each section of the file so that packages unrelated to the HOBBES OS/2 CDROM are less confusing. Getting Started: ================ 1)CDROM Environment Variable Some of the scripts contained on this disk use the environment variable "CDROM". Append the following line into your config.sys file to initialize the "CDROM" environment variable. REM ========= CDROM Drive Environment Line Begin ========== set CDROM=F: REM This should be the drive letter of your CDROM REM WITHOUT a trailing '\'. REM ========== CDROM Drive Environment Line End =========== Replace the "F:" we've used in this example with the logical drive letter of your actual CDROM. 2)Dynamically Linked Libraries Almost every program "ready-to-run" off of the Hobbes CDROM requires access to one or more DLLs (Dynamically Linked Libraries). These libraries have been conveniently collected into the :\lib\dll directory. You can simply append this directory to your "LIBPATH" statement in your config.sys file. **NOTE** To ensure that programs you have copied off of the CDROM have access to their DLLs even when the CDROM is not in your drive, you may wish to have the "LIBPATH" variable point to copies of the DLLs on your hard drive. If this is the case, either copy all of the files in the :\lib\dll directory to your \os2\apps\dll directory (a directory in the "LIBPATH" by default) or create a new directory, copy the files there, and append it to the "LIBPATH" statement. In the end, your "LIBPATH" may look like this: REM ============ Modified LIBPATH Statement ======================= REM E:\LIB\DLL appended 9/02/94 REM =============================================================== LIBPATH=D:\IBMCOM\DLL;.;D:\OS2\DLL;D:\OS2\MDOS;D:\;D:\OS2\APPS\DLL;D:\TCPIP\DLL;D:\MMOS2\DLL;D:\NETWARE;D:\NETWARE\NLS\ENGLISH;L:\OS2;P:\OS2;E:\LIB\DLL REM ================= End LIBPATH Modification ==================== **NOTE** This CDROM contains version 0.8h of the EMX runtime dll's. If you have earlier versions of these libraries in a directory referenced by the "LIBPATH" statement before the libraries provided on this disc, utilities that use the EMX dll's may yield unpredictable results. 3) Program Execution Path Modifications To gain access to the applications in the \bin directory from, anywhere in your system, add ":\bin" to the end of the "PATH" statement of your config.sys file. Your "PATH" may look like this: REM ================ Modified PATH Statement ===================== REM F:\bin appended 9/02/94 REM ============================================================== SET PATH=D:\OS2;D:\OS2\SYSTEM;D:\OS2\MDOS\WINOS2;D:\OS2\INSTALL;D:\;D:\OS2\MDOS;D:\OS2\APPS;D:\TCPIP\BIN;D:\MMOS2;D:\NETWARE;L:\OS2;P:\OS2;F:\BIN REM ================= End PATH Modification ====================== 4) Terminal Definition Files and Environent Variables Most GNU utilities also require information about what type of screen your computer has. For this reason, the following lines should be added to your config.sys file: REM ======== BEGIN General Terminal Settings ============== SET TERMCAP=://termcap.dat SET TERM=mono REM Mono is my preference, you can use "ansi" for color support REM ========= END General Terminal Settings =============== where "" and "" are a safe location on your hard drive. The termcap.dat file can be found as :\lib\termcap.dat and should be copied to your hard drive to ensure that applications that you have copied will run even when the cdrom is not in your drive. ** 5) Manual Pages ( Optional, but highly recomended ) Many of the GNU utilities installed on this disk have a corresponding manual page, a form of online documentation. These manual pages are stored in the :\man directory. Man, the utility used to view these manual pages relies on the environment variable MANPATH to know where to find the manual pages. To set this variable, add the following lines to your config.sys file: REM ========= BEGIN Man Page System Statements ============ REM (You must use forward slashes) REM ======================================================= SET MANPATH=:/man REM ======== END Manual Page System Statements ============ Man depends on groff to format its pages. The following lines should be appended to your config.sys file to install groff: REM ============= BEGIN Groff Statemants ================== REM (You must use Forward Slashes) REM ======================================================= SET GROFF_FONT_PATH=:/lib/groff/font SET GROFF_TMAC_PATH=:/lib/groff/tmac SET REFER=:/lib/groff/dict/papers/ind REM ============ END Groff Statemants ===================== Once installed, you can type "man " to learn more about the GNU and other "UN*X" like utilities on the disc. example: [c:\os2] man less This would list a few pages of information on "less" a utility that acts like the screen pager "more," but has many nice features and better speed. If you decide to copy man.exe and the man directory to your hard drive, you will need to modify the search paths that man uses to find itself and the manual pages. Open the file manpath.cfg (located in the /bin directory of the cdrom) and change the paths accordingly. Run manpath.exe to make the changes internally to man.exe. ** 6) GNU Info - Hypertext Document System (Optional, but highly recomended) Many of the utilities installed on this disk have a corresponding "info" page, a form of hypertext documentation. These "info" pages are stored in the :\info directory. Info, the utility used to view these "info" pages relies on the environment variable "INFOPATH" to know where to find its input files. To set this variable, add the following lines to your config.sys file: REM ============== BEGIN Info Statements ================== SET INFOPATH=:/info REM =============== END Info Statements =================== Once installed, simply type "info" to begin browsing documentation. 7) INF Files and the BOOKSHELF and DPATH Environment Variables .INF style program documentation has been added to the :\book directory. This documentation can be read using the "view" command. To ensure this access regardless of the directory from which "view" is invoked, register the :\book directory with the view system by adding :\book to your BOOKSHELF Environment Variable. OS/2 also requires this directory to be added to your "DPATH" Environment Variable. Your "BOOKSHELF" statement may look like this: REM ============== Modified BOOKSHELF Statement ================== REM F:\BOOK appended 9/02/94 REM ============================================================== SET BOOKSHELF=D:\OS2\BOOK;D:\TCPIP\DOC;F:\BOOK;D:\MMOS2;d:\4os2;F:\BOOK; REM ================ End BOOKSHELF Modification ================== Your "DPATH" statement may look like this: REM ================ Modified DPATH Statement ==================== REM F:\BOOK appended 9/02/94 REM ============================================================== SET DPATH=D:\IBMCOM;D:\OS2;D:\OS2\SYSTEM;D:\OS2\MDOS\WINOS2;D:\OS2\INSTALL;D:\;D:\OS2\BITMAP;D:\OS2\MDOS;D:\OS2\APPS;D:\MMOS2;D:\MMOS2\INSTALL;D:\4OS2;D:\NETWARE;D:\NETWARE\NLS\ENGLISH;L:\NLS;P:\NLS;F:\BOOK; REM================== End DPATH Modification ===================== 2.1 Service Pack Installation ============================= BEFORE CHOOSING TO INSTALL THE 2.1 SERVICE PACK OR 2.1 FOR WINDOWS SERVICE PACK, PLEASE READ IBM's INFORMATION ABOUT THIS CSD: :\CIDINST\21\README and :\CIDINST\21\README.INS. or :\CIDINST\21win\README and :\CIDINST\21win\README.INS. There are two ways to install the service pack from the Hobbes OS/2 CDROM. The first is to create a set of CSD (Corrective Service Diskettes) floppies from the floppy images in :\cidinst\21\disks or the :\cidinst\21win\disks directory. These are the images for the 3.5" distributions only, so you must have a 3.5" floppy drive on your machine in order to use them. The floppies are created with the "loaddskf.exe" utility. This program can be found in :\bin. Make sure that you don't have anything vital on any floppies you choose to use for creating the CSD set, as all data will be erased. To create a floppy, use a command like this: cd :\cidinst\21\disks :\bin\loaddskf 06200b1.dsk a: image file ==>^^^^^^^^^^^ ^^<==Destination Floppy Drive The only disks required to do the installation are: 2.1 GA Release: 1-13, 17-19 (CSD plus display drivers) 2.1 for Windows: 1-12, 16 - 18 (CSD plus display drivers) Once the images are created, shutdown your system using the shutdown command, insert the first CSD floppy, and reboot your machine. The CSD will then guide you through the procedure of upgrading your system. The second option is to have the first 13 diskette (12 in the case of OS/2 for Windows) images be installed directly from the CDROM. THIS INSTALLATION PROCEDURE IS NOT SUPPORTED BY IBM, so use at your own risk. Read all of the following instructions carefully before proceding. 1) Ensure that you have a set of bootable floppies that give you access to your CDROM drive. If you purchased and installed 2.1 from CDROM, the bootable floppies included with that product will work fine. If you don't have floppies that have CDROM support, you'll have to add the propper files to the second boot floppy and enter them properly into your config.sys file. These drivers might include, OS2CDROM.DMD and CDFS.IFS, but due to the variance of different CDROM support, there is no standard setup. If you don't know how to do this, play it safe and go with the first option given above to install the Service Pack. 2) You must create the Display Driver Diskettes (Three images, 06200b17.dsk - 06200b19.dsk for 2.1 GA, 06300b16.dsk - 06300b18.dsk for OS/2 for Windows) BEFORE you start the install. Do this via the "loaddskf.exe" method outlined above. 3) Shutdown your system properly, insert your first floppy diskette and reboot your machine. If you are using the OS/2 install floppies, you will be asked to insert the second disk. When the second disk puts an informational screen up, hit escape to invoke a shell (there is a menu option at the bottom of the screen for when you can escape to a shell). 4) Once at the command prompt, remove your boot diskette from the boot drive, and replace it with the first of the Display Driver Diskette floppies. 5) Change to you CDROM drive, cd to the :\cdinst\21(win) directory, and invoke a special "fservice" command. The whole sequence should look like this: [a:\]: [:\] cd cidinst\21[win] [:\cidinst\21[win]] fservice /s::\cidinst\21[win] /r::\cidinst\21[win]\response.fil The last command should be all on one line with a single space separating the /r and the end of line one. The [win] entries above mean to use "21win" instead of "21" in those places in the command line if you own the OS/2 for Windows product. You will get informative messages about the progress of the upgrade and can sit back and relax until you are prompted for the last two Display Driver Diskettes (NOTE: depending on you video hardware, you may not get asked to insert all three). 2.11 MMPM/2 CDROM Installation ============================== To install the new version of MMPM/2 that came with the 2.11 service Pack, run the program :\CIDINST\21[WIN]\MMPM\MINSTALL.EXE. From the command prompt this would look like: [D:\] : [:\] cd cidinst\21[win]\mmpm [:\cidinst\21[win]\mmpm\] minstall.exe The installation utility will show two diskettes in its installation progress window, but will only pass through one. This is normal since both floppies have been combined into one directory, so there is no need for the program to "change floppies." FONTS Directory: ================ The Fonts in the :/fonts directory are either ShareWare, FreeWare, or Public Domain software. Read any accompanying .txt file for the license restrictions pertaining to that font. BIN Directory: ============== This section describes the applications in the \bin directory of this CDROM and contains information on configuring these utilities. A2P.EXE - AWK to PERL translator, version 4.0. Translate your AWK scripts to Perl scripts. ADDFINFO.EXE - add information to troff font files for use with groff. Part of the GNU groff distribution. AFMTODIT.CMD - create font files for use with groff.( Manual Page Availible) APPTYPE.EXE - Prints the executable type [DOS, WINDOWS, 32 bit OS/2...] APROPOS.CMD - Search the manual page "whatis" database for strings. (Manual Page Availible) AR.EXE - archive used by EMX's link editor. AS.EXE - 80x86 class assembler. Part of the EMX distribution. AT.EXE - Schedule a program to run "at" a specific time. Part of the Cron/2 cron package. BASENAME.EXE - strip the directory and suffix from filenames. (Manual Page Availible) BC.EXE - An arbitrary precision calculator language. (Manual Page Availible) BIGRAM.EXE - Used in the creation of the locate database. Part of the GNU locate distribution. BISON.EXE - GNU Project parser generator (yacc replacement). (Manual Page Availible) CAL.EXE - displays a calender. (Manual Page Availible) CAT.EXE - Concatenate and Display. Useful for viewing multiple files or appending multiple files to each other. (Manual Page Availible) CC1.EXE - part of the EMX C compiler Package. CC1OBJ.EXE - part of the EMX C compiler Package. CC1PLUS.EXE - part of the EMX C compiler Package. CHMOD.EXE - Change Mode: File attribute changer. (Manual Page Availible) CKSUM.EXE - Checksum and count the bytes in a file. (Manual Page Availible) CMP.EXE - Compare - perform a byte by byte comparison of two files. CODE.EXE - Used in the creation of the locate database. Part of the GNU locate package. COLRM.EXE - remove columns from a file. (Manual Page Availible) COMM.EXE - Compare - Compare two sorted text files line by line. (Manual Page Availible) COMPRESS.EXE - GNU compress. Compression program part of the Gtak package. CP.EXE - Unix Copy. (Manual Page Availible) CPIO.EXE - copy files to and from archives. (Manual Page Availible) CPP.EXE - part of the EMX C compiler Package. CRON2.EXE - UN*X like cron with network support by Bob Hood. Please read :/man/cron2.doc or type "man cron2" for information on Cron2's FreeWare license and using this program. CSPLIT.EXE - Context Split - Split a file into sections determined by context lines. (Manual Page Availible) CTAGS.EXE - generates the "tags" and "refs" files for a group of C source files. The "tags" files are used by the Elvis commands :tag, Ctrl-] or the -t option. The "refs" files are used by the ref command. (Manual Page Availible) CUT.EXE - Cut - remove sections from each line of files. (Manual Page Availible) DATE.EXE - GNU date: print or set the system date and time. (Manual Page Availible) DC.EXE - An Arbitrary Precision Calculator. (Manual Page Availible) DD.EXE - Disk to Disk copy - convert a file while copying it. (Manual Page Availible) DF.EXE - Summarize free disk space. (Manual Page Availible) DIFF.EXE - Difference - display line-by-line differences between pairs of text files. (Info Entry Availible) DIFF3.EXE - Difference - same as above, but with three files. (Info Entry Availible) DIR.EXE - GNU dir. From the Gnu fileutils package version 3.9. DIRNAME.EXE - strips the file name suffix from a path. (Manual Page Availible) DU.EXE - Disk Usage - Disk usage of directory trees. (Manual Page Availible) DUMP.CMD - Used to recompile the emacs lisp library into Emacs. Part of the GNU Emacs distribution. ECHO.EXE - GNU echo. Display a line of text. More options than standard echo. (Manual Page Availible) EGREP, FGREP, GREP - The standard UNIX text parsing utilities. These utilities require the GNU libraries from the :\lib\dll directory and should be installed as outlined above. (Manual Page Availible) ELVIS.EXE - A VI editor clone. (Manual Page Availible) ELVPRSV.EXE - Preserve the modified version of an Elvis file after a crash. (Manual Page Availible) ELVREC.EXE - Recover the modified version of an Elvis file after a crash. (Manual Page Availible) EMACS.EXE - The extremely large yet powerful GNU text editor. Emacs occupies 14 megs of disk space and requires long filenames. This made it the perfect candidate for being put on a CDROM. Many thanks to Eberhart Mattes for porting Emacs to OS/2 and his assistance in making Emacs conform to the ISO 9660 level 2 (CDROM filename convention) spec. For those worried about the performance from a slow CDROM drive, let me assure you that EMACS is a well designed editor that rarely touches the disc after you load one instance of it. All further calls, use the first Emacs as their server and pop up almost instantly. To install emacs, ensure that the termcap environment variable is set and add the following lines to your config.sys: REM ========== BEGIN EMACS 19.25 Statements =============== REM (You must use forward slashes) REM ======================================================= SET EMACSLOADPATH=:/lib/emacs/lisp SET EMACSDATA=:/lib/emacs/data SET EMACSDOC=:/lib/emacs/data SET EMACSPATH=:/bin SET SHELL=d:/4os2/4os2.exe SET SYSTEMNAME=hobbes SET HOME=d:/ SET TMP=d:/tmp SET TMPDIR=d:/tmp REM =========== END EMACS 19.25 Statements ================ Replace the variable, and make your SYSTEMNAME, TMP and HOME directory (where emacs looks for a .emacs) suit your personal preferences. TMPDIR is used by the ediff packages and must be on an HPFS drive. If you don't have an HPFS drive, you cannot use ediff, but can otherwise use emacs. You should also change your shell line to the one you use (OS/2 comes with cmd.exe located in /os2 of your boot drive). If you want to move Emacs to your hard drive and "dump" it (update your version after modifications to the elisp library), you must also setup EMX. The Emacs distribution comes with a script that helps you modify the Workplace Shell for use with Emacs. The script is :/bin/instemacs.cmd and has options for creating a program folder, setting Emacs as the default editor, starting a server Emacs on startup, and associating text files with emacsclient. Once again, the best way to use Emacs from the CDROM is to have a master Emacs running all the time (run emacs -d, the -d option creates a PM interface for Emacs) and call emacsclient whenever you wish to edit a file. When you call emacsclient, you will get tossed back to the Workplace Shell where Emacs will have restored itself (if it was minimized) displaying the document you want to edit. To finish the session, hit C-x-# and re-minimize Emacs. To install emacs so that it is in a folder called "New Things," associates emacsclient with all text files, and makes Emacs the default editor, execute the following command: :/bin/instemacs install startup associate makedefault All of the features and pitfalls of Emacs for OS/2 as well as full documentation for the instemacs command can be found in :/lib/emacs/readme.os2. (Info Entry Availible) EMACSCLIENT.EXE - Client version of emacs. Relies on an instance of Emacs already running. EMACSSERVER.EXE - Special emacs that can service emacsclients. EMTEX - The TeX for OS/2. All of the binaries for this package can be found in :\lib\emtex. The script set_tex.cmd located in :\lib\emtex will setup the environment for TeX if you have the "CDROM" environment variable set. This distribution was created by installing the 32 bit beta TeX utilities over the original 16 bit package. More information about Tex can be found in the :\lib\emtex\doc directory. EMX Compiler Suite - EMX is a full featured OS/2 compiler. The following environment variables must be added to your config.sys file in order to install emx: REM ============= BEGIN EMX 08h Statements ================ REM (You must use Forward Slashes) REM ======================================================= SET C_INCLUDE_PATH=:/lib/emx/include SET LIBRARY_PATH=:/lib/emx/lib SET CPLUS_INCLUDE_PATH=:/lib/emx/include.cpp;F:/lib/emx/include SET PROTODIR=:/lib/emx/include.cpp/gen SET OBJC_INCLUDE_PATH=:/lib/emx/include SET GCCLOAD=5 SET EMXBOOK=emxdev.inf+libref.inf+gnudev.inf+bsddev.inf SET HELPNDX=emxbook.ndx REM ============== END EMX 08h Statements ================= If you followed the instructions in the above section "INF Files and the BOOKSHELF and DPATH Environment Variables" you should have access to all of the .INF format documentation for EMX. Type "view emxbook" to try it out. The REXX script :\bin\emxinst.cmd can also be used to create an emx program group on your desktop. More information about EMX can be found in the documents in the :\lib\EMX\doc directory. EMX.EXE - The Emx 32 bit DOS extender. EMXBIND.EXE - part of the Emx compiler suite. EMXCAT.EXE - part of the Emx compiler suite. EMXD.EXE - part of the Emx compiler suite. EMXIMP.EXE - part of the Emx compiler suite. EMXL.EXE - part of the Emx compiler suite. EMXOMF.EXE - Converts .o object files to .obj (OMF) format. EMXOMFAR.EXE - part of the Emx compiler suite. EMXOMFLD.EXE - part of the Emx compiler suite. EMXREV.CMD - part of the Emx compiler suite. ************************************************************************** ENV.EXE - GNU env: run a program in a modified environment. (Manual Page Availible) EQN.EXE - Equation preprocessor for troff (for typesetting mathematics). (Manual Page Availible) ETAGS.EXE - Emacs C program file tag generator. (Info Entry Availible - Under Emacs) EX.EXE - Single line editing mode for elvis (Manual Page Availible - Under Elvis) EXPAND.EXE - Converts tabs to spaces in a text file. (Manual Page Availible) EXPR.EXE - GNU expr: evaluates arithmetic and logical expressions. (Manual Page Availible) FBARINST.CMD - Program to create a WPS program opject for filebar. (See FILEBAR.EXE) FEELX - This program simulates many of the mouse features of X windows in PM. It is a package of utilities that can be found in the lib/feelx directory. By Felix von Normann. Man feelx or read :\man\feelx.doc for more information. FG.EXE - Part of the FeelX suite. Changes the parameters of an active shell. FGREP.EXE - See EGREP.EXE FILEBAR.EXE - SHAREWARE PM Toolbar with customizable menus by Eric A. Wolf. Man filebar or read :/man/filebar.doc for more info. FIZ.EXE - Public Domain Zoo archive repair utility by Rahul Dhesi. FLEX.EXE - fast lexical analyzer generator GNU (Manual Page Availible) FMT.EXE - adjust line-length for paragraphs of text. Simply adds or deletes newlines in a paragraph to make each line be approximately the same width. (Manual Page Availible) FOLD.EXE - Wrap each line in a text file to fit in a specified width. (Manual Page Availible) FONT.EXE - part of the FeelX suite. Change a shells font size from the command line. FONTC.EXE - part of the FeelX suite. Helper program to FONT.EXE. Not to be called directly. FUNZIP.EXE - filter UnZip (Manual Page Availible) FXEXEC.EXE - part of the FeelX suite. FXOPT.EXE - part of the FeelX suite. Display and change Feelx settings. GAWK.EXE - Gnu Awk: Pattern scanning and processing language. (Manual Page Availible) GCC.EXE - GNU C compiler 2.5.7: Part of the Emx compiler suite. GCC 2.5.4 Development System ============================ GCC 2.5.4 is another complete C, C++, and Objective C development platform for OS/2. All of its files can be found in the :/lib/gcc2 file hierarchy. Since many of the binaries in this collection share the same names as those of the Emx compiler suite, the gcc 2.5.4 binaries resize in :/lib/gcc2/bin. To install, add the following environment variables to your Config.sys: REM ========= BEGIN GCC 2.5.4 Statemants ================ SET GCC2=:/lib/gcc2 SET INCLUDE=:\lib\gcc2\os2incl SET TMPDIR=:/gcc2/tmp REM ========== END GCC 2.5.4 Statemants ================= You will also need to add :\lib\gcc2\bin to your path BEFORE :\bin so that you get the GCC 2.5.4 binaries instead of the EMX versions when compiling. To access the GCC 2.5.4 manual pages, setup the man page system as before, but append the :/lib/gcc2/man directory to your "MANPATH" environment line in the config.sys. Your final "MANPATH" may look like this: SET MANPATH=:/man;:/lib/gcc2/man Further information about the GCC 2.5.4 development environment can be found in :/lib/gcc2/doc. GDB.EXE - GNU debugger 4.11: Part of the Emx compiler suite. GENCLASS.EXE - part of the EMX compiler suite. GFIND.EXE - This is GNU find for OS/2. The file was originally named find.exe, but was renamed so as to not conflict with the built in OS/2 command named find. (Manual Page Availible) GHOSTSCRIPT - PostScript document viewer. Ghostscript's support files can be found in the :\lib\gs directory. Ghostscript uses environment variables to decide what type of display you have, where its initialization files are, and what size of a workspace to place on your screen. These environment variables must be initialized in your config.sys file. The modifications to your config.sys file should be as follows: REM ========= BEGIN GhostScript Statemants ================ set GS_BIT_DEPTH=8 set GS_PAPER_SIZE=a4 set GS_LIB=:/lib/gs;:/lib/gs/fonts;d:/psfonts;:/fonts REM ========== END GhostScript Statemants ================= The GS_BIT_DEPTH can be either: 8 - 256 color support (you display driver must support Palette Management) 4 - 16 gray scale mode 2 - 4 gray scale mode 1 - monochrome mode The GS_PATPER_SIZE can be any of the paper sizes listed in :/lib/gs/gs_statd.ps The GS_LIB variable is the search path for postscript files, fonts, and other files ghostscript requires. Read :/lib/gs/readme.os2 about how to add to this parameter. GSOS2.EXE - GhostScript 2.6.1 PostScript document viewer. This is the version of GhostScript without the PM driver and is usefull for doing batch jobs like converting PostScipt to PCLIV. GSPM.CMD - runs the PM version of GhostScript using the Environment variables from the Config.Sys file. GSPMDRV.EXE - GhostScript 2.6.1 with PM driver. Many sample postscript documents can be found in the :\lib\ gs directory. More information about GhostScript can be found in the document :\lib\gs\readme.os2. GMAKE.EXE - GNU make utility to maintain groups of programs. (Manual Page Availble) **NOTE** GMAKE does not perform properly under 4OS/2, a popular command shell replacement. You should use cmd.exe during compiles. GREP.EXE - See EGREP.EXE. GRODVI.EXE - convert groff output to TeX dvi format. (Manual Page Availible) GROFF.EXE - front end for the groff document formatting system. (Manual Page Availible) GROG.CMD - guess options for groff. Reads a file and tries to decide how to print it properly with groff. (Manual Page Availible) GROPS.EXE - PostScript driver for groff. (Manual Page Availible) GROTTY.EXE - groff driver for typewriter-like devices. (Manual Page Availible) GSORT.EXE - GNU sort. It has been renamed from sort.exe to gsort.exe to prevent it from interfering with the sort.exe shipped with OS/2. (Manual Page Availible) GZIP.EXE - GNU zip: Uses the same algorithm as regular zip, but uses a different archive header. Gziped files are very common in the Unix world. (Manual Page and Info Entry Availible) HEAD.EXE - Output the first few lines of a text file. (Manual Page Availible) ID.EXE - GNU id. Print real and effective UIDs and GIDs. (Manual Page Availible) INDENT.EXE - changes the appearance of C programs by inserting or deleting whitespace. (Manual Page Availible) INDXBIB.EXE - build inverted index for a bibliography. (Manual Page Availible) INFO.EXE - GNU info. Info is an information browser that offers more functionality than man. Any utility that had info documents has had them installed to the :\info directory. To setup Gnuinfo, add the following lines to your config.sys file: REM ============= GNU Info Environment Line =============== REM (You must use forward slashes) SET INFOPATH=F:/info REM ======================================================= once you have rebooted and this variable is in effect, simply invoke info from any directory to access the info utility. Info is a menu driven hypertext online help utility. (Manual Page and Info Entry Availible) INSTALL.EXE - copy files and set their attributes. (Manual Page Availible) INSTWPS.EXE - FeelX installation utility. (See FeelX) JOIN.EXE - join lines of two files on a common field. (Manual Page Availible) KILL.EXE - Kill processes by its process ID. Process ID's can be found by typing "pstat /c |more (or less if you have it installed)". KSH.EXE - Bourne / Korn Shell (Public Domain) (Manual Page Availible) LD.EXE - Linker: Part of the Emx compiler suite. LESS.EXE - A replacement for the "MORE" text paging utility. Less uses the "INIT" environment variable to locate the termcap.dat and less.ini file. These files are located in the :\lib directory. To setup less, place the following lines in your config.sys file: REM ============== BEGIN Less Statements ================== SET INIT=E:/lib/less REM =============== END Less Statements =================== Less will not run if these files cannot be found. We suggest copying them to someplace on your hard drive so that the files can be accessed even when the cdrom is not in your cdrom player. Less relies on the "TERM" environment variable. Less will default to an ANSI Color display, but if you find the colors unpleasant add the following line to your config.sys: SET TERM=MONO Other GNU utilities will also be affected by the TERM variable. (Manual Page Availible) LESSKEY.EXE - A utility to specify the keybindings for Less. (Manual Page Availible) LINE.EXE - part of the FeelX suite. Set the number of lines to show in a VIO window. LISTOMF.EXE - part of the Emx compiler suite. LKBIB.EXE - Search Bibliographic databases. (Manual Page Availible) LOADDSKF.EXE - IBM Disk image conversion program. Use on .DSK files. LOCATE.EXE - list files in databases that match a pattern. Locate can serve as an extremely fast file finder provided you keep an up to date database of all the files on your drive. We have provided a script that will create a locate database of the directories you specify with the LOCATE_INCLUDE_DIRS environment variable and place the output into the file pointed to by the LOCATE_WRITE_PATH environment variable. LOCATE_WRITE_PATH should point to a directory that exists on your Hard drive with locate.db appended to it. LOCATE_PATH specifies a semi-colon separated search path for locate. Do to a bug in OS/2's stat system call, locate databases cannot be generated of CDROMs. We have included a complete locate database of the hobes OS/2 CDROM in :/lib/locate.db. REM ========= BEGIN Locate Database Statements ============ REM (LOCATE_PATH must have a forward slashes) REM (TEMP should have a backslashes) REM ======================================================= SET LOCATE_WRITE_PATH=E:\lib\locate.db SET LOCATE_PATH=E:/lib/locate.db;:/lib/locate.db SET LOCATE_INCLUDE_DIRS=d:\ e:\ SET TEMP=d:\tmp REM I made this the same as TMP. This is so that REM OS/2 scripts that need the forward slash can REM use this variable instead of TMP. REM =========== END Locate Database Statements ============ After these changes, you can run updatedb.cmd in the bin directory to create the database file. The database file is very small, and provides for extremely quick searches. (Manual Page Availible) LOGARGS.CMD - Used by GDB. LOGNAME.EXE - Print users login name. (Manual Page Availible) LOOKBIB.EXE - Look up bibliographic references. (Manual Page Availible) LS.EXE - Unix file lister - like DIR. (Manual Page Availible) MAKEINFO.EXE - Compile Info Pages MAKEWHATIS.CMD - Create the "whatis" database for manual pages. (Manual Page Availible) MAN.EXE - format and display the on-line manual pages. See the "Getting Started" Section on setting up man. (Manual Page Availible) MANPATH.EXE - Sets the mandatory manpath for man. See the "Getting Started" Section on setting up man. (Manual Page Availible) MKDIR.EXE - make directory. (Manual Page Availible) MSGBOX.EXE - part of the FeelX suite. Display a PM message box. MV.EXE - rename files. (Manual Page Availible) NICE.EXE - run a program with modified scheduling priority. (Manual Page Availible) NL.EXE - number lines of files. (Manual Page Availible) NM.EXE - part of the EMX suite. List the name list of an a.out file. NROFF.CMD - emulate nroff command with groff OD.EXE - dump files in octal and other formats. (Manual Page Availible) PASTE.EXE - Merge lines of files. (Manual Page Availible) PATHCHK.EXE - GNU pathchk: check whether path names are valid or portable. (Manual Page Availible) PERL.EXE - Practical Extraction and Report Language. (Manual Page Availible) PFBTOPS.EXE - Translate a PostScript font in .pfg format to ASCII. (Manual Page Availible) PIC.EXE - compile pictures for troff or TeX, (Manual Page Availible) PMEMACS.EXE - Presentation Manager Front End to EMACS. POPUPPM.EXE - Part of the FeelX suite. PR.EXE - Convert a text file for printing. (Paginate - columnize). (Manual Page Availible) PRINTENV.EXE - GNU Printenv: Print all or part of the environment. (Manual Page Availible) PRINTF.EXE - GNU printf: Format and print data. (Manual Page Availible) PSBB.EXE - PostScript Bound Box - extracts bound box information from PostScript documents. (Manual Page Availible) PWD.EXE - print name of current/working directory. (Manual Page Availible) REF.EXE - Display a C function header. (Manual Page Availible) (Manual Page Availible) REFER.EXE - find and format bibliographic references. (Manual Page Availible) RM.EXE - Unix remove file utility. (Manual Page Availible) RMDIR.EXE - Unix remove directory utility. (Manual Page Availible) SDIFF.EXE - Contrast two text files by displaying them side-by-side. SED - Stream Editor. Useful as a filter. (Manual Page Availible) SIZE.EXE - Shows the size of different portions of an executable. SLEEP.EXE - GNU sleep: delay for a specified amount of time. (Manual Page Availible) SOELIM.EXE - eliminate nroff source directive from nroff input. (Manual Page Availible) SPLIT.EXE - Split a file into pieces. (Manual Page Availible) STRINGS.EXE - Print the ASCII strings out of an executable. (Manual Page Availible) STRIP.EXE - Remove debugging info from an executable. SUM.EXE - Checksum and count the blocks in a file. (Manual Page Availible) T.EXE - DOS version of the Tiney editor. Man t or read :/man/t.doc for details and license restrictions. T2.EXE - Tiny editor. TAC.EXE - Concatenate and print files in reverse. (Manual Page Availible) TAIL.EXE - Print the last few lines of a file (Manual Page Availible) TAR.EXE - Unix tape archiving program. Part of the Gtak package. TBL.EXE - Format tables for nroff. (Manual Page Availible) TEE.EXE - GNU tee: read from standard input and write to standard output and files. (Manual Page Availible) TEST.EXE - GNU test: check file types and compare values. (Manual Page Availible) TFMTODIT.EXE - Create font files for use with groff. (Manual Page Availible) TKEY.EXE - Key binding program for t2.exe. TOUCH.EXE - Unix Touch: change file timestamps. (Manual Page Availible) TR.EXE - filter: Translate or delete characters. (Manual Page Availible) TROFF.EXE - typeset or format documents. (Manual Page Availible) TTY.EXE - GNU tty: print the path of the terminal connected to standard input. (Manual Page Availible) UNAME.EXE - GNU uname: Print Operating system information. (Manual Page Availible) UNEXPAND.EXE - Convert spaces to tabs. (Manual Page Availible) UNINST10.EXE - part of the FeelX suite. Uninstaller for version 1.0 of FeelX. Older versions should be uninstalled prior to installing version 1.1a. UNINSTAL.EXE - part of the FeelX suite. Uninstaller for version 1.1a. UNIQ.EXE - remove duplicate lines from a sorted file. (Manual Page Availible) UNZIP.EXE - Infozip unzipping utility. (Manual Page Availible) UPDATEDB.CMD - Sample script for creating or updating a Locate Database. (See LOCATE.EXE) VDIR.EXE - View a directory list in Unix format. VI.EXE - Elvis: a vi text editor clone. (See ELVIS.EXE) VIEW.EXE - Elvis: read only vi editing session. (See ELVIS.EXE) WAKEUP.EXE - Prints "Wake up!" to standard out. WC.EXE - Word count: print the number of bytes, words, and lines in files. (Manual Page Availible) WHATIS.EXE - earch the whatis database for complete words. (Manual Page Availible) WHICH.EXE - locate commands and data files, and print paths. (Manual Page Availible) WHOAMI.EXE - Print effective userid. (Manual Page Availible) WO.EXE - part of the FeelX suite. A file searching utility. WPOPEN.EXE - part of the FeelX suite. Opens a PM directory window of the current directory. XARGS.EXE - Build and execute command lines from standard input. (Manual Page Availible) YES.EXE - GNU yes: Out put a string repeatedly until killed. (Manual Page Availible) YOW.EXE - Part of the Emacs distribution. ZIP.EXE - Info Zip version 2.0.1: Compatible algorithm with pkzip 2.04g. Knows about extended attributes. (Manual Page Availible) ZIPNOTE.EXE - Attach a note to a zip archive. ZIPSPLIT.EXE - Split up a zip archive into smaller ones. ZOO.EXE - Zoo archive creator.