README revision 161475
139217Sgibbs 239217Sgibbs Less, version 394 339217Sgibbs 439217Sgibbs This is the distribution of less, version 394, released 03 Dec 2005. 539217Sgibbs This program is part of the GNU project (http://www.gnu.org). 639217Sgibbs 739217Sgibbs This program is free software. You may redistribute it and/or 839217Sgibbs modify it under the terms of either: 939217Sgibbs 1039217Sgibbs 1. The GNU General Public License, as published by the Free 1139217Sgibbs Software Foundation; either version 2, or (at your option) any 1239217Sgibbs later version. A copy of this license is in the file COPYING. 1339217Sgibbs or 1439217Sgibbs 2. The Less License, in the file LICENSE. 1539217Sgibbs 1639217Sgibbs Please report any problems to bug-less@gnu.org or markn@greenwoodsoftware.com. 1739217Sgibbs See http://www.greenwoodsoftware.com/less for the latest info. 1839217Sgibbs You may also contact the author at: 1939217Sgibbs Mark Nudelman 2039217Sgibbs Greenwood Software 2139217Sgibbs PO Box 2402 2239217Sgibbs El Granada, CA 94018 2339217Sgibbs USA 2439217Sgibbs 2539217Sgibbs========================================================================= 2639217Sgibbs 2739217SgibbsThis is the distribution of "less", a paginator similar to "more" or "pg". 2839217Sgibbs 2939217SgibbsThe formatted manual page is in less.man. 3039217SgibbsThe manual page nroff source is in less.nro. 3139217SgibbsMajor changes made since the last posted version are in NEWS. 3239217Sgibbs 3339217Sgibbs======================================================================= 3439217SgibbsINSTALLATION (Unix systems only): 3539217Sgibbs 3639217Sgibbs1. Move the distributed source to its own directory and unpack it, 3739217Sgibbs if you have not already done so. 3839217Sgibbs 3939217Sgibbs2. Type "sh configure". 4039217Sgibbs This will generate a Makefile and a defines.h. 4139217Sgibbs Warning: if you have a GNU sed, make sure it is version 2.05 or later. 4239217Sgibbs 4339217Sgibbs The file INSTALL describes the usage of the configure program in 4439217Sgibbs general. In addition, these options to configure are supported: 4539217Sgibbs 4639217Sgibbs --with-editor=program 4739217Sgibbs Specifies the default editor program used by the "v" command. 4839217Sgibbs The default is "vi". 4939217Sgibbs --with-regex=lib 5042012Sgibbs Specifies the regular expression library used by less for pattern 5139217Sgibbs matching. The default is "auto", which means the configure program 5239217Sgibbs finds a regular expression library automatically. Other values are: 5339217Sgibbs posix Use the POSIX-compatible regcomp. 5439217Sgibbs pcre Use the PCRE library. 5539217Sgibbs regcmp Use the regcmp library. 5639217Sgibbs re_comp Use the re_comp library. 5739217Sgibbs regcomp Use the V8-compatible regcomp. 5839217Sgibbs regcomp-local Use Henry Spencer's V8-compatible regcomp 5939217Sgibbs (source is supplied with less). 6039217Sgibbs --with-secure 6139217Sgibbs Builds a "secure" version of less, with some features disabled 6239217Sgibbs to prevent users from viewing other files, accessing shell 6339217Sgibbs commands, etc. 6439217Sgibbs 6539217Sgibbs3. It is a good idea to look over the generated Makefile and defines.h 6639217Sgibbs and make sure they look ok. If you know of any peculiarities of 6739217Sgibbs your system that configure might not have detected, you may fix the 6839217Sgibbs Makefile now. Take particular notice of the list of "terminal" 6939217Sgibbs libraries in the LIBS definition in the Makefile; these may need 7039217Sgibbs to be edited. The terminal libraries will be some subset of 7139217Sgibbs -lncurses -lcurses -ltermcap -ltermlib 7239217Sgibbs 7339217Sgibbs If you wish, you may edit defines.h to remove some optional features. 7439217Sgibbs If you choose not to include some features in your version, you may 7539217Sgibbs wish to edit the manual page "less.nro" and the help page "less.hlp" 7639217Sgibbs to remove the descriptions of the features which you are removing. 7739217Sgibbs If you edit less.hlp, you should run "make -f Makefile.aut help.c". 7839217Sgibbs 7941771Sdillon4. Type "make" and watch the fun. 8039217Sgibbs 8139217Sgibbs5. If the make succeeds, it will generate the programs "less", 8239217Sgibbs "lesskey" and "lessecho" in your current directory. Test the 8339217Sgibbs generated programs. 8439217Sgibbs 8539217Sgibbs6. When satisfied that it works, if you wish to install it 8642012Sgibbs in a public place, type "make install". 8742012Sgibbs 8842012Sgibbs The default install destinations are: 8939217Sgibbs Executables (less, lesskey, lessecho) in /usr/local/bin 9039217Sgibbs Documentation (less.nro, lesskey.nro) in /usr/local/man/man1 9139217Sgibbs If you want to install any of these files elsewhere, define 9239217Sgibbs bindir and/or mandir to the appropriate directories. 9339217Sgibbs 9439217SgibbsIf you have any problems building or running "less", suggestions, 9539217Sgibbscomplaints, etc., you may mail to the author at markn@greenwoodsoftware.com. 9639217Sgibbs 9739217SgibbsNote to hackers: comments noting possible improvements are enclosed 9839217Sgibbsin double curly brackets {{ like this }}. 9939217Sgibbs 10041771Sdillon 10139217Sgibbs 10239217Sgibbs======================================================================= 10339217SgibbsINSTALLATION (MS-DOS systems only, 10439217Sgibbs with Microsoft C, Borland C, or DJGPP) 10539217Sgibbs 10639217Sgibbs1. Move the distributed source to its own directory. 10739217Sgibbs Depending on your compiler, you may need to convert the source 10839217Sgibbs to have CR-LF rather than LF as line terminators. 10939217Sgibbs 11039217Sgibbs2. If you are using Microsoft C, rename MAKEFILE.DSU to MAKEFILE. 11139217Sgibbs If you are using Borland C, rename MAKEFILE.DSB to MAKEFILE. 11239217Sgibbs If you are using DJGPP, rename MAKEFILE.DSG to MAKEFILE. 11339217Sgibbs 11439217Sgibbs3. Look at MAKEFILE to make sure that the definitions for CC and LIBDIR 11539217Sgibbs are correct. CC should be the name of your C compiler and 11639217Sgibbs LIBDIR should be the directory where the C libraries reside (for 11739217Sgibbs Microsoft C only). If these definitions need to be changed, you can 11839217Sgibbs either modify the definitions directly in MAKEFILE, or set your 11939217Sgibbs environment variables CC and/or LIBDIR to override the definitions 12039217Sgibbs in MAKEFILE. 12139217Sgibbs 12239217Sgibbs4. If you wish, you may edit DEFINES.DS to remove some optional features. 12339217Sgibbs If you choose not to include some features in your version, you may 12439217Sgibbs wish to edit the manual page LESS.MAN and the help page HELP.C 12539217Sgibbs to remove the descriptions of the features which you are removing. 12639217Sgibbs 12739217Sgibbs5. Run your "make" program and watch the fun. 12839217Sgibbs If your "make" requires a flag to import environment variables, 12939217Sgibbs you should use that flag. 13039217Sgibbs If your compiler runs out of memory, try running "make -n >cmds.bat" 13139217Sgibbs and then run cmds.bat. 13239217Sgibbs 13339217Sgibbs6. If the make succeeds, it will generate the programs "LESS.EXE" and 13439217Sgibbs "LESSKEY.EXE" in your current directory. Test the generated programs. 13539217Sgibbs 13639217Sgibbs7. When satisfied that it works, you may wish to install LESS.EXE and 13739217Sgibbs LESSKEY.EXE in a directory which is included in your PATH. 13839217Sgibbs 13939217Sgibbs 14039217Sgibbs 14139217Sgibbs======================================================================= 14239217SgibbsINSTALLATION (Windows-95, Windows-98 and Windows-NT systems only, 14339217Sgibbs with Borland C or Microsoft Visual C++) 14439217Sgibbs 14539217Sgibbs1. Move the distributed source to its own directory. 14639217Sgibbs 14739217Sgibbs2. If you are using Borland C, rename Makefile.wnb to Makefile. 14839217Sgibbs If you are using Microsoft Visual C++, rename Makefile.wnm to Makefile. 14939217Sgibbs 15039217Sgibbs3. Check the Makefile to make sure the definitions look ok. 15139217Sgibbs 15239217Sgibbs4. If you wish, you may edit defines.wn to remove some optional features. 15339217Sgibbs If you choose not to include some features in your version, you may 15439217Sgibbs wish to edit the manual page less.man and the help page help.c 15539217Sgibbs to remove the descriptions of the features which you are removing. 15639217Sgibbs 15739217Sgibbs5. Type "make" and watch the fun. 15839217Sgibbs 15939217Sgibbs6. If the make succeeds, it will generate the programs "less.exe" and 16039217Sgibbs "lesskey.exe" in your current directory. Test the generated programs. 16139217Sgibbs 16239217Sgibbs7. When satisfied that it works, if you wish to install it 16339217Sgibbs in a public place, type "make install". 16439217Sgibbs See step 6 of the Unix installation instructions for details 16539217Sgibbs on how to change the default installation directories. 16639217Sgibbs 16739217Sgibbs 16839217Sgibbs 16939217Sgibbs======================================================================= 17039217SgibbsINSTALLATION (OS/2 systems only, 17139217Sgibbs with EMX C) 17239217Sgibbs 17339217Sgibbs1. Move the distributed source to its own directory. 17439217Sgibbs 17539217Sgibbs2. Rename Makefile.o2e to Makefile. 17639217Sgibbs 17739217Sgibbs3. Check the Makefile to make sure the definitions look ok. 17839217Sgibbs 17939217Sgibbs4. If you wish, you may edit defines.o2 to remove some optional features. 18039217Sgibbs If you choose not to include some features in your version, you may 18139217Sgibbs wish to edit the manual page less.man and the help page help.c 18239217Sgibbs to remove the descriptions of the features which you are removing. 18339217Sgibbs 18439217Sgibbs5. Type "make" and watch the fun. 18539217Sgibbs 18639217Sgibbs6. If the make succeeds, it will generate the programs "less.exe" and 18739217Sgibbs "lesskey.exe" in your current directory. Test the generated programs. 18839217Sgibbs 18939217Sgibbs7. Make sure you have the emx runtime installed. You need the emx DLLs 19039217Sgibbs emx.dll and emxlibcs.dll and also the termcap database, termcap.dat. 19139217Sgibbs Make sure you have termcap.dat either in the default location or 19239217Sgibbs somewhere in a directory listed in the PATH or INIT environment 19339217Sgibbs variables. 19439217Sgibbs 19539217Sgibbs8. When satisfied that it works, you may wish to install less.exe, 19639217Sgibbs lesskey.exe and scrsize.exe in a directory which is included in 19739217Sgibbs your PATH. scrsize.exe is required only if you use a terminal 19839217Sgibbs emulator such as xterm or rxvt. 19939217Sgibbs 20039217Sgibbs 20139217Sgibbs 20239217Sgibbs======================================================================= 20339217SgibbsINSTALLATION (OS-9 systems only, 20439217Sgibbs with Microware C or Ultra C) 20539217Sgibbs 20639217Sgibbs1. Move the distributed source to its own directory. 20739217Sgibbs 20839217Sgibbs2. If you are using Microware C, rename Makefile.o9c to Makefile. 20939217Sgibbs If you are using Ultra C, rename Makefile.o9u to Makefile. 21039217Sgibbs 21139217Sgibbs3. Check the Makefile to make sure the definitions look ok. 21239217Sgibbs 21339217Sgibbs4. If you wish, you may edit defines.o9 to remove some optional features. 21439217Sgibbs If you choose not to include some features in your version, you may 21539217Sgibbs wish to edit the manual page less.man and the help page help.c 21639217Sgibbs to remove the descriptions of the features which you are removing. 21739217Sgibbs 21839217Sgibbs5. Type "dmake" and watch the fun. 21939217Sgibbs The standard OS-9 "make" will probably not work. If you don't 22039217Sgibbs have dmake, you can get a copy from os9archive.rtsi.com. 22139217Sgibbs 22239217Sgibbs6. If the make succeeds, it will generate the programs "less" and 22339217Sgibbs "lesskey" in your current directory. Test the generated programs. 22439217Sgibbs 22539217Sgibbs7. When satisfied that it works, if you wish to install it 22639217Sgibbs in a public place, type "dmake install". 22739217Sgibbs See step 6 of the Unix installation instructions for details 22839217Sgibbs on how to change the default installation directories. 22939217Sgibbs 23039217Sgibbs======================================================================= 23139217SgibbsACKNOWLEDGMENTS: 23239217Sgibbs Some versions of the less distribution are packaged using 23339217Sgibbs Info-ZIP's compression utility. 23439217Sgibbs Info-ZIP's software is free and can be obtained as source 23539217Sgibbs code or executables from various anonymous-ftp sites, 23639217Sgibbs including ftp.uu.net:/pub/archiving/zip. 23739217Sgibbs