1
.TH LV 1 "v.4.51 (Jan.16th,2004)"
3
lv \- a Powerful Multilingual File Viewer / Grep
14
[-acdfgiklmnqsuvz] [+acdfgiklmnqsuvz]
16
[-A\fIcoding-system\fP] [-I\fIcoding-system\fP] [-K\fIcoding-system\fP]
18
[-O\fIcoding-system\fP] [-P\fIcoding-system\fP] [-D\fIcoding-system\fP]
20
[-Ss\fIseq\fP] [-Sr\fIseq\fP] [-Sb\fIseq\fP] [-Su\fIseq\fP] [-Sh\fIseq\fP]
22
[-T\fInumber\fP] [-W\fIwidth\fP] [-H\fIheight\fP] [-E'\fIeditor'\fP] [-+]
24
[+\fInumber\fP] [+/\fIgrep-pattern\fP]
26
[-] (\fIgrep-pattern\fP) [\fIfiles ...\fP]
28
.IP "\fIMultilingual file viewer\fP"
29
\fIlv\fP is a powerful multilingual file viewer.
30
Apparently, lv looks like \fIless\fP (1),
31
a representative file viewer on UNIX as you know,
32
so UNIX people (and \fIless\fP people on other OSs)
33
don't have to learn a burdensome new interface.
34
lv can be used on MSDOS ANSI terminals and almost all UNIX platforms.
35
lv is a currently growing software,
36
so your feedback is welcome
37
and helpful for us to refine the future lv.
38
.IP "\fIMultiple coding systems\fP"
39
lv can decode and encode multilingual streams
40
through many coding systems, for example,
41
ISO 2022 based coding systems such as iso-2022-jp,
42
and EUC (Extended Unix Code) like euc-japan.
44
localized coding systems
45
such as shift-jis, big5 and HZ are also supported.
46
lv can be used not only as a file viewer
47
but also as a coding-system translation filter
48
like \fInkf\fP (1) and \fItcs\fP (1).
49
.IP "\fIMultilingual regular expressions / Multilingual grep\fP"
50
lv can recognize multi-bytes patterns as regular expressions,
51
and lv also provides multilingual \fIgrep\fP (1) functionality
52
by giving it another name, \fIlgrep\fP.
53
Pattern matching is conducted in the charset level,
54
so an EUC fragment, for example,
55
can be found in the ISO 2022 tailored streams, of course.
56
.IP "\fISupporting the Unicode standard\fP"
57
lv provides Unicode facilities
58
which enables you to handle Unicode streams encoded in UTF-7 or UTF-8,
59
and lv can also convert their code-points
60
between Unicode and other charsets.
61
So you can display Unicode or foreign texts on your terminal,
62
using the code conversion function
63
to your favorite charsets via Unicode.
64
(However, MSDOS version of lv has none of the Unicode facility.)
65
.IP "\fIANSI escape sequence through\fP"
66
lv can recognize ANSI escape sequences for text decoration.
67
So you can look ANSI-decorated streams
68
such as colored source codes generated by another software
69
just like intended image on ANSI terminals.
70
.IP "\fICompletely original\fP"
71
lv is a completely original software
72
including no code drawn from \fIless\fP and \fIgrep\fP
73
and other programs at all.
75
.IP "-A<\fIcoding-system\fP>"
76
Set all coding systems to \fIcoding-system\fP.
77
.IP "-I<\fIcoding-system\fP>"
78
Set input coding system to \fIcoding-system\fP.
79
.IP "-K<\fIcoding-system\fP>"
80
Set keyboard coding system to \fIcoding-system\fP.
81
If it is not set, output coding system will be applied to it.
82
.IP "-O<\fIcoding-system\fP>"
83
Set output coding system to \fIcoding-system\fP.
84
.IP "-P<\fIcoding-system\fP>"
85
Set pathname coding system to \fIcoding-system\fP.
86
.IP "-D<\fIcoding-system\fP>"
87
Set default (fall-back) coding system to \fIcoding-system\fP.
113
lb,ld,le,lf,lg: iso-8859-11,13,14,15,16
123
-Il2: input coding system is iso-8859-2
125
-Ks: keyboard coding system is shift-jis
127
-Oek: output coding system is euc-korea
129
-Ab: all coding systems are big5
130
.IP "Coding-system translations / Code-points conversions:"
131
iso-2022-cn, -jp, -kr can be converted into euc-china or -taiwan,
132
euc-japan, euc-korea, respectively (and vice versa).
133
shift-jis uses the same internal code-points
134
as iso-2022-jp and euc-japan.
136
Since big5 characters can be converted into CNS 11643-1992
137
with negligible incompleteness,
138
big5 streams can be translated into iso-2022-cn or euc-taiwan
139
(and vice versa) with code-points conversion.
140
Note that the iso-2022-cn referred here is not GB sequence,
142
You should remember that lv cannot translate big5 into GB directly.
144
The search function of lv may not work correctly when lv additionally
145
performs ``code-points'' conversion
146
(not ``coding-system'' translation),
147
because visible code and internal code are different from each other.
148
lv will try to avoid this problem with
149
converting charsets of search patterns automatically,
150
but this function is not always perfect.
151
.IP "-W<\fInumber\fP>"
153
.IP "-H<\fInumber\fP>"
155
.IP "-E'<\fIeditor\fP>' (default 'vi -c %d')"
156
Editor name (default 'vi -c %d')
158
``%d'' means the line number of current position in a file.
160
Assert there is delete/insert-lines control.
162
Please set this option on a MSDOS ANSI terminal
163
that has capability to delete and/or insert lines.
164
As to termcap and terminfo version,
165
it will be set automatically.
167
Set ANSI Standout sequence to \fIseq\fP (default "7")
169
Set ANSI Reverse sequence to \fIseq\fP (default "7")
171
Set ANSI Blink sequence to \fIseq\fP (default "5")
173
Set ANSI Underline sequence to \fIseq\fP (default "4")
175
Set ANSI Highlight sequence to \fIseq\fP (default "1")
177
These sequences are inserted
178
between ``ESC ['' and ``m''
179
to construct full ANSI escape sequences.
181
.IP "-T<\fInumber\fP>"
182
Set Threshold-code which divides Unicode code-points in
183
two regions. Characters belonging to the lower region are
184
assumed to have a width of one, and the higher characters
185
are equated to a width of two. (Default: 12288, = 0x3000)
187
Force Unicode code-points which have the same glyphs as
188
iso-8859-* to be Mapped to iso-8859-* in a conversion from
189
Unicode to another character set which also has the
190
corresponding code-points, in particular, Asian charsets.
193
Adjust character set for search pattern (default)
195
Allow ANSI escape sequences for text decoration (Color)
197
Make regexp-searches ignore case (case folD search) (default)
199
Substitute Fixed strings for regular expressions
201
Convert X0201 Katakana to X0208 while decoding
203
Allow physical lines of each logical line printed on the screen
204
to be concatenated for cut and paste after screen refresh
206
Force old pages to be swept out from the screen Smoothly
208
Unify several character sets, eg. JIS X0208 and C6226.
209
In addition, lv equates ISO 646 variants,
211
and unknown charsets with ASCII.
215
Prefix each line of output with the line number within its input file on lgrep.
217
Invert the sense of matching on lgrep.
219
Enable HZ auto-detection (also enabled by run-time C-t).
224
You can also turn OFF specified options,
225
using ``+<option>'' like +c, +d, ... +z.
227
Treat the following arguments as filenames
228
.IP "\fIgrep-pattern\fP"
229
lv works like \fIgrep\fP (1) when its name is \fIlgrep\fP
231
Jump to the specified line immediately when lv is invoked.
232
.IP "+/\fIgrep-pattern\fP"
233
Search the specified pattern immediately when lv is invoked.
239
Options can be described in configuration file ``.lv'' (``_lv'' on MSDOS)
240
located at you HOME directory. If and only if you use MSDOS, you can locate
241
``_lv'' at current working directory.
242
They can be also described in the environment variable LV.
243
Every configuration will be overloaded in this order if there is. Command line
244
options are always read finally.
245
.SH "COMMAND KEY BINDINGS"
249
Jump to the line number (default: top of the file)
251
Jump to the line number (default: bottom of the file)
253
Jump to the percentage position in line numbers (0-100)
258
.IP "k, w, C-k, y, C-y, C-p:"
260
.IP "j, C-j, e, C-e, C-n, CR:"
264
.IP "f, C-f, C-v, SP:"
267
Jump to the end of file, and wait for a data to be appended to
268
the file until interrupted.
270
Find a string in the forward direction (regular expression)
272
Find a string in the backward direction (regular expression)
274
Repeat previous search in forward direction
276
Repeat previous search in backward direction (not REVERSE)
280
Refresh screen and memory
284
Examine the next file
286
Examine the previous file
288
Toggle input coding systems
290
Toggle input coding systems reversely
292
Toggle HZ decoding mode
294
Launch the editor defined by option -E
296
Show file information (filename, position, coding system)
300
Suspend (call SHELL or ``command.com'' under MSDOS)
306
Previous/Next half page
307
.IP "PageUp/PageDown:"
309
.SH "HOW TO INPUT SEARCH STRINGS?"
311
Enter the current string
313
Delete one character (backspace)
315
Cancel the current string and try again
317
Restore a few old strings incrementally (history)
320
.SH "REGULAR EXPRESSION"
321
Special characters are ^, $, ., *, +, ?, [, ^, -, ], \\.
322
\\| specifies an alternative. \\(, \\) is a grouping construct.
323
\\1 and \\2 matches any charset consists of one- or two- column(s)
324
characters respectively. Mutually overlapping ranges (or charset)
327
LV Homepage: http://www.ff.iij4u.or.jp/~nrt/lv/
329
All rights reserved. Copyright (C) 1996-2004 by NARITA Tomio.
331
This program is free software; you can redistribute it and/or modify
332
it under the terms of the GNU General Public License as published by
333
the Free Software Foundation; either version 2 of the License, or
334
(at your option) any later version.
336
This program is distributed in the hope that it will be useful,
337
but WITHOUT ANY WARRANTY; without even the implied warranty of
338
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
339
GNU General Public License for more details.
341
You should have received a copy of the GNU General Public License
342
along with this program; if not, write to the Free Software
343
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
345
Please send bug reports to: nrt@ff.iij4u.or.jp
added
removed
.pc/fix-hyphen-used-as-minus-sign.diff/lv.1
