head	1.2;
access;
symbols
	RELENG_4_11_0_RELEASE:1.1.1.1.6.1
	RELENG_4_11:1.1.1.1.6.1.0.18
	RELENG_4_11_BP:1.1.1.1.6.1
	RELENG_4_10_0_RELEASE:1.1.1.1.6.1
	RELENG_4_10:1.1.1.1.6.1.0.16
	RELENG_4_10_BP:1.1.1.1.6.1
	RELENG_4_9_0_RELEASE:1.1.1.1.6.1
	RELENG_4_9:1.1.1.1.6.1.0.14
	RELENG_4_9_BP:1.1.1.1.6.1
	RELENG_4_8_0_RELEASE:1.1.1.1.6.1
	RELENG_4_8:1.1.1.1.6.1.0.12
	RELENG_4_8_BP:1.1.1.1.6.1
	RELENG_4_7_0_RELEASE:1.1.1.1.6.1
	RELENG_4_7:1.1.1.1.6.1.0.10
	RELENG_4_7_BP:1.1.1.1.6.1
	RELENG_4_6_2_RELEASE:1.1.1.1.6.1
	RELENG_4_6_1_RELEASE:1.1.1.1.6.1
	RELENG_4_6_0_RELEASE:1.1.1.1.6.1
	RELENG_4_6:1.1.1.1.6.1.0.8
	RELENG_4_6_BP:1.1.1.1.6.1
	RELENG_4_5_0_RELEASE:1.1.1.1.6.1
	RELENG_4_5:1.1.1.1.6.1.0.6
	RELENG_4_5_BP:1.1.1.1.6.1
	RELENG_4_4_0_RELEASE:1.1.1.1.6.1
	RELENG_4_4:1.1.1.1.6.1.0.4
	RELENG_4_4_BP:1.1.1.1.6.1
	RELENG_4_3_0_RELEASE:1.1.1.1.6.1
	RELENG_4_3:1.1.1.1.6.1.0.2
	RELENG_4_3_BP:1.1.1.1.6.1
	RELENG_4_2_0_RELEASE:1.1.1.1.6.1
	RELENG_4_1_1_RELEASE:1.1.1.1
	PRE_SMPNG:1.1.1.1
	RELENG_4_1_0_RELEASE:1.1.1.1
	RELENG_3_5_0_RELEASE:1.1.1.1
	RELENG_4_0_0_RELEASE:1.1.1.1
	RELENG_4:1.1.1.1.0.6
	RELENG_4_BP:1.1.1.1
	RELENG_3_4_0_RELEASE:1.1.1.1
	RELENG_3_3_0_RELEASE:1.1.1.1
	RELENG_3_2_PAO:1.1.1.1.0.4
	RELENG_3_2_PAO_BP:1.1.1.1
	RELENG_3_2_0_RELEASE:1.1.1.1
	RELENG_3_1_0_RELEASE:1.1.1.1
	RELENG_3:1.1.1.1.0.2
	RELENG_3_BP:1.1.1.1
	v3_4_2:1.1.1.1
	GLOBAL:1.1.1;
locks; strict;
comment	@# @;


1.2
date	2000.10.15.07.01.42;	author obrien;	state dead;
branches;
next	1.1;

1.1
date	99.01.18.06.58.49;	author simokawa;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	99.01.18.06.58.49;	author simokawa;	state Exp;
branches
	1.1.1.1.6.1;
next	;

1.1.1.1.6.1
date	2000.10.16.08.53.26;	author obrien;	state dead;
branches;
next	;


desc
@@


1.2
log
@Remove GLOBAL -- it has moved to Ports.

Approved by:	unanimous response on arch@@freebsd.org (June time frame)
@
text
@
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(1) and btreeop(1) sometimes core dumps when using a large tag file.
    Any workaround?

A2. Btree(3) core dumps with a certain data set.
    Please apply the patches in this package. See ./dbpatches/README.

----------------------------------------------------------------------------
Q3. 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().
		...
	}

A3. 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
	|...

----------------------------------------------------------------------------
Q4. 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

A4. 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.
----------------------------------------------------------------------------
@


1.1
log
@Initial revision
@
text
@@


1.1.1.1
log
@Import Global v3_4_2 sources.

Ok'd by: peter
Discussed with: msmith
@
text
@@


1.1.1.1.6.1
log
@MFC: Remove GLOBAL -- it has moved to Ports.
@
text
@@

