1 xref(1ONBLD) illumos Build Tools xref(1ONBLD)
2
3
4
5 NAME
6 xref - build and maintain source cross-references
7
8 SYNOPSIS
9 xref [-cfp] [-m <makefile>] [-x cscope|ctags|etags[,...]] [<subtree>
10 ...]
11
12 DESCRIPTION
13 xref is a simple tool for building and maintaining source cross-
14 references for subtrees of a workspace. By default, xref builds
15 cscope-fast, ctags, and etags (if available; see NOTES) source cross-
16 references for all of the eligible files underneath each named subtree,
17 plus any additional eligible files reported by flg.flp(1ONBLD). File
18 eligibility is determined by pattern matching -- by default, files
19 matching the following patterns are eligible:
20
21 *.[Ccdshlxy] Makefile* *.il* *.cc llib-* *.xml *.dtd.* *.ndl
118 invokes make(1) with the -e option, the value of any macros used by
119 xref.mk can be overridden through environment variables. This is
120 chiefly useful for customizing the programs used to build the cross
121 references; see EXAMPLES.
122
123 SEE ALSO
124 make(1), bringover(1ONBLD) flg.flp(1ONBLD)
125
126 NOTES
127 The etags utility is no longer bundled with the Sun Studio, which means
128 it may not be available on all developer systems. If xref cannot
129 locate the etags utility and the -x option has not been specified, then
130 xref will silently not build etags.
131
132 The ETAGS environment variable can be used to specify an alternate path
133 to the etags utility. For instance, to use the one included with
134 SUNWgnu-emacs, set ETAGS to /usr/gnu/bin/etags prior to invoking xref.
135
136
137
138 10 Aug 2009 xref(1ONBLD)
|
1 XREF(1ONBLD) illumos Build Tools XREF(1ONBLD)
2
3
4
5 NAME
6 xref - build and maintain source cross-references
7
8 SYNOPSIS
9 xref [-cfp] [-m <makefile>] [-x cscope|ctags|etags[,...]] [<subtree>
10 ...]
11
12 DESCRIPTION
13 xref is a simple tool for building and maintaining source cross-
14 references for subtrees of a workspace. By default, xref builds
15 cscope-fast, ctags, and etags (if available; see NOTES) source cross-
16 references for all of the eligible files underneath each named subtree,
17 plus any additional eligible files reported by flg.flp(1ONBLD). File
18 eligibility is determined by pattern matching -- by default, files
19 matching the following patterns are eligible:
20
21 *.[Ccdshlxy] Makefile* *.il* *.cc llib-* *.xml *.dtd.* *.ndl
118 invokes make(1) with the -e option, the value of any macros used by
119 xref.mk can be overridden through environment variables. This is
120 chiefly useful for customizing the programs used to build the cross
121 references; see EXAMPLES.
122
123 SEE ALSO
124 make(1), bringover(1ONBLD) flg.flp(1ONBLD)
125
126 NOTES
127 The etags utility is no longer bundled with the Sun Studio, which means
128 it may not be available on all developer systems. If xref cannot
129 locate the etags utility and the -x option has not been specified, then
130 xref will silently not build etags.
131
132 The ETAGS environment variable can be used to specify an alternate path
133 to the etags utility. For instance, to use the one included with
134 SUNWgnu-emacs, set ETAGS to /usr/gnu/bin/etags prior to invoking xref.
135
136
137
138 August 10, 2009 XREF(1ONBLD)
|