.TH LV 1 "v.4.51 (Jan.16th,2004)" .SH NAME lv \- a Powerful Multilingual File Viewer / Grep .SH SYNOPSIS .B lv, lgrep .br .B lv \-h .br .B lv \-V .br .B lv [\-acdfgiklmnqsuvz] [+acdfgiklmnqsuvz] .br [\-A\fIcoding-system\fP] [\-I\fIcoding-system\fP] [\-K\fIcoding-system\fP] .br [\-O\fIcoding-system\fP] [\-P\fIcoding-system\fP] [\-D\fIcoding-system\fP] .br [\-Ss\fIseq\fP] [\-Sr\fIseq\fP] [\-Sb\fIseq\fP] [\-Su\fIseq\fP] [\-Sh\fIseq\fP] .br [\-T\fInumber\fP] [\-W\fIwidth\fP] [\-H\fIheight\fP] [\-E'\fIeditor'\fP] [\-+] .br [+\fInumber\fP] [+/\fIgrep-pattern\fP] .br [-] (\fIgrep-pattern\fP) [\fIfiles ...\fP] .SH DESCRIPTION .IP "\fIMultilingual file viewer\fP" \fIlv\fP is a powerful multilingual file viewer. Apparently, lv looks like \fIless\fP (1), a representative file viewer on UNIX as you know, so UNIX people (and \fIless\fP 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 feedback is welcome and helpful for us to refine the future lv. .IP "\fIMultiple coding systems\fP" 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 translation filter like \fInkf\fP (1) and \fItcs\fP (1). .IP "\fIMultilingual regular expressions / Multilingual grep\fP" lv can recognize multi-byte patterns as regular expressions, and lv also provides multilingual \fIgrep\fP (1) functionality by giving it another name, \fIlgrep\fP. 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. .IP "\fISupporting the Unicode standard\fP" 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.) .IP "\fIANSI escape sequence through\fP" 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 terminals. .IP "\fICompletely original\fP" lv is a completely original software including no code drawn from \fIless\fP and \fIgrep\fP and other programs at all. .SH "OPTIONS" .IP "-A<\fIcoding-system\fP>" Set all coding systems to \fIcoding-system\fP. .IP "-I<\fIcoding-system\fP>" Set input coding system to \fIcoding-system\fP. .IP "-K<\fIcoding-system\fP>" Set keyboard coding system to \fIcoding-system\fP. If it is not set, output coding system will be applied to it. .IP "-O<\fIcoding-system\fP>" Set output coding system to \fIcoding-system\fP. .IP "-P<\fIcoding-system\fP>" Set pathname coding system to \fIcoding-system\fP. .IP "-D<\fIcoding-system\fP>" Set default (fall-back) coding system to \fIcoding-system\fP. .IP "coding-system:" a: auto-select .br c: iso-2022-cn .br j: iso-2022-jp .br k: iso-2022-kr .br ec: euc-china .br ej: euc-japan .br ek: euc-korea .br et: euc-taiwan .br u7: UTF-7 .br u8: UTF-8 .br l1..9: iso-8859-1..9 .br l0: iso-8859-10 .br lb,ld,le,lf,lg: iso-8859-11,13,14,15,16 .br s: shift-jis .br b: big5 .br h: HZ .br r: raw mode .IP "Examples:" \-Il2: input coding system is iso-8859-2 .br \-Ks: keyboard coding system is shift-jis .br \-Oek: output coding system is euc-korea .br \-Ab: all coding systems are big5 .IP "Coding-system translations / Code-points conversions:" iso-2022-cn, \-jp, \-kr can be converted into euc-china or \-taiwan, euc-japan, euc-korea, respectively (and vice versa). shift-jis uses the same internal code-points as iso-2022-jp and euc-japan. .sp 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 conversion. 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. .sp The search function of lv may not work correctly when lv additionally performs ``code-points'' conversion (not ``coding-system'' translation), because visible code and internal code are different from each other. lv will try to avoid this problem with converting charsets of search patterns automatically, but this function is not always perfect. .IP "-W<\fInumber\fP>" Screen width .IP "-H<\fInumber\fP>" Screen height .IP "-E'<\fIeditor\fP>' (default 'vi -c %d')" Editor name (default 'vi \-c %d') .br ``%d'' means the line number of current position in a file. .IP "-q" Assert there is delete/insert-lines control. .br 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. .IP "-Ss<\fIseq\fP>" Set ANSI Standout sequence to \fIseq\fP (default "7") .IP "-Sr<\fIseq\fP>" Set ANSI Reverse sequence to \fIseq\fP (default "7") .IP "-Sb<\fIseq\fP>" Set ANSI Blink sequence to \fIseq\fP (default "5") .IP "-Su<\fIseq\fP>" Set ANSI Underline sequence to \fIseq\fP (default "4") .IP "-Sh<\fIseq\fP>" Set ANSI Highlight sequence to \fIseq\fP (default "1") .sp These sequences are inserted between ``ESC ['' and ``m'' to construct full ANSI escape sequences. .br .IP "-T<\fInumber\fP>" 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) .IP "-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. .br .IP "-a" Adjust character set for search pattern (default) .IP "-c" Allow ANSI escape sequences for text decoration (Color) .IP "-d, -i" Make regexp-searches ignore case (case folD search) (default) .IP "-f" Substitute Fixed strings for regular expressions .IP "-k" Convert X0201 Katakana to X0208 while decoding .IP "-l" Allow physical lines of each logical line printed on the screen to be concatenated for cut and paste after screen refresh .IP "-s" Force old pages to be swept out from the screen smoothly .IP "-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. .IP "-g" Turn on lgrep mode. .IP "-n" Prefix each line of output with the line number within its input file on lgrep. .IP "-v" Invert the sense of matching on lgrep. .IP "-z" Enable HZ auto-detection (also enabled by run-time C-t). .br .IP "-+" Clear all options .br You can also turn OFF specified options, using ``+