*CtagExpl.txt*	CtagExpl					Feb 22, 2011

Author:  Charles E. Campbell  <NcampObell@SdrPchip.AorgM-NOSPAM>
	(elide NOSPAM from my email before using)
Copyright: (c) 2004-2011 by Charles E. Campbell		*CtagExpl-copyright*
           The VIM LICENSE applies to CtagExpl.vim and CtagExpl.txt
           (see |copyright|) except use "CtagExpl" instead of "Vim"
	   No warranty, express or implied.  Use At-Your-Own-Risk.

==============================================================================
1. Contents					*CtagExpl* *CtagExpl-contents*

   1. Contents.....................................: |CtagExpl-contents|
   2. Manual.......................................: |CtagExpl-manual|
   3. Options......................................: |CtagExpl-options|
   4. History......................................: |CtagExpl-history|


==============================================================================
2. Manual						*CtagExpl-manual*
>
	:CtagExpl

The header command brings up a window on the left hand side of the display
containing a list of tags under tag types.  Moving the cursor up and down will
display the target of the tag.  Pressing the <cr> while atop a tag will select
it; the cursor will move to the right side window and the display will tag to
the selected tag.

CtagExpl will use any existing <tags> file.  If the <tags> file doesn't
exist, then if a script <mktags> exists, it will execute it in the hopes that
it will generate a <tags> file.  If a <tags> file still doesn't exist, then
the :CtagExpl command will invoke the CtagExpl program on the current file.

The :CtagExpl command toggles between on and off.  One may also specify >
	:CtagExpl 1
	:CtagExpl 0
The first will turn CtagExpl on, and the second will turn it off.

The "CtagExpl list" window supports several special commands: >

	<s-left>	display the previous tag of the same kind via :echo
	<s-right>	display the next tag of the same kind via :echo
	<s-left>	move to previous tag kind label
	<s-right>	move to next tag kind label
	<cr>		open to tag in editing window
	v		vertically split editing window, open current tag in it
	o		open to tag in editing window, leave cursor in
			"CtagExpl" window
	h		open to previous tag in editing window, leave cursor in
			"CtagExpl" window
	l		open to next tag in editing window, leave cursor in
			"CtagExpl" window
	t		split in a new tab

==============================================================================
3. Options						*CtagExpl-options*
>
	g:CtagExpl_cygwin
<	  If your o/s is windows and your shell is bash, then CtagExpl
	  will guess that you're using cygwin under windows.  Affects
	  the default value of g:CtagExpl_shq.
>
	g:CtagExpl_chgwin
<	  Specifies the "change" (editing) window.
>
	g:CtagExpl_funcref
<	  Specifies a function to be called when after the file is
	  opened for editing.
>
	g:CtagExplwinwidth
<	  specifies default CtagExpl window width
>
	g:CtagExpl_mktags
<	  by default: "mktags" -- the script to use to generate tags
>
	g:CtagExpl_pgm
<	  by default: "CtagExpl" -- the program to use to generate tags


==============================================================================
4. History						*CtagExpl-history*

v1 Oct 30, 2006 : * initial release
   Jan 02, 2009   * added |g:CtagExpl_funcref|
   Feb 22, 2011   * for menus, &go =~# used to insure correct case


==============================================================================
vim:tw=78:ts=8:ft=help