less/README at master · laputa-systems/less · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
This is the source code distribution of "less".
This program is part of the GNU project (https://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 3, or (at your option) any later version.
   A copy of this license is in the file COPYING.
2. The Less License, in the file LICENSE.

Please report problems at https://github.com/gwsw/less/issues.
See https://greenwoodsoftware.com/less for current project information.
The source repository is at https://github.com/gwsw/less.git.

Less now ships a checked-in build for macOS and Linux only. It does not
use autoconf, configure, curses, terminfo, termcap, PCRE, or the local
V8 regex implementation. Pattern matching uses POSIX regcomp from libc,
and terminal control uses a small built-in xterm-compatible capability
table. Terminal capability overrides are still available with
LESS_TERMINFO_* and LESS_TERMCAP_* environment variables.

The manual page nroff source is generated from less.nro.VER by make.
Major changes made since the last posted version are in NEWS.

INSTALLATION

Install a C compiler and make, then run:

    make

This builds the program "less" in the current directory.

To run the test suite:

    make check

To install:

    make install

The default install destinations are:

    less:        /usr/local/bin
    OSC8 hook:   /usr/local/libexec
    manual page: /usr/local/man/man1

You may override standard make variables:

    make CC=clang CFLAGS='-O2 -g'
    make prefix=/opt/less
    make DESTDIR=/tmp/pkgroot install

Supported overrides include CC, CFLAGS, CPPFLAGS, LDFLAGS, prefix,
bindir, mandir, DESTDIR, SAN=1, LESSTEST=1, and SECURE_COMPILE=1.

SECURE_COMPILE=1 builds a secure version of less with features such as
shell escapes, editor invocation, file examination, and log files
disabled at compile time. Filename globbing is disabled in this minimal
build because lessecho is not built or installed by default.