[BACK]Return to README CVS log [TXT][DIR] Up to [local] / src / usr.bin / less

Diff for /src/usr.bin/less/Attic/README between version 1.1 and 1.2

version 1.1, 1996/09/21 05:39:44 version 1.2, 2007/04/19 05:56:45
Line 1 
Line 1 
 =======================================================================  
 ===        NOTE: THIS IS A DISTRIBUTION OF less (version 290)       ===  
 ===    PLEASE REPORT ANY PROBLEMS TO THE AUTHOR AT markn@3do.com.   ===  
 =======================================================================  
   
                               Less, version 382
   
       This is the distribution of less, version 382, released 03 Feb 2004.
       This program is part of the GNU project (http://www.gnu.org).
   
       This program is free software.  You may redistribute it and/or
       modify it under the terms of either:
   
       1. The GNU General Public License, as published by the Free
          Software Foundation; either version 2, or (at your option) any
          later version.  A copy of this license is in the file COPYING.
       or
       2. The Less License, in the file LICENSE.
   
       Please report any problems to bug-less@gnu.org or markn@greenwoodsoftware.com.
       See http://www.greenwoodsoftware.com/less for the latest info.
       You may also contact the author at:
             Mark Nudelman
             Greenwood Software
             PO Box 2402
             El Granada, CA  94018
             USA
   
   =========================================================================
   
 This is the distribution of "less", a paginator similar to "more" or "pg".  This is the distribution of "less", a paginator similar to "more" or "pg".
   
 The formatted manual page is in less.man.  The formatted manual page is in less.man.
 The manual page nroff source is in less.nro.  The manual page nroff source is in less.nro.
 Major changes made since the last posted version are in NEWS.  Major changes made since the last posted version are in NEWS.
Line 11 
Line 33 
 =======================================================================  =======================================================================
 INSTALLATION (Unix systems only):  INSTALLATION (Unix systems only):
   
 1. Move the distributed source to its own directory and  1. Move the distributed source to its own directory and unpack it,
    unpack it by running "sh" or "unshar" on the distribution     if you have not already done so.
    files, if you have not already done so.  
   
 2. Type "sh configure".  2. Type "sh configure".
    This will generate a Makefile and a defines.h.     This will generate a Makefile and a defines.h.
    Warning: if you have a GNU sed, make sure it is version 2.05 or later.     Warning: if you have a GNU sed, make sure it is version 2.05 or later.
   
      The file INSTALL describes the usage of the configure program in
      general.  In addition, these options to configure are supported:
   
      --with-editor=program
        Specifies the default editor program used by the "v" command.
        The default is "vi".
      --with-regex=lib
        Specifies the regular expression library used by less for pattern
        matching.  The default is "auto", which means the configure program
        finds a regular expression library automatically.  Other values are:
           posix          Use the POSIX-compatible regcomp.
           pcre           Use the PCRE library.
           regcmp         Use the regcmp library.
           re_comp        Use the re_comp library.
           regcomp        Use the V8-compatible regcomp.
           regcomp-local  Use Henry Spencer's V8-compatible regcomp
                          (source is supplied with less).
   
 3. It is a good idea to look over the generated Makefile and defines.h  3. It is a good idea to look over the generated Makefile and defines.h
    and make sure they look ok.  If you know of any peculiarities of     and make sure they look ok.  If you know of any peculiarities of
    your system that configure might not have detected, you may fix the     your system that configure might not have detected, you may fix the
    Makefile now.     Makefile now.  Take particular notice of the list of "terminal"
      libraries in the LIBS definition in the Makefile; these may need
      to be edited.  The terminal libraries will be some subset of
          -lncurses  -lcurses  -ltermcap  -ltermlib
   
    If you wish, you may edit defines.h to remove some optional features.     If you wish, you may edit defines.h to remove some optional features.
    If you wish to build a "secure" version of less (which disables all     If you wish to build a "secure" version of less (which disables all
Line 31 
Line 73 
    If you choose not to include some features in your version, you may     If you choose not to include some features in your version, you may
    wish to edit the manual page "less.nro" and the help page "less.hlp"     wish to edit the manual page "less.nro" and the help page "less.hlp"
    to remove the descriptions of the features which you are removing.     to remove the descriptions of the features which you are removing.
      If you edit less.hlp, you should run "make -f Makefile.aut help.c".
   
 4. Type "make" and watch the fun.  4. Type "make" and watch the fun.
   
    If you want less to find the help file in a directory other than  5. If the make succeeds, it will generate the programs "less",
    the default (/usr/local/share), define "datadir" to that directory.     "lesskey" and "lessecho" in your current directory.  Test the
    For example: "make datadir=/usr/local/helpfiles"     generated programs.
   
 5. If the make succeeds, it will generate a program "less"  
    in your current directory.  Test the generated program.  
   
 6. When satisfied that it works, if you wish to install it  6. When satisfied that it works, if you wish to install it
    in a public place, type "make install".     in a public place, type "make install".
   
    The default install destinations are:     The default install destinations are:
         Executables (less, lesskey) in /usr/local/bin          Executables (less, lesskey, lessecho) in /usr/local/bin
         Data files (less.hlp) in /usr/local/share          Documentation (less.nro, lesskey.nro) in /usr/local/man/man1
         Documentation (less.nro, lesskey.nro) in /usr/local/man/man1  
    If you want to install any of these files elsewhere, define     If you want to install any of these files elsewhere, define
    bindir, datadir, and/or mandir to the appropriate directories.     bindir and/or mandir to the appropriate directories.
    datadir must be defined the same as in step 4.  
   
 If you have any problems building or running "less", suggestions,  If you have any problems building or running "less", suggestions,
 complaints, etc., you may mail to the author at markn@3do.com  complaints, etc., you may mail to the author at markn@greenwoodsoftware.com.
   
 Note to hackers: comments noting possible improvements are enclosed  Note to hackers: comments noting possible improvements are enclosed
 in double curly brackets {{ like this }}.  in double curly brackets {{ like this }}.
Line 61 
Line 99 
   
   
 =======================================================================  =======================================================================
 INSTALLATION (MS-DOS systems only)  INSTALLATION (MS-DOS systems only,
                 with Microsoft C, Borland C, or DJGPP)
   
 1. Move the distributed source to its own directory.  1. Move the distributed source to its own directory.
    Make sure the source has been converted to have CR-LF rather than     Depending on your compiler, you may need to convert the source
    LF as line terminators.     to have CR-LF rather than LF as line terminators.
   
 2. Rename MAKEFILE.DOS to MAKEFILE.  2. If you are using Microsoft C, rename MAKEFILE.DSU to MAKEFILE.
      If you are using Borland C, rename MAKEFILE.DSB to MAKEFILE.
      If you are using DJGPP, rename MAKEFILE.DSG to MAKEFILE.
   
 3. Look at MAKEFILE to make sure that the definitions for CC and LIBDIR  3. Look at MAKEFILE to make sure that the definitions for CC and LIBDIR
    are correct.  CC should be the name of your Microsoft C compiler and     are correct.  CC should be the name of your C compiler and
    LIBDIR should be the directory where the Microsoft C libraries     LIBDIR should be the directory where the C libraries reside (for
    reside.  If these definitions need to be changed, you can either     Microsoft C only).  If these definitions need to be changed, you can
    modify the definitions directly in MAKEFILE, or set your environment     either modify the definitions directly in MAKEFILE, or set your
    variables CC and/or LIBDIR to override the definitions in MAKEFILE.     environment variables CC and/or LIBDIR to override the definitions
      in MAKEFILE.
   
 4. If you wish, you may edit DEFINES.DOS to remove some optional features.  4. If you wish, you may edit DEFINES.DS to remove some optional features.
    If you choose not to include some features in your version, you may     If you choose not to include some features in your version, you may
    wish to edit the manual page LESS.MAN and the help page LESS.HLP     wish to edit the manual page LESS.MAN and the help page HELP.C
    to remove the descriptions of the features which you are removing.     to remove the descriptions of the features which you are removing.
   
 5. Type "make" and watch the fun.  5. Run your "make" program and watch the fun.
    You may need to invoke "make -e", if your "make" requires the -e     If your "make" requires a flag to import environment variables,
    flag to import environment variables.     you should use that flag.
    If your compiler runs out of memory, try running "make -n >cmds.bat"     If your compiler runs out of memory, try running "make -n >cmds.bat"
    and then run cmds.bat.     and then run cmds.bat.
   
 6. If the make succeeds, it will generate a program "LESS.EXE"  6. If the make succeeds, it will generate the programs "LESS.EXE" and
    in your current directory.  Test the generated program.     "LESSKEY.EXE" in your current directory.  Test the generated programs.
   
 7. When satisfied that it works, you may wish to install LESS.EXE,  7. When satisfied that it works, you may wish to install LESS.EXE and
    LESSKEY.EXE and LESS.HLP in a directory which is included in     LESSKEY.EXE in a directory which is included in your PATH.
    your PATH.  
   
   
   
 =======================================================================  =======================================================================
 INSTALLATION (OS/2 systems only)  INSTALLATION (Windows-95, Windows-98 and Windows-NT systems only,
                 with Borland C or Microsoft Visual C++)
   
 1. Move the distributed source to its own directory.  1. Move the distributed source to its own directory.
   
 2. Rename Makefile.os2 to Makefile.  2. If you are using Borland C, rename Makefile.wnb to Makefile.
      If you are using Microsoft Visual C++, rename Makefile.wnm to Makefile.
   
 3. Check the Makefile to make sure the definitions look ok.  3. Check the Makefile to make sure the definitions look ok.
   
 4. If you wish, you may edit defines.os2 to remove some optional features.  4. If you wish, you may edit defines.wn to remove some optional features.
    If you choose not to include some features in your version, you may     If you choose not to include some features in your version, you may
    wish to edit the manual page less.man and the help page less.hlp     wish to edit the manual page less.man and the help page help.c
    to remove the descriptions of the features which you are removing.     to remove the descriptions of the features which you are removing.
   
 5. Type "make" and watch the fun.  5. Type "make" and watch the fun.
   
 6. If the make succeeds, it will generate a program "less.exe"  6. If the make succeeds, it will generate the programs "less.exe" and
    in your current directory.  Test the generated program.     "lesskey.exe" in your current directory.  Test the generated programs.
   
   7. When satisfied that it works, if you wish to install it
      in a public place, type "make install".
      See step 6 of the Unix installation instructions for details
      on how to change the default installation directories.
   
   
   
   =======================================================================
   INSTALLATION (OS/2 systems only,
                 with EMX C)
   
   1. Move the distributed source to its own directory.
   
   2. Rename Makefile.o2e to Makefile.
   
   3. Check the Makefile to make sure the definitions look ok.
   
   4. If you wish, you may edit defines.o2 to remove some optional features.
      If you choose not to include some features in your version, you may
      wish to edit the manual page less.man and the help page help.c
      to remove the descriptions of the features which you are removing.
   
   5. Type "make" and watch the fun.
   
   6. If the make succeeds, it will generate the programs "less.exe" and
      "lesskey.exe" in your current directory.  Test the generated programs.
   
 7. Make sure you have the emx runtime installed. You need the emx DLLs  7. Make sure you have the emx runtime installed. You need the emx DLLs
    emx.dll and emxlibcs.dll and also the termcap database, termcap.dat.     emx.dll and emxlibcs.dll and also the termcap database, termcap.dat.
    Make sure you have termcap.dat either in the default location or     Make sure you have termcap.dat either in the default location or
Line 122 
Line 192 
    variables.     variables.
   
 8. When satisfied that it works, you may wish to install less.exe,  8. When satisfied that it works, you may wish to install less.exe,
    lesskey.exe and less.hlp in a directory which is included in     lesskey.exe and scrsize.exe in a directory which is included in
    your PATH.     your PATH.  scrsize.exe is required only if you use a terminal
      emulator such as xterm or rxvt.
   
   
   
   =======================================================================
   INSTALLATION (OS-9 systems only,
                 with Microware C or Ultra C)
   
   1. Move the distributed source to its own directory.
   
   2. If you are using Microware C, rename Makefile.o9c to Makefile.
      If you are using Ultra C, rename Makefile.o9u to Makefile.
   
   3. Check the Makefile to make sure the definitions look ok.
   
   4. If you wish, you may edit defines.o9 to remove some optional features.
      If you choose not to include some features in your version, you may
      wish to edit the manual page less.man and the help page help.c
      to remove the descriptions of the features which you are removing.
   
   5. Type "dmake" and watch the fun.
      The standard OS-9 "make" will probably not work.  If you don't
      have dmake, you can get a copy from os9archive.rtsi.com.
   
   6. If the make succeeds, it will generate the programs "less" and
      "lesskey" in your current directory.  Test the generated programs.
   
   7. When satisfied that it works, if you wish to install it
      in a public place, type "dmake install".
      See step 6 of the Unix installation instructions for details
      on how to change the default installation directories.
   
   =======================================================================
   ACKNOWLEDGMENTS:
     Some versions of the less distribution are packaged using
     Info-ZIP's compression utility.
     Info-ZIP's software is free and can be obtained as source
     code or executables from various anonymous-ftp sites,
     including ftp.uu.net:/pub/archiving/zip.
Legend:
Removed from v.1.1  
changed lines
  Added in v.1.2