LV(1) LV(1)

NNAAMMEE

lv - a Powerful Multilingual File Viewer / Grep

SSYYNNOOPPSSIISS

llvv,, llggrreepp

llvv -h

llvv -V

llvv [-[+]acdfgiklmnqsuvz]

[-A_c_o_d_i_n_g_-_s_y_s_t_e_m] [-I_c_o_d_i_n_g_-_s_y_s_t_e_m] [-K_c_o_d_i_n_g_-_s_y_s_t_e_m]

[-O_c_o_d_i_n_g_-_s_y_s_t_e_m] [-P_c_o_d_i_n_g_-_s_y_s_t_e_m] [-D_c_o_d_i_n_g_-_s_y_s_t_e_m]

[-Ss_s_e_q] [-Sr_s_e_q] [-Sb_s_e_q] [-Su_s_e_q] [-Sh_s_e_q]

[-T_n_u_m_b_e_r] [-W_w_i_d_t_h] [-H_h_e_i_g_h_t] [-E'_e_d_i_t_o_r_'] [-+]

[-] (_g_r_e_p _p_a_t_t_e_r_n) [_f_i_l_e_s _._._.]

DDEESSCCRRIIPPTTIIOONN

_M_u_l_t_i_l_i_n_g_u_a_l _f_i_l_e _v_i_e_w_e_r

_l_v is a powerful multilingual file viewer. Appar-

ently, lv looks like _l_e_s_s (1), a representative

file viewer on UNIX as you know, so UNIX people

(and _l_e_s_s 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.

_M_u_l_t_i_p_l_e _c_o_d_i_n_g _s_y_s_t_e_m_s

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 _n_k_f (1) and _t_c_s (1).

_M_u_l_t_i_l_i_n_g_u_a_l _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n_s _/ _M_u_l_t_i_l_i_n_g_u_a_l _g_r_e_p

lv can recognize multi-bytes patterns as regular

expressions, and lv also provides multilingual _g_r_e_p

(1) functionality by giving it another name, _l_g_r_e_p.

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.

_S_u_p_p_o_r_t_i_n_g _t_h_e _U_n_i_c_o_d_e _s_t_a_n_d_a_r_d

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.)

_A_N_S_I _e_s_c_a_p_e _s_e_q_u_e_n_c_e _t_h_r_o_u_g_h

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.

_C_o_m_p_l_e_t_e_l_y _o_r_i_g_i_n_a_l

lv is a completely original software including no

code drawn from _l_e_s_s and _g_r_e_p and other programs at

all.

OOPPTTIIOONNSS

-A<_c_o_d_i_n_g_-_s_y_s_t_e_m>

Set all coding systems to _c_o_d_i_n_g_-_s_y_s_t_e_m.

-I<_c_o_d_i_n_g_-_s_y_s_t_e_m>

Set input coding system to _c_o_d_i_n_g_-_s_y_s_t_e_m.

-K<_c_o_d_i_n_g_-_s_y_s_t_e_m>

Set keyboard coding system to _c_o_d_i_n_g_-_s_y_s_t_e_m. If it

is not set, output coding system will be applied to

it.

-O<_c_o_d_i_n_g_-_s_y_s_t_e_m>

Set output coding system to _c_o_d_i_n_g_-_s_y_s_t_e_m.

-P<_c_o_d_i_n_g_-_s_y_s_t_e_m>

Set pathname coding system to _c_o_d_i_n_g_-_s_y_s_t_e_m.

-D<_c_o_d_i_n_g_-_s_y_s_t_e_m>

Set default (fall-back) coding system to _c_o_d_i_n_g_-

_s_y_s_t_e_m.

coding-system:

a: auto-select

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

l0: iso-8859-10

lb,ld,le,lf,lg: iso-8859-11,13,14,15,16

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

-Ab: all coding systems are big5

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<_n_u_m_b_e_r>

Screen width

-H<_n_u_m_b_e_r>

Screen height

-E'<_e_d_i_t_o_r>' (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<_s_e_q>

Set ANSI Standout sequence to _s_e_q (default "7")

-Sr<_s_e_q>

Set ANSI Reverse sequence to _s_e_q (default "7")

-Sb<_s_e_q>

Set ANSI Blink sequence to _s_e_q (default "5")

-Su<_s_e_q>

Set ANSI Underline sequence to _s_e_q (default "4")

-Sh<_s_e_q>

Set ANSI Highlight sequence to _s_e_q (default "1")

These sequences are inserted between ``ESC ['' and

``m'' to construct full ANSI escape sequences.

-T<_n_u_m_b_e_r>

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 while decoding

-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

You can also turn OFF specified options, using

``+<option>'' like +c, +d, ... +z.

- Treat the following arguments as filenames

_g_r_e_p _p_a_t_t_e_r_n

lv works like _g_r_e_p (1) when its name is _l_g_r_e_p

-V Show lv version

-h Show this help

CCOONNFFIIGGUURRAATTIIOONN

Options can be described in configuration file ``.lv''

(``_lv'' on MSDOS) located at you HOME directory. If and

only if you use MSDOS, you can locate ``_lv'' at 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.

CCOOMMMMAANNDD KKEEYY BBIINNDDIINNGGSS

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

F: Jump to the end of file, and wait for a data to be

appended to the file until interrupted.

/<string>:

Find a string in the forward direction (regular

expression)

?<string>:

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

HHOOWW TTOO IINNPPUUTT SSEEAARRCCHH SSTTRRIINNGGSS??

C-m, Enter:

Enter the current string

C-h, BS, DEL:

Delete one character (backspace)

C-u: Cancel the current string and try again

C-p: Restore a few old strings incrementally (history)

C-g: Quit

RREEGGUULLAARR EEXXPPRREESSSSIIOONN

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.

SSEEEE AALLSSOO

LV Homepage: http://www.ff.iij4u.or.jp/~nrt/lv/

CCOOPPYYRRIIGGHHTT

All rights reserved. Copyright (C) 1996-2004 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

BBUUGG RREEPPOORRTT

Please send bug reports to: nrt@ff.iij4u.or.jp

v.4.51 (Jan.16th,2004) LV(1)