File: FAQ

package info (click to toggle)
global 3.55-1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 1,336 kB
  • ctags: 1,634
  • sloc: ansic: 12,863; perl: 1,670; lisp: 325; sh: 188; makefile: 95
file content (80 lines) | stat: -rw-r--r-- 2,332 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

Frequentry Asked Questions about GLOBAL.

----------------------------------------------------------------------------
Q1. Htags(1) aborts by short of memory. Why? Any workaround?

	% htags
	Out of memory!
	% _

A1. It seems that Perl4 leaks memory. If you use that version of perl,
    then you had better to use Perl5. This works well.

----------------------------------------------------------------------------
Q2. GLOBAL skip some functions.
    For example, GLOBAL skip the function 'func' in this example.

	#define M(a)	static char *string = a;

	M(a)

	func() {		<= GLOBAL skip func().
		...
	}

A2. GLOBAL cannot recognize that pattern, because M(a) seems to be
    a function definition.

    It should be follows.

	#define M(a)	static char *string = a

	M(a);			<= end with ';'

	func() {
		...
	}

    Otherwise, you can tell gtags(1) that by listing the macros in
    '.notfunction' file in current directory.

	[.notfunction]
	+---------------
	|M
	|...

----------------------------------------------------------------------------
Q3. I have set up 'global.conf' to use emacs's ctags command with GLOBAL
    but I cannot use htags.

	% gtags
	% htags
	htags: GTAGS and GRTAGS not found. Please make them.
	% ls G*
	GPATH   GTAGS

A3. Emacs's ctags cannot locate function referencies. So, gtags cannot make
    GRTAGS tag file with it. With the result that you cannot use htags and
    global's -r option.
----------------------------------------------------------------------------
Q4. Everything seems to be ok except the man page, the man program on my
    machine does not understand the manual files in GLOBAL

A4. Online manuals in GLOBAL are written with 'mandoc' macro which is a part
    of GNU groff package. You can format these manuals by following command
    line manually.

        % groff -Wall -Tascii -mandoc global.1

    If you replace your system's nroff(1) with GNU's one(nroff.sh) then
    you can use man(1) to see GLOBAL's online manuals.

----------------------------------------------------------------------------
Q5. I have built GLOBAL in WIN32 environment. But gtags(1) failed by sort
    command error.

A5. It seems that MS sort is executed. Please set your path so that unix
    sort will be executed.

----------------------------------------------------------------------------