vim-howto-help.vd

// vi: filetype=vimdesc textwidth=70 colorcolumn=70

도움말은 `:h[elp]` 명령으로 열 수 있다. 보통 가로로 분할된 창으로 
열리면서 도움말 화면이 표시된다. 

도움말 화면 내에서의 이동은 기본적인 이동방법을 그대로 사용할 수 있다.
실제로 vim 도움말 파일은 읽기전용 속성의 텍스트 파일이며 내부적으로 각
토픽을 연결하는 링크(태그)가 정의되어 있다. 따라서 `h`, `j`, `k`, `l`
을 사용한 커서 이동 및 그외 여러 스크롤 이동, 검색등의 명령을 모두 사
용할 수 있다. 

도움말 내에서 별도의 색으로 표시된 항목은 보통 해당 항목에 대한 도움말
로 연결되는 경우가 많다. 이런 경우 해당 항목 위에서 <C-]>을 눌러 해당
항목에 대한 도움말로 이동할 수 있다.

도움말 문서 내에서 다른 항목으로 이동하는 또 다른 방법은 `K`를 사용하
는 것이다. (<Shift-K> 즉, 대문자 K를 눌러야한다.) 이 명령은 커서가 위
치한 단어를 도움말 프로그램에게 전달한다. help 파일은 이 명령이
":help"로 되어 있기 때문에 자동으로 해당 도움말 위치를 열어준다.

<C-]>, `K`로 이동한 경우 원래 자리로 돌아가려면 <C-O>를 사용하여 이전
위치로 돌아갈 수 있다. 

# [도움말 빨리 찾기]

각 도움말을 보면 다음과 같이 오른쪽 위에 토픽 이름이 표시되어 있다.

----------------------------------------------------------------------
<C-LeftMouse>					           <C-LeftMouse> CTRL-]
CTRL-]			Jump to the definition of the keyword under the
				cursor.  Same as ":tag {name}", where {name} is the
				keyword under or after cursor.
				When there are several matching tags for {name}, jump
				to the [count] one.  When no [count] is given the
				first one is jumped to. See |tag-matchlist| for
				jumping to other matching tags.

													*v_CTRL-]*
{Visual}CTRL-]	Same as ":tag {name}", where {name} is the text that
				is highlighted.
----------------------------------------------------------------------

이 토픽이름은 `:help` 명령의 인자로 쓰여서 바로 특정 기능을 찾아볼 수
있게 할 수 있는 부분이다. 

`:help` 명령의 형식은 다음과 같다.  (`:help {subject}`)

`:help :excommand` : Ex 명령의 도움말을 찾는다.
`:help 'option'`   : 해당 옵션의 도움말을 찾는다.
`:help command`    : 노멀모드 명령의 도움말을 찾는다.

일반 명령의 경우, `i_`, `v_`, `c_`를 붙여서 삽입, 비주얼, 명령모드에서
의 명령에 대한 도움말을 찾을 수 있다. 특수키는 <Esc>, <Tab> 등으로 입
력하여 찾을 수 있지만, <C-R> 과 같은 조합키의 경우"<C-L>"이 아닌
"CTRL-L" 과 같은 형식으로 입력하거나 "^L"의 표기를 사용할 수 있다. 

참고로 도움말에 대한 항목들은 <Tab>키를 통한 자동완성을 지원한다.
`:set wildmenu` 옵션을 켜면 <Tab> 키를 눌렀을 때 자동완성 목록을 가로
로 펼쳐서 보여준다. 또한 `:help i_` 까지 입력하고 <C-D>를 누르면 자동
완성 목록 전체를 표시해준다. 자동완성은 반드시 앞부터 매칭하는 것은 아
니며, ":set wi"까지 입력 후 <Tab>키를 눌러서 `:set :wildmenu`를 찾을
수도 있다.

:help zz
 -> `zz` 명령에 대한 도움말을 본다.
:help i_CTRL-K
:help i^K
 -> 입력모드에서 <C-K>을 누를 때의 도움말을 찾는다. 
:help 'smartindent'
 -> 'smartindent' 옵션에 대한 도움말을 찾는다.

그외에 도움말 파일 이름이나 목차번호, 표제어를 통해서 찾을 수도 있다. 
:help options.txt
 -> 옵션에 대한 도움말 파일을 연다.
:help usr_toc.txt
 -> 도움말 목차를 연다
:help 07
:help 07.1
 -> 07.1 에 해당하는 목차를 연다. 07.1은 "Edit another file"에 대한 내
 용이다. 

# [도움말에서 검색하기]
`:helpg[rep]` 명령은 전체 도움말 파일에서 주어진 패턴을 찾는다. 이 명
령은 `:vimgrep` 명령과 달리 패턴주위를 구분자로 감싸지 않는다. 

아래 명령으로 `:helpgrep` 명령에 대한 도움말을 확인해보자.
:help :helpg


`:helpgrep` 명령은 도움말을 검색한 전체 결과를 "quickfix" 목록으로 만
들어준다. `:cw` 명령을 통해서 목록을 열 수 있다. 혹은 `:cn` 이나 `:cp`
명령으로 다음 검색 위치로 즉시 이동할 수 있다. 

예를 들어 "wild"로 시작하는 *옵션*을 검색하려면 다음 명령을 사용한다. 

:helpg 'wild\w


# [옵션의 경우]

옵션을 간단하게 살펴보고 싶은 경우에는 `:options` 명령을 사용할 수 있
다. 이 명령은 전체 옵션의 설정 현황과 변경을 수행할 수 있다. 

앞부분에는 전체 옵션에 대한 분류별 토픽이 소개되고 각 토픽에 대한 옵션
들이 나열된다. 각 옵션에 대한 레이아웃은 다음과 같다. 


1. 각 옵션 이름은 내어쓰기 되어 왼쪽으로 나와 있게 된다. 
2. 옵션이름은 일정한 공간을 띄고 간단한 설명이 표시된다. 
3. 아래에는 현재 설정값이 표시된다. on/off 방식의 설정인 경우, 반대 값
이 뒤에 오게된다. 

1, 2가 표시되는 줄을 "help line"이라고 한다. 이 줄에 커서를 두고 <CR>
을 누르면 해당 옵션에 대한 도움말이 열린다.  그 아래 쪽은 옵션 설정 라
인이다. 토글 방식의 옵션의 경우 <CR>을 누를 때 마다 옵션이 토글된다.
값을 지정하는 옵션인 경우, 편집 명령을 통해 변경하고 <CR>을 눌러 변경
사항을 적용할 수 있다.


----------------------------------------------------------------------
 6 multiple windows

{option}	Press <CR> to open help for this option.
			`set {current} {oppsite}` // <CR> Here to change option.

statusline	alternate format to be used for a status line
			set stl=%!airline#statusline(2)
equalalways	make all windows the same size when adding/removing windows
			set ea	noea
eadirection	in which direction 'equalalways' works: "ver", "hor" or "both"
			set ead=both
winheight	minimal number of lines used for the current window
			set wh=1
winminheight	minimal number of lines used for any window
			set wmh=1
winfixheight	keep the height of the window
			(local to window)
			set nowfh	wfh
winfixwidth	keep the width of the window
			(local to window)
			set nowfw	wfw
----------------------------------------------------------------------