home | help 
LV(1)			     General Commands Manual			   LV(1)

NAME
     lv - a Powerful Multilingual File Viewer / Grep

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.	Further-
	    more, 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  an-
	    other  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  you
	    can  look ANSI-decorated streams such as colored source codes gener-
	    ated 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, out-
	    put 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 (fall-back) coding system to coding-system.

     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, 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 neg-
	    ligible  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  addition-
	    ally  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 con-
	    struct 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 par-
	    ticular, 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

     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.  If and only if you use MSDOS, you can lo-
     cate ``_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.

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

     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

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 an
     alternative. \(, \) is a grouping construct.  \1 and \2 matches any charset
     consists of one- or two- column(s) characters respectively. Mutually  over-
     lapping 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-2004 by NARITA Tomio.

     This program is free software; you can redistribute it and/or modify it un-
     der  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 FIT-
     NESS 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

			     v.4.51 (Jan.16th,2004)			   LV(1)
home | help