lv: a Powerful Multilingual File Viewer
SYNOPSIS
lv, lgrep
lv -h
lv -V
lv [-[+]acdfgiklmnqsuvz]
[-Acoding-system] [-Icoding-system] [-Kcoding-system]
[-Ocoding-system] [-Pcoding-system] [-Dcoding-system]
[-Ssseq] [-Srseq] [-Sbseq] [-Suseq] [-Shseq]
[-Tnumber] [-Wwidth] [-Hheight] [-E'editor'] [-+]
[-] (grep pattern) [files ...]
DESCRIPTION
Multilingual file viewer
lv is a powerful multilingual file viewer. Appar
ently, lv looks like less (1), a representative
file viewer on UNIX as you know, so UNIX people
(and less people on other OSs) don't have to learn
a burdensome new interface. lv can be used on
MSDOS ANSI terminals and almost all UNIX platforms.
lv is a currently growing software, so your feed
back is welcome and helpful for us to refine the
future lv.
Multiple coding systems
lv can decode and encode multilingual streams
through many coding systems, for example, ISO 2022
based coding systems such as iso-2022-jp, and EUC
(Extended Unix Code) like euc-japan. Furthermore,
localized coding systems such as shift-jis, big5
and HZ are also supported. lv can be used not only
as a file viewer but also as a coding-system trans
lation filter like nkf (1) and tcs (1).
Multilingual regular expressions / Multilingual grep
lv can recognize multi-bytes patterns as regular
expressions, and lv also provides multilingual grep
(1) functionality by giving it another name, lgrep.
Pattern matching is conducted in the charset level,
so an EUC fragment, for example, can be found in
the ISO 2022 tailored streams, of course.
Supporting the Unicode standard
lv provides Unicode facilities which enables you to
handle Unicode streams encoded in UTF-7 or UTF-8,
and lv can also convert their code-points between
Unicode and other charsets. So you can display
Unicode or foreign texts on your terminal, using
the code conversion function to your favorite
charsets via Unicode. (However, MSDOS version of
lv has none of the Unicode facility.)
lv can recognize ANSI escape sequences for text
decoration. So you can look ANSI-decorated streams
such as colored source codes generated by another
software just like intended image on ANSI termi
nals.
Completely original
lv is a completely original software including no
code drawn from less and grep and other programs at
all.
OPTIONS
-A<coding-system>
Set all coding systems to coding-system.
-I<coding-system>
Set input coding system to coding-system.
-K<coding-system>
Set keyboard coding system to coding-system. If it
is not set, output coding system will be applied to
it.
-O<coding-system>
Set output coding system to coding-system.
-P<coding-system>
Set pathname coding system to coding-system.
-D<coding-system>
Set default EUC coding system to coding-system.
coding-system:
a: auto-select (only for input stream)
c: iso-2022-cn
j: iso-2022-jp
k: iso-2022-kr
ec: euc-china
ej: euc-japan
ek: euc-korea
et: euc-taiwan
u7: UTF-7
u8: UTF-8
l1..9: iso-8859-1..9
s: shift-jis
b: big5
h: HZ
r: raw mode
Examples:
-Il2: input coding system is iso-8859-2
-Ks: keyboard coding system is shift-jis
-Oek: output coding system is euc-korea
Coding-system translations / Code-points conversions:
iso-2022-cn, -jp, -kr can be converted into euc-
china or -taiwan, euc-japan, euc-korea, respec
tively (and vice versa). shift-jis uses the same
internal code-points as iso-2022-jp and euc-japan.
Since big5 characters can be converted into CNS
11643-1992 with negligible incompleteness, big5
streams can be translated into iso-2022-cn or euc-
taiwan (and vice versa) with code-points conver
sion. Note that the iso-2022-cn referred here is
not GB sequence, only just CNS one. You should
remember that lv cannot translate big5 into GB
directly.
The search function of lv may not work correctly
when lv additionally performs ``code-points'' con
version (not ``coding-system'' translation),
because visible code and internal code are differ
ent from each other. lv will try to avoid this
problem with converting charsets of search patterns
automatically, but this function is not always per
fect.
-W<number>
Screen width
-H<number>
Screen height
-E'<editor>' (default 'vi -c %d')
Editor name (default 'vi -c %d')
``%d'' means the line number of current position in
a file.
-q Assert there is delete/insert-lines control.
Please set this option on a MSDOS ANSI terminal
that has capability to delete and/or insert lines.
As to termcap and terminfo version, it will be set
automatically.
-Ss<seq>
Set ANSI Standout sequence to seq (default "7")
-Sr<seq>
Set ANSI Reverse sequence to seq (default "7")
-Sb<seq>
Set ANSI Blink sequence to seq (default "5")
-Su<seq>
Set ANSI Underline sequence to seq (default "4")
Set ANSI Highlight sequence to seq (default "1")
These sequences are inserted between ``ESC ['' and
``m'' to construct full ANSI escape sequences.
-T<number>
Set Threshold-code which divides Unicode code-
points in two regions. Characters belonging to the
lower region are assumed to have a width of one,
and the higher characters are equated to a width of
two. (Default: 12288, = 0x3000)
-m Force Unicode code-points which have the same
glyphs as iso-8859-* to be Mapped to iso-8859-* in
a conversion from Unicode to another character set
which also has the corresponding code-points, in
particular, Asian charsets.
-a Adjust character set for search pattern (default)
-c Allow ANSI escape sequences for text decoration
(Color)
-d, -i Make regexp-searches ignore case (case folD search)
(default)
-f Substitute Fixed strings for regular expressions
-k Convert X0201 Katakana to X0208
-l Allow physical lines of each logical line printed
on the screen to be concatenated for cut and paste
after screen refresh
-s Force old pages to be swept out from the screen
Smoothly
-u Unify several character sets, eg. JIS X0208 and
C6226. In addition, lv equates ISO 646 variants,
eg. JIS X0201-Roman, and unknown charsets with
ASCII.
-g Turn on lgrep mode.
-n Prefix each line of output with the line number
within its input file on lgrep.
-v Invert the sense of matching on lgrep.
-z Enable HZ auto-detection (also enabled by run-time
C-t).
-+ Clear all options
``+<option>'' like +c, +d, ... +z.
- Treat the following arguments as filenames
grep pattern
lv works like grep (1) when its name is lgrep
-V Show lv version
-h Show this help
CONFIGURATION
Options can be described in configuration file ``.lv''
(``_lv'' on MSDOS) located at you HOME directory and/or
current working directory. They can be also described in
the environment variable LV. Every configuration will be
overloaded in this order if there is. Command line options
are always read finally.
COMMAND KEY BINDINGS
0..9: Argument
g, <: Jump to the line number (default: top of the file)
G, >: Jump to the line number (default: bottom of the
file)
p: Jump to the percentage position in line numbers
(0-100)
b, C-b:
Previous page
u, C-u:
Previous half page
k, w, C-k, y, C-y, C-p:
Previous line
j, C-j, e, C-e, C-n, CR:
Next line
d, C-d:
Next half page
f, C-f, C-v, SP:
Next page
/<string>:
Find a string in the forward direction (regular
expression)
Find a string in the backward direction (regular
expression)
n: Repeat previous search in forward direction
N: Repeat previous search in backward direction (not
REVERSE)
C-l: Redisplay all lines
r, C-r:
Refresh screen and memory
R: Reload current file
:n: Examine the next file
:p: Examine the previous file
t: Toggle input coding systems
T: Toggle input coding systems reversely
C-t: Toggle HZ decoding mode
v: Launch the editor defined by option -E
C-g, =:
Show file information (filename, position, coding
system)
V: Show LV version
C-z: Suspend (call SHELL or ``command.com'' under MSDOS)
q, Q: Quit
UP/DOWN:
Previous/Next line
LEFT/RIGHT:
Previous/Next half page
PageUp/PageDown:
Previous/Next page
HOW TO INPUT SEARCH STRINGS?
C-m, Enter:
Enter the current string
C-h, BS, DEL:
Delete one character (backspace)
C-p: Restore a few old strings incrementally (history)
C-g: Quit
REGULAR EXPRESSION
Special characters are ^, $, ., *, +, ?, [, ^, -, ], \.
\| specifies an alternative. \(, \) is a grouping con
struct. \1 and \2 matches any charset consists of one- or
two- column(s) characters respectively. Mutually overlap
ping ranges (or charset) are not guaranteed.
SEE ALSO
LV Homepage: http://www.ff.iij4u.or.jp/~nrt/lv/
COPYRIGHT
All rights reserved. Copyright (C) 1996-1999 by NARITA
Tomio.
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330,
Boston, MA 02111-1307 USA
BUG REPORT
Please send bug reports to: nrt@ff.iij4u.or.jp
Man(1) output converted with
man2html