     LV(1)                                                                 LV(1)
                              v.4.49.4 (Aug.24th,2000)

     NAME
          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.  Apparently, 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 feedback 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 translation 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.)

          ANSI escape sequence through
               lv can recognize ANSI escape sequences for text decoration.  So

                                        - 1 -          Formatted:  June 12, 2001

     LV(1)                                                                 LV(1)
                              v.4.49.4 (Aug.24th,2000)

               you can look ANSI-decorated streams such as colored source codes
               generated by another software just like intended image on ANSI
               terminals.

          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
               -Ab:  all coding systems are big5

                                        - 2 -          Formatted:  June 12, 2001

     LV(1)                                                                 LV(1)
                              v.4.49.4 (Aug.24th,2000)

          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.

               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.

               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.

          -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")

          -Sh<seq>
               Set ANSI Highlight sequence to seq (default "1")

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

                                        - 3 -          Formatted:  June 12, 2001

     LV(1)                                                                 LV(1)
                              v.4.49.4 (Aug.24th,2000)

          -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
               You can also turn OFF specified options, using ``+<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

                                        - 4 -          Formatted:  June 12, 2001

     LV(1)                                                                 LV(1)
                              v.4.49.4 (Aug.24th,2000)

          -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)

          ?<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

                                        - 5 -          Formatted:  June 12, 2001

     LV(1)                                                                 LV(1)
                              v.4.49.4 (Aug.24th,2000)

          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-u: Cancel the current string and try again

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

          C-g: Quit

     REGULAR EXPRESSION
          Special characters are ^, $, ., *, +, ?, [, ^, -,  ], \.  \| specifies

                                        - 6 -          Formatted:  June 12, 2001

     LV(1)                                                                 LV(1)
                              v.4.49.4 (Aug.24th,2000)

          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.

     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

                                        - 7 -          Formatted:  June 12, 2001