LV(1)                                                                    LV(1)



NNAAMMEE
       lv - a Powerful Multilingual File Viewer / Grep

SSYYNNOOPPSSIISS
       llvv,, llggrreepp
       llvv -h
       llvv -V
       llvv [-acdfgiklmnqsuvz] [+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_'] [-+]
            [+_n_u_m_b_e_r] [+/_g_r_e_p_-_p_a_t_t_e_r_n]
            [-] (_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.  Apparently, 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 feedback 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 cod-
              ing systems, for example, ISO 2022 based coding systems such  as
              iso-2022-jp,  and EUC (Extended Unix Code) like euc-japan.  Fur-
              thermore, 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 _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 giv-
              ing  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 Uni-
              code 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
              terminals.

       _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  -tai-
              wan,   euc-japan,  euc-korea,  respectively  (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 con-
              version.  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  addi-
              tionally  performs ``code-points'' conversion (not ``coding-sys-
              tem'' 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.

       -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 capa-
              bility to delete and/or insert lines.  As to  termcap  and  ter-
              minfo 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 con-
              struct 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  Uni-
              code  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 addi-
              tion, 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

       +_n_u_m_b_e_r
              Jump to the specified line immediately when lv is invoked.

       +/_g_r_e_p_-_p_a_t_t_e_r_n
              Search  the specified pattern immediately when lv is invoked.

       -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 construct.  \1 and \2 matches  any
       charset  consists  of  one-  or two- column(s) characters respectively.
       Mutually overlapping 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  MER-
       CHANTABILITY  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)
