WinXs Version 1.7 Copyright (C) 1996 Mick Meaden All Rights Reserved INTRODUCTION WinXs for Windows is a shareware program that provides UNIX-like tool functionality under Windows 3.1, Windows for Workgroups and Windows 95. To run WinXs, you will need a 386-based PC (or later), at least 4mb of main memory and approximately 2.0mb or 3.5mb of disk space to install the software (see below). WinXs comes in 16-bit and 32-bit versions. The 16-bit ver- sion will run on Windows 3.1, Windows for Workgroups or Win- dows 95; the 32-bit version will only run on Windows 95. The two versions are functionally identical, albeit that for integration with Explorer, or to take advantage of long filenames and pre-emptive scheduling on Windows 95, you will need to run the 32-bit version. This version also requires 3.5 mb of disk space for installation, as opposed to the 2.0mb required for the 16-bit version. CONTENTS Features of this version of WinXs include: i. Cat for Windows. Concatenates one or more files and appends them to a named output file, which is created if it does not already exist. ii. Col for Windows. Filters reverse line-feeds and vari- ous other control characters. Optionally, this filter can also be used to remove backspace sequences or to convert spaces to tabs. iii. Compress and Uncompress. Windows version of the UNIX compress(1) and uncompress(1) commands, which are use- ful when downloading files from the Internet or when transferring large files to and from UNIX systems. iv. Csplit. Splits a text file based on context. Sec- tions of a named input file can be written to dif- ferent output files or skipped based on an argument list, which consists of a series of regular expres- sions and line numbers that indicate the end of each input section. Any lines left in the input file after all arguments have been matched are written out as a single section to the last output file. v. Dos2unix and Unix2dos. Filters for converting between DOS and UNIX text file formats; that is, CR-LF (DOS) and LF (UNIX). vi. Du for Windows. A Windows implementation of the UNIX du(1) command, which recursively lists the number of blocks allocated to files and directories. vii. Expand for Windows. Performs the opposite function of col(1) and expands tabs to spaces. viii. File Compare. A set of programs that perform various file comparisons, including binary comparisons based on the UNIX cmp(1) program, directory comparisons based on dircmp(1), and differential text file com- parisons based on diff(1). ix. File for Windows. This program attempts to determine the contents of a file or files by examination of the Windows registration database, a table of magic numbers uniquely identifying file types, and finally the contents of the file itself. x. Fmt for Windows. A simple text processing utility for performing modest tasks such as formatting mail mes- sages. Text can be formatted using block, indented, crown or centered paragraphs, optionally with left and right text justification. xi. Fold for Windows. Folds lines from its input files, breaking the lines to have a maximum column width (after tab and backspace processing) or a maximum number of bytes. Optionally, lines can be broken at the last blank character within the specified column or byte width. xii. Grep for Windows. A pattern searching program that scans one or more text files for a specified character sequence. Grep uses basic regular expression pattern matching, as defined in X/Open Portability Guide Issue 4. xiii. Grex for Windows. Is a simple stream editor that sup- ports various ed(1)-like editing commands. These include text matching and substitution, text deletion, line deletion, and multi-line text insertion. xiv. Gzip and Gunzip. Provides a Windows interface to GNU gzip(1), which is a separate DOS program that can be obtained free of charge under the terms and conditions of the GNU software license (see associated help file for further details). xv. Hd for Windows. A file viewer that will display any type and size of file in hexadecimal format. Hd sup- ports the same scrolling, search and text marking com- mands as More. It also supports printing and print previewing. xvi. Head and Tail. These tools display the first, middle or last part of one or more text files. The amount of text displayed (in numbers of lines) is specified via the associated dialog. xvii. More for Windows. A file viewer that supports more(1) functionality and file movement commands. This is a full featured Windows MDI (multi-document interface) application, with print and print previewing using pr(1), basic regular expression searching, text mark- ing, configurable display and printer fonts, escapes to your favourite editor, rendering with or without line numbers, text or hexadecimal display, etc.. More supports File Manager drag and drop and will display files of any size, depending on virtual store availa- bility. xviii. Nl for Windows. A filter that allows line numbers to be added to one or more text files. Line numbers are added on the left under the control of various options, which permit line numbers to be left or right justified and padded with either spaces or zeros. Optionally, all input lines can be numbered, or numbering can be limited to non-blank lines only. xix. Pax for Windows. Provides a Windows interface for the creation, reading and writing of cpio, ustar or tar portable archives. The archive formats supported by this utility are fully compatible with the extended cpio and extended ustar archive formats defined by X/Open and POSIX. Pax can be used for local archiv- ing, or it can be used for information interchange with UNIX systems. xx. Sed for Windows. A stream editor that applies an editing script to one or more input text files, overwriting the input files with the results or con- catenating the output to a single named output file. The command syntax supported by this tool is fully compatible with the stream editor command syntax defined in ISO/IEC 9945-2: 1993, Information Technology - Portable Operating System Interface (POSIX) - Part 2: Shell and Utilities. xxi. Sort for Windows. Sorts and/or merges one or more text files, either numerically or lexicographically. Options allow the sort order to be reversed, diction- ary sorting, case folding, blanks or non-printing characters to be ignored, and duplicate lines to be omitted from the output. xxii. Split for Windows. A Windows version of the UNIX split(1) command, which breaks a file up into a speci- fied multiple of line, byte, kilobyte or megabyte pieces. This version also provides an Unsplit facil- ity for combining output files generated by a previous call to Split back into a single, large file. xxiii. Strings for Windows. This utility is commonly used on UNIX systems to search object files for copyright statements, error messages, etc.. This version will scan files of any size and content, and will option- ally display file offsets of located strings. xxiv. Tr for Windows. Substitutes, deletes or squeezes characters from its input. This is a general purpose filter that can be used for such things as converting the case of characters, deleting control characters, breaking files up into word lists, reducing multi- character sequences to single characters, etc.. xxv. Uuencode and Uudecode. Windows versions of the UNIX commands of the same name. Useful when downloading stuff from the Internet, or when using UNIX mail. xxvi. Wc for Windows. A Windows version of the UNIX wc(1) command, which counts the number of lines, words and bytes in one or more text files. xxvii. Winxsdll.dll. This DLL adds an extra menu to the Windows File Manager menu bar, allowing the above WinXs programs to be initiated directly from File Manager (see below for details). xxviii. WinXs Shell (32-bit version only). This is activated from the Folders context menu within Explorer and provides A UNIX-like directory display, plus easy access to any of the WinXs tools. The WinXs shell is also available from the context menu associ- ated with the Start button on Taskbar. The WinXs utilities can be accessed directly from File Manager, or from Explorer and the Taskbar (32-bit version only). To use More as the default text file viewer or text file print program on your system, run WinXs setup and check the appropriate configuration options (see setup help for further details). In addition, this version if WinXs also includes the follow- ing command line tools: cat, cmp, col, compress, csplit, df, diff, dircmp, dos2unix, du, expand, file, find, fmt, fold, grep, head, ls, nl, sed, sort, split, strings, tail, tr, uudecode, uuencode, unix2dos, wc. These can be used either in batch files or from the Command prompt. All WinXs commands line tools support an option -h, which causes the tool to display a brief synopsis and Usage line. INSTALLING WINXS To install WinXs on your system, do the following: 1. Create a directory to hold the installation (e.g., c:\winxs). 2. Unzip the distribution file (winxs16.zip or winxs32.zip) into the above directory. Note that the directory structure of the ZIP file should be preserved. If you are using PKUNZIP, this can be done by using the -d option as follows: pkunzip -d winxs32.zip If you are using WINZIP, ensure the Use Folder Names option is checked in the Extract dialog box. Other ZIP tools should provide a similar facility. 3. Run the WinXs setup program (SETUP.EXE), which is located in your installation directory. This will add Win&Xs to the File Manager menu bar, add the WinXs shell to Explorer context menus (32-bit version only), associate a text editor for use from File Manager and the WinXs shell, and allow configuration of other options present in this version of the product. SETUP.EXE can be re-run at any time to change these options. NOTE. If File Manager is running when setup is exe- cuted, it must be stopped and restarted before changes affecting File Manager (e.g., adding WinXs to the menu bar) can take effect. If you prefer, you can try out the WinXs tools before integrating the product with File Manager or Explorer, and before making any changes to other system files. Create a WinXs directory, as indicated above, and unzip the distribution file. DO NOT RUN THE SETUP PROGRAM. Select the WinXs directory in File Manager or Explorer, and simply double-click any of the .EXE files to try out the tools. The first screen displayed by each tool will contain a Help button; click this to display the associated manual page. The following table indicates which tools are located in which .EXE files: ______________________________________________________ | .EXE File | Tool | | | | |______________|______________________________________| | | | | DOSCONV.EXE | dos2unix(1), unix2dos(1). | | | uuencode(1), uudecode(1), | | | compress(1), uncompress(1), | | | gzip(1), gunzip(1). | | | | | FILTERS.EXE | cat(1), col(1), expand(1), | | | fold(1), fmt(1), grex(1), | | | nl(1), sort(1), tr(1). | | | | | GENUTS.EXE | cmp(1), csplit(1), diff(1), | | | du(1), file(1), grep(1), | | | head(1), sed(1), split(1), | | | strings(1), tail(1), wc(1). | | | | | HD.EXE | hd(1). | | | | | MORE.EXE | more(1), pr(1). | | | | | WINPAX.EXE | cpio(1), pax(1), tar(1). | | | | | WINXSSH.EXE | WinXs Shell (32-bit version only). | |______________|______________________________________| The SETUP.EXE program can be run at any stage to complete the installation process, or not at all. CONFIGURING THE COMMAND LINE TOOLS The WinXs command line tools are made available by adding the appropriate WinXs directory to your environment search path. This is done by adding or modifing a call to the PATH command in the autoexec.bat file. For example, PATH c:\winxs\bin;c:\windows;c:\dos This identifies three directories that will be searched automatically when entering a command at the command prompt; namely, "c:\winxs\bin", "c:\windows", and "c:\dos". The exact nature of this command will vary from system to sys- tem, so you should check your current setting before making any changes. Note that "winxs" in the above example is the name of the directory where you installed WinXs. The command line tools are located in the "bin" subdirectory below this directory. UPGRADING A PREVIOUS VERSION OF WINXS Because this release updates the WinXs DLL, it is important to ensure that File Manager IS NOT running when you upgrade. Copy the ZIP file to your WinXs directory, unzip using pkun- zip, WinZip (or equivalent) and restart File Manager. Re- run the WinXs setup program if you want to add the WinXs shell to Explorer context menus, or if you want to change any of the configuration options. UNINSTALLATION The uninstall process has been made as clean and simple as possible. Re-run the setup program and click the Uninstall button; this will undo all changes made to system files and remove any WinXs .ini files from your Windows directory. To complete the uninstall process, manually delete the WinXs installation directory and all its contents. WINDOWS 95 This version of WinXs can be installed on Windows 95 as indicated above. Optionally, the setup program will add the WinXs tools to the Windows 95 File Manager menu bar, and the WinXs Shell to Folder and Document context menus in Explorer (32-bit version only). It is also recommended that the default text file viewer in the Windows Registry is changed to use the more.exe tool supplied with this package (see setup help for details). REGISTRATION WinXs is a shareware program. It can be used for a period of up to 21 days free of charge, after which it must be removed from your system or a license fee of 18 dollars U.S. (12 pounds Sterling) must be paid. Details of how to regis- ter are given in the files LICENSE.TXT and REGISTER.TXT, both of which are distributed with the product. Benefits of registration include: + Free product upgrades. + A key code which unlocks the following additional func- tionality: - Options can be saved from more. This includes font selections, tab settings, editor preference, and window position. The last of these, window position, also affects the hd utility. - Utilities that accept multiple input file names or patterns work correctly without displaying a nag screen, including cat, col, compress, dos2unix, expand, fmt, fold, grep, grex, gzip, gunzip, nl, pax, sed, strings, tail, tr, uncompress, unix2dos, wc and winxssh. + A copy of the WinXs User Reference Manual will be sent by email. This document is distributed in Microsoft Word format and is the definitive guide to using the various WinXs utilities. WinXs can be registered in a number of ways, the quickest and most convenient of which is via the CompuServe Shareware Registration Database (GO SWREG). The registration ID for WinXs is 7400. Alternatively, it can be registered by using the order form in file REGISTER.TXT. REPORTING PROBLEMS Please email comments and/or bug reports to: 100345.2641@compuserve.com