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)
