RELEASE-NOTES
=============

Name:	     pep, ver. 2.8
Author:      Gisle Hannemyr, Oslo, Norway
E-mail:      gisle@hannemyr.no
Purpose:     Detergent for "dirty" files
Language:    ANSI C
Environment: Fairly generic (MS-DOS, UNIX, VMS)
Files:	     Root directory:
		aareadme.txt -- this file
		Makefile     -- script to compile, etc.
		ansi.c	     -- ansi terminal interpreter
		bdmg.c	     -- DUCOS brain damage compensation
		main.c	     -- root module
		plain.src    -- standard filters (renamed to plain.c)
		bdmg.h	     -- bdmg.c types and functions
		pep.h	     -- types and functions for pep
		pep.exe	     -- MS-DOS - executable
             Doc:
		header.txt   -- advice about portability of pep
		pep.man	     -- manual page (nroff source)
		pep.txt	     -- formatted version of pep.man.
	        hjelp.txt    -- examples & answers to FAQs (norwegian)
		copying.txt  -- the Gnu Public License
	     Filters:
		mac2iso	     -- conv.-table Mac to ISO 8859/1
		iso2mac	     -- vice versa
		ibm2iso	     -- conv.-table CP 850 to ISO 8859/1
		iso2ibm	     -- vice versa
		mac2ibm	     -- sample conversion table
		ibm2mac	     -- vice versa
		ibm2ro8	     -- conv.-table IBM-PC to ROMAN8
		ro82ibm	     -- vice versa
		ebc2ns7	     -- conv.-table EBCDIC to NS 4551
		iso2as7	     -- conv.-table ISO 8859/1 to ASCII (IRV).
		iso2ns7	     -- conv.-table ISO 8859/1 to NS 4551
		nxt2ns7	     -- conv.-table NeXT to NS 4551

Description:
   Pep is a general purpose filter and file cleaning program.
   It is named after an excellent Norwegian detergent.	Pep may
   be used to expand/compress tabs; convert to and from several
   character sets; to interprete ANSI escape sequences; and to
   remove unwanted line noise from files.  See the file pep.doc
   for a complete description.


Installation:
   The steps required to compile and install pep are:

   First, unpack the archive.  Un Unix, you can use unzip, on
   Windows you can winzip, and on MS-DOS pkunzip.  You should
   supply the -d option to pkunzip to get the directory structure 
   estored.

   One executable file (pep.exe) for MS-DOS systems is included
   in the distribution archive. If you are able to use this, you
   may skip the compilation.

   If you want to install pep on another operating system, you must
   first compile it.  A Makefile is supplied, and even if you don't
   have make, it may be a good idea to read this for directions.
   Pep is fairly generic and should compile with almost any ANSI C
   compiler after very little tweaking.  Read the file "header.txt"
   for advise about what pep expect to find in the header files.

   If you want to recompile pep for your system, start out by editing
   the Makefile.  The first part of the Makefile is a "customization
   section".  First, you should indicate your choice of platform
   (compiler and operating system).  Delete or comment out those that
   do not apply.  If you are on a Unix system, you also may want to
   edit the the symbols giving the names of the destination directories
   and indicate appropriate manpage section:

   - BINDIR	= in which directory do you want the executable?
   - LIBDIR	= in which directory do you want to have the filters?
   - MANEXT	= which section of the manual shall the manpage go?
   - MANDIR	= in which directory do you want the manpage installed?

   The Makefile will use sed to put some of these into plain.src
   (making plain.c) and pep.man (changing the name to indicate the
   appropriate section of the manual).  If you are on a MS-DOS syste,
   you won't have sed on your system.  In that case, edit the
   defintion of the symbol LIBY at the beginning of file plain.src
   yourself, and rename plain.src to plain.c.  (If you are unsure
   about how to do this, just rename plain.src to plain.c, and
   the system should still compile).

   To recompile on any system just do "make".

   On a Unix system, you may instead do a "make install", to compile
   and install pep on your system.


Operating system notes:
   Below is some notes on points pertaining to the different operating
   systems:

   * MS-DOS systems:
     Install PEP.EXE in a directory that is defined in your PATH
     environment variable, and define an environment variable PEP
     pointing to the directory where the conversion filters are
     installed.	 If this is "c:\usr\lib" your startup profile
     AUTOEXEC.BAT should contain a line like this:

	set PEP=c:\usr\lib

     Alternatively, you may put the conversion tables in the same
     directory as you put the executables.  If you use this alternative,
     it is not necessary to define the PEP environment variable.

     Or you may put the conversion tables in the directory indicated by
     the symbol LIBY (defined in plain.c).  You can use the -g option
     to find out where pep searches for these tables.

   * UNIX systems:
     Install the executable file pep in a directory that is defined
     in your PATH environment variable (a canonical place will be
     /local/bin).  Install the conversion table in a directory of
     your choice (a canonical place will be /local/share/lib).
     Make sure that LIBDIR in the Makefile is set to this directory.

     If you also want pep to search another area for conversion
     tables, define an environment variable PEP pointing to the
     directory where the conversion filters are installed.  If this
     is "/home/george/lib" your startup profile (.login on BSD
     systems, .profile on SYS-V) should contain a line like this:

	setenv PEP /home/george/lib

     Also, Unix users may want to install the manpage "pep.1" in the
     online manual.  The canonical placement is /usr/man/manl.

   * VMS systems:
     Pep need to be installed as a "foreign command", and you need
     to define a symbol pointing to the conversion filters.  If both
     the executable file and the filters is placed in directory named
     "disk_daf:<d_progbib.vms>", you need to have the following two
     lines in your startup profile LOGIN.COM.

	$ pep :== $disk_daf:<d_progbib.vms>pep
	$ define PEP "disk_daf:<d_progbib.vms>"

     Also note that VMS does not support pipes and redirection, and
     it is therefore awkward to use pep as a filter under VMS.	The
     distributed version does not even try to run as a filter under
     VMS, it has the -o option (write output back on file named as
     input file) permanently enabled.


Version 2.8, news:
   * Fixed '%' inserted for leading space in ver. 2.7.

Version 2.7, news:
   * Moved on to ANSI C.

Version 2.6, news:
   * Improved handling of CR SP SP SP LF constructs.

Version 2.5, news:
   * search built in direcrory for filter files for -g option
   * target "install" added to makefile
   * moved the examples from the manpage into hjelp.txt

Version 2.4, news:
   * -l option to split long lines

..EOF
