GNU Global manual

$global func1
DIR1/fileB.c            # func1() is defined in fileB.c

使用 -r 查找引用：

$global -r func2
../DIR1/fileA.c         # func2() is referred from fileA.c

$global 'func[1-3]'
DIR1/fileB.c            # func1, func2 and func3 are matched
DIR2/fileC.c

-x 选项显示详细信息。它类似于 ctags 的 -x 选项

$global func2
DIR2/fileC.c
$global -x func2
func2              2 DIR2/fileC.c       func2(){ i++; }
func2              4 DIR2/fileC.c       func2(){ i--; }

$global -a func1
/home/user/ROOT/DIR1/fileB.c

-s 命令用于查找未在 GTAGS 中定义的符号。

$ global -xs X
X                  1 DIR2/fileC.c #ifdef X

-g 命令定位具有指定模式的行。

$ global -xg '#ifdef'
#ifdef             1 DIR2/fileC.c #ifdef X

它类似于 egrep，但对于源代码读取来说更方便，因为它允许通过项目搜索，并且仅在源文件中搜索。 此外，可以使用各种选项：

• -O 仅在文本文件中搜索。
• -o 搜索源文件和文本文件。
• -l 仅在当前目录下搜索。

-e，-G 和 - i 选项也可用。 用法与 egrep 几乎相同。

甚至可以使用 --result=grep 选项将 global 的输出格式更改为 grep 样式。 当然，这些选项甚至可以被其他命令使用。

-P 命令定位包含指定模式的路径名。

$ global -P fileB
DIR1/fileB.c
$ global -P '1/'
DIR1/fileA.c
DIR1/fileB.c
$ global -P '\.c$'
DIR1/fileA.c
DIR1/fileB.c
DIR2/fileC.c

-f 命令在打印存在指定 tags 的文件列表。

$ global -f DIR2/fileC.c
func2              2 DIR2/fileC.c   func2(){ i++; }
func2              4 DIR2/fileC.c   func2(){ i--; }
func3              6 DIR2/fileC.c   func3(){

-l 选项限制仅在当前目录下的检索。

$cd DIR1
$ global -xl func[1-3]
func1        1 fileB.c      func1(){...}

• 编辑器中可以使用 GLOBAL 的大部分功能。
• 更智能地识别当前 token 和它的类型。
• 输入 tag 名字时进行补全。
• 支持鼠标。

首先，完成 global 的准备工作。

其次，在 emacs 中使用 global，需要加载 gtags.el 并执行 gtags-mode 函数。

将自动加载函数写入 $HOME/.emacs ，启动 Emacs 并执行 gtags-mode 函数。如果将 gtags.el 没在标准目录中，则需要将其添加到 load-path 。

$HOME/.emacs
+------------------------------------------------------p
|(setq load-path (cons "/home/owner/global" load-path))
|(autoload 'gtags-mode "gtags" "" t)

$ emacs

|
|J_:-----Mule: *scratch*       (Lisp Interaction)--L16--All----
|M-x gtags-mode[RET]
+------------------------------------------------------

如果想在进入 c-mode 时进入 gtags-mode=，将以下代码附加到你的 =$HOME/.emacs 中。

(setq c-mode-hook
      '(lambda ()
         (gtags-mode 1)
         ))

关于键映射，请参阅 gtags.el 的注释。

• 跳转 func1, 请调用 gtags-find-tag ，可以在 mini-buffer 中看到提示。然后输入 tag 名称。

      Find tag: func1			<- 'Find tag: ' is a prompt
  

• 跳转到 func1 的引用, 调用 gtags-find-rtag 。

      Find tag (reference): func1
  

• 补全 tag 名称。

  Find tag: fuTAB
  
  Find tag: func1                     <- 'nc1' is appended by emacs
  

• 如果找到了许多 tag，Emacs 会进入如下的 GTAGS SELECT MODE ：

  +-------------------------------------------------------------
  |main             347 i386/isa/ultra14f.c main()
  |main             128 kern/init_main.c   main(framep)
  |main             104 netiso/clnp_debug.c main()
  |main             164 netiso/xebec/main.c main(argc, argv)
  |
  |
  |
  |
  |
  |J_:--%*-Mule: *scratch*       (Gtags Select)--L1--All----
  |[GTAGS SELECT MODE] 4 lines
  +-------------------------------------------------------------
  

  通过任何 Emacs 命令选择一个 tag 行并按下 RET，然后可以转到 tag。当想要转到下一个或上一个 tag 时，请使用 gtags-pop-stack 返回上述模式并重新选择。

  可通过设置 gtags-path-style 变量来设置此模式下自定义路径样式：

  • root

    相对于项目的根目录（默认）。

  • relative

    相对于当前目录。

  • absolute

    绝对路径。

    有两种方法设置该变量：

    • 可以使用 Emacs 的 customize 命令动态更改。可在 Programming/Tools/Gtags 组中找到该条目。

    • 当 Emacs 使用如下所示的.emacs 文件加载时更改：

      (setq gtags-mode-hook
            '(lambda ()
               (setq gtags-path-style 'relative)))
      

• gtags-find-tag-from-here 可用。

  如果当前 token 是定义，它就等同于查找 tag 引用，否则是查找 tag 定义。

• 要找到未在 GTAGS 中定义的符号，请尝试 gtags-find-symbol。

  Find symbol: lbolt          <- 'Find symbol:' is a prompt
  

• gtags-find-with-grep 查找字符串。

  Find pattern: Copyright
  

• 可使用 POSIX 正则表达式。

  Find tag: ^put_             <- locate tags starting with 'put_'
  

• 可使用鼠标命令。

  如使用 X version Emacs, 进行如下尝试:

  将鼠标光标移至符号名称并单击中键，可以根据上下文转到其定义或引用。在 GTAGS SELECT MODE 中，将鼠标光标移动到行上，并点击中键。

  点击鼠标右键返回之前位置。

可用类似于 sh（1）的替换变量。 可以使用'$'前缀引用任何字符串变量。 例如，以下 b 的值为'XYZ'。

:a=Y:b=X${a}Z:

Tc 是一个特殊的变量; 它读入另一条记录中的定义。 它与 termcap（5）的 tc 类似。 语法如下：

tc=label[@file]

如果仅给出标签，tc 读取同文件中的标签指定的记录。 如果还给出 @file ，则从指定文件中读取标签指定的记录。 文件应该是绝对路径，不应该包含变量。 与 termcap（5）不同，可以随时随地使用 tc。

关于命令对应的变量，请参阅对应的手册。

可以将以下环境变量用作字符串变量。 如果设置了这些变量，那么在命令执行前会设置同名的环境变量。

• GREP_COLOR
• GREP_COLORS
• GTAGSBLANKENCODE
• GTAGSCACHE
• GTAGSFORCECPP
• GTAGSGLOBAL
• GTAGSGTAGS
• GTAGSLIBPATH
• GTAGSLOGGING
• GTAGSTHROUGH
• GTAGS_OPTIONS
• HTAGS_OPTIONS
• MAKEOBJDIR
• MAKEOBJDIRPREFIX
• TMPDIR

以下变量也可用作字符串变量。 默认情况下，它们都有由 configure 脚本给出的目录路径。

• bindir
• datadir
• libdir
• localstatedir
• sysconfdir

以下环境变量影响命令的执行：

• GTAGSCONF

  如果设置了该变量，使用该值对应的配置文件。

• GTAGSLABEL

  如果设置了该变量，则使用配置文件中该值对应的 label。默认是 default。