lv: a Powerful Multilingual File Viewer


SYNOPSIS

       lv, lgrep
       lv -h
       lv -V
       lv [-[+]acdfgiklmnqsuvz]
            [-Acoding-system] [-Icoding-system] [-Kcoding-system]
            [-Ocoding-system] [-Pcoding-system] [-Dcoding-system]
            [-Ssseq] [-Srseq] [-Sbseq] [-Suseq] [-Shseq]
            [-Tnumber] [-Wwidth] [-Hheight] [-E'editor'] [-+]
            [-] (grep pattern) [files ...]


DESCRIPTION

       Multilingual file viewer
              lv  is a powerful multilingual file viewer.  Appar­
              ently, lv looks like  less  (1),  a  representative
              file  viewer  on  UNIX  as you know, so UNIX people
              (and less 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.

       Multiple coding systems
              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 nkf (1) and tcs (1).

       Multilingual regular expressions / Multilingual grep
              lv can recognize multi-bytes  patterns  as  regular
              expressions, and lv also provides multilingual grep
              (1) functionality by giving it another name, lgrep.
              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.

       Supporting the Unicode standard
              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.)

              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.

       Completely original
              lv is a completely original software  including  no
              code drawn from less and grep and other programs at
              all.


OPTIONS

       -A<coding-system>
              Set all coding systems to coding-system.

       -I<coding-system>
              Set input coding system to coding-system.

       -K<coding-system>
              Set keyboard coding system to coding-system.  If it
              is not set, output coding system will be applied to
              it.

       -O<coding-system>
              Set output coding system to coding-system.

       -P<coding-system>
              Set pathname coding system to coding-system.

       -D<coding-system>
              Set default EUC coding system to coding-system.

       coding-system:
              a: auto-select (only for input stream)
              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
              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


       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<number>
              Screen width

       -H<number>
              Screen height

       -E'<editor>' (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<seq>
              Set ANSI Standout sequence to seq  (default "7")

       -Sr<seq>
              Set ANSI Reverse sequence to seq   (default "7")

       -Sb<seq>
              Set ANSI Blink sequence to seq     (default "5")

       -Su<seq>
              Set ANSI Underline sequence to seq (default "4")

              Set ANSI Highlight sequence to seq (default "1")

              These sequences are inserted between ``ESC [''  and
              ``m'' to construct full ANSI escape sequences.

       -T<number>
              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

       -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

              ``+<option>'' like +c, +d, ... +z.

       -      Treat the following arguments as filenames

       grep pattern
              lv works like grep (1) when its name is lgrep

       -V     Show lv version

       -h     Show this help


CONFIGURATION

       Options can be described  in  configuration  file  ``.lv''
       (``_lv''  on  MSDOS)  located at you HOME directory and/or
       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.


COMMAND KEY BINDINGS

       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

       /<string>:
              Find  a  string  in  the forward direction (regular
              expression)

              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


HOW TO INPUT SEARCH STRINGS?

       C-m, Enter:
              Enter the current string

       C-h, BS, DEL:
              Delete one character (backspace)


       C-p:   Restore a few old strings incrementally (history)

       C-g:   Quit


REGULAR EXPRESSION

       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.


SEE ALSO

       LV Homepage: http://www.ff.iij4u.or.jp/~nrt/lv/


COPYRIGHT

       All rights reserved. Copyright  (C)  1996-1999  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


BUG REPORT

       Please send bug reports to: nrt@ff.iij4u.or.jp


Man(1) output converted with man2html