
			    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
