1LV(1) General Commands Manual LV(1)
2
6 lv - a Powerful Multilingual File Viewer / Grep
7
9 lv, lgrep
10 lv -h
11 lv -V
12 lv [-acdfgiklmnqsuvz] [+acdfgiklmnqsuvz]
13 [-Acoding-system] [-Icoding-system] [-Kcoding-system]
14 [-Ocoding-system] [-Pcoding-system] [-Dcoding-system]
15 [-Ssseq] [-Srseq] [-Sbseq] [-Suseq] [-Shseq]
16 [-Tnumber] [-Wwidth] [-Hheight] [-E'editor'] [-+]
17 [+number] [+/grep-pattern]
18 [-] (grep-pattern) [files ...]
19
21 Multilingual file viewer
22 lv is a powerful multilingual file viewer. Apparently, lv looks
23 like less (1), a representative file viewer on UNIX as you know,
24 so UNIX people (and less people on other OSs) don't have to
25 learn a burdensome new interface. lv can be used on MSDOS ANSI
26 terminals and almost all UNIX platforms. lv is a currently
27 growing software, so your feedback is welcome and helpful for us
28 to refine the future lv.
29 Multiple coding systems
31 lv can decode and encode multilingual streams through many cod‐
32 ing systems, for example, ISO 2022 based coding systems such as
33 iso-2022-jp, and EUC (Extended Unix Code) like euc-japan. Fur‐
34 thermore, localized coding systems such as shift-jis, big5 and
35 HZ are also supported. lv can be used not only as a file viewer
36 but also as a coding-system translation filter like nkf (1) and
37 tcs (1).
38 Multilingual regular expressions / Multilingual grep
40 lv can recognize multi-bytes patterns as regular expressions,
41 and lv also provides multilingual grep (1) functionality by giv‐
42 ing it another name, lgrep. Pattern matching is conducted in
43 the charset level, so an EUC fragment, for example, can be found
44 in the ISO 2022 tailored streams, of course.
45 Supporting the Unicode standard
47 lv provides Unicode facilities which enables you to handle Uni‐
48 code streams encoded in UTF-7 or UTF-8, and lv can also convert
49 their code-points between Unicode and other charsets. So you
50 can display Unicode or foreign texts on your terminal, using the
51 code conversion function to your favorite charsets via Unicode.
52 (However, MSDOS version of lv has none of the Unicode facility.)
53 ANSI escape sequence through
55 lv can recognize ANSI escape sequences for text decoration. So
56 you can look ANSI-decorated streams such as colored source codes
57 generated by another software just like intended image on ANSI
58 terminals.
59 Completely original
61 lv is a completely original software including no code drawn
62 from less and grep and other programs at all.
63
65 -A<coding-system>
66 Set all coding systems to coding-system.
67 -I<coding-system>
69 Set input coding system to coding-system.
70 -K<coding-system>
72 Set keyboard coding system to coding-system. If it is not set,
73 output coding system will be applied to it.
74 -O<coding-system>
76 Set output coding system to coding-system.
77 -P<coding-system>
79 Set pathname coding system to coding-system.
80 -D<coding-system>
82 Set default (fall-back) coding system to coding-system.
83 coding-system:
85 a: auto-select
86 c: iso-2022-cn
87 j: iso-2022-jp
88 k: iso-2022-kr
89 ec: euc-china
90 ej: euc-japan
91 ek: euc-korea
92 et: euc-taiwan
93 u7: UTF-7
94 u8: UTF-8
95 l1..9: iso-8859-1..9
96 l0: iso-8859-10
97 lb,ld,le,lf,lg: iso-8859-11,13,14,15,16
98 s: shift-jis
99 b: big5
100 h: HZ
101 r: raw mode
102 Examples:
104 -Il2: input coding system is iso-8859-2
105 -Ks: keyboard coding system is shift-jis
106 -Oek: output coding system is euc-korea
107 -Ab: all coding systems are big5
108 Coding-system translations / Code-points conversions:
110 iso-2022-cn, -jp, -kr can be converted into euc-china or -tai‐
111 wan, euc-japan, euc-korea, respectively (and vice versa).
112 shift-jis uses the same internal code-points as iso-2022-jp and
113 euc-japan.
114 Since big5 characters can be converted into CNS 11643-1992 with
116 negligible incompleteness, big5 streams can be translated into
117 iso-2022-cn or euc-taiwan (and vice versa) with code-points con‐
118 version. Note that the iso-2022-cn referred here is not GB
119 sequence, only just CNS one. You should remember that lv cannot
120 translate big5 into GB directly.
121 The search function of lv may not work correctly when lv addi‐
123 tionally performs ``code-points'' conversion (not ``coding-sys‐
124 tem'' translation), because visible code and internal code are
125 different from each other. lv will try to avoid this problem
126 with converting charsets of search patterns automatically, but
127 this function is not always perfect.
128 -W<number>
130 Screen width
131 -H<number>
133 Screen height
134 -E'<editor>' (default 'vi -c %d')
136 Editor name (default 'vi -c %d')
137 ``%d'' means the line number of current position in a file.
138 -q Assert there is delete/insert-lines control.
140 Please set this option on a MSDOS ANSI terminal that has capa‐
141 bility to delete and/or insert lines. As to termcap and ter‐
142 minfo version, it will be set automatically.
143 -Ss<seq>
145 Set ANSI Standout sequence to seq (default "7")
146 -Sr<seq>
148 Set ANSI Reverse sequence to seq (default "7")
149 -Sb<seq>
151 Set ANSI Blink sequence to seq (default "5")
152 -Su<seq>
154 Set ANSI Underline sequence to seq (default "4")
155 -Sh<seq>
157 Set ANSI Highlight sequence to seq (default "1")
158 These sequences are inserted between ``ESC ['' and ``m'' to con‐
160 struct full ANSI escape sequences.
161 -T<number>
163 Set Threshold-code which divides Unicode code-points in two
164 regions. Characters belonging to the lower region are assumed to
165 have a width of one, and the higher characters are equated to a
166 width of two. (Default: 12288, = 0x3000)
167 -m Force Unicode code-points which have the same glyphs as
169 iso-8859-* to be Mapped to iso-8859-* in a conversion from Uni‐
170 code to another character set which also has the corresponding
171 code-points, in particular, Asian charsets.
172 -a Adjust character set for search pattern (default)
174 -c Allow ANSI escape sequences for text decoration (Color)
176 -d, -i Make regexp-searches ignore case (case folD search) (default)
178 -f Substitute Fixed strings for regular expressions
180 -k Convert X0201 Katakana to X0208 while decoding
182 -l Allow physical lines of each logical line printed on the screen
184 to be concatenated for cut and paste after screen refresh
185 -s Force old pages to be swept out from the screen Smoothly
187 -u Unify several character sets, eg. JIS X0208 and C6226. In addi‐
189 tion, lv equates ISO 646 variants, eg. JIS X0201-Roman, and
190 unknown charsets with ASCII.
191 -g Turn on lgrep mode.
193 -n Prefix each line of output with the line number within its input
195 file on lgrep.
196 -v Invert the sense of matching on lgrep.
198 -z Enable HZ auto-detection (also enabled by run-time C-t).
200 -+ Clear all options
202 You can also turn OFF specified options, using ``+<option>''
203 like +c, +d, ... +z.
204 - Treat the following arguments as filenames
206 grep-pattern
208 lv works like grep (1) when its name is lgrep
209 +number
211 Jump to the specified line immediately when lv is invoked.
212 +/grep-pattern
214 Search the specified pattern immediately when lv is invoked.
215 -V Show lv version
217 -h Show this help
219
221 Options can be described in configuration file ``.lv'' (``_lv'' on
222 MSDOS) located at you HOME directory. If and only if you use MSDOS,
223 you can locate ``_lv'' at current working directory. They can be also
224 described in the environment variable LV. Every configuration will be
225 overloaded in this order if there is. Command line options are always
226 read finally.
227
229 0..9: Argument
230 g, <: Jump to the line number (default: top of the file)
232 G, >: Jump to the line number (default: bottom of the file)
234 p: Jump to the percentage position in line numbers (0-100)
236 b, C-b:
238 Previous page
239 u, C-u:
241 Previous half page
242 k, w, C-k, y, C-y, C-p:
244 Previous line
245 j, C-j, e, C-e, C-n, CR:
247 Next line
248 d, C-d:
250 Next half page
251 f, C-f, C-v, SP:
253 Next page
254 F: Jump to the end of file, and wait for a data to be appended to
256 the file until interrupted.
257 /<string>:
259 Find a string in the forward direction (regular expression)
260 ?<string>:
262 Find a string in the backward direction (regular expression)
263 n: Repeat previous search in forward direction
265 N: Repeat previous search in backward direction (not REVERSE)
267 C-l: Redisplay all lines
269 r, C-r:
271 Refresh screen and memory
272 R: Reload current file
274 :n: Examine the next file
276 :p: Examine the previous file
278 t: Toggle input coding systems
280 T: Toggle input coding systems reversely
282 C-t: Toggle HZ decoding mode
284 v: Launch the editor defined by option -E
286 C-g, =:
288 Show file information (filename, position, coding system)
289 V: Show LV version
291 C-z: Suspend (call SHELL or ``command.com'' under MSDOS)
293 q, Q: Quit
295 UP/DOWN:
297 Previous/Next line
298 LEFT/RIGHT:
300 Previous/Next half page
301 PageUp/PageDown:
303 Previous/Next page
304
306 C-m, Enter:
307 Enter the current string
308 C-h, BS, DEL:
310 Delete one character (backspace)
311 C-u: Cancel the current string and try again
313 C-p: Restore a few old strings incrementally (history)
315 C-g: Quit
317
319 Special characters are ^, $, ., *, +, ?, [, ^, -, ], \. \| specifies
320 an alternative. \(, \) is a grouping construct. \1 and \2 matches any
321 charset consists of one- or two- column(s) characters respectively.
322 Mutually overlapping ranges (or charset) are not guaranteed.
323
325 LV Homepage: http://www.ff.iij4u.or.jp/~nrt/lv/
326
328 All rights reserved. Copyright (C) 1996-2004 by NARITA Tomio.
329 This program is free software; you can redistribute it and/or modify it
331 under the terms of the GNU General Public License as published by the
332 Free Software Foundation; either version 2 of the License, or (at your
333 option) any later version.
334 This program is distributed in the hope that it will be useful, but
336 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
337 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
338 Public License for more details.
339 You should have received a copy of the GNU General Public License along
341 with this program; if not, write to the Free Software Foundation, Inc.,
342 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
343
345 Please send bug reports to: nrt@ff.iij4u.or.jp
346 v.4.51 (Jan.16th,2004) LV(1)