/*
 * xtags - print C-file's indexes
 *
 * Program zaliczeniowy
 * Autor: Micha Moskal (nr albumu 129934)
 *
 * $Id: README,v 1.2 2000/10/25 09:44:49 malekith Exp $
 */

Tests:

8Mb of code in 341 (linux/fs) in about 4 seconds. RSS almost con-
stant, under 480k. With the same files concated together, about 5
seconds,  RSS  incressing to about 3M. All tests on otherwise not
loaded linux 2.2.16/i686 system.

Transcription of session follows:

<1:18:fs>% pwd
/xelf/linux/fs
<1:18:fs>% find -name '*.c' | wc
    341     341    5942
<1:19:fs>% time ~/xtags/xtags `find -name '*.c'` > /dev/null
~/xtags/xtags `find -name '*.c'` > /dev/null  3.79s user 0.14s system 
100% cpu 3.919 total
<1:19:fs>% time cat `find -name '*.c'` | ~/xtags/xtags> /dev/null
cat `find -name '*.c'`  0.00s user 0.09s system 2% cpu 4.111 total
~/xtags/xtags > /dev/null  4.40s user 0.06s system 97% cpu 4.561 total
<1:20:fs>% uname -a
Linux nirvana 2.2.16 #2 Mon Dec 11 14:13:17 CET 2000 i686 pld
<1:20:fs>% cat `find -name '*.c'` | wc
 216476 1171981 8161875
<1:21:fs>%

Used software:
	- PLD Linux/GNU 1.0 Ra
	- vi (elvis 2.1)
	- gcc 2.95.3
	- GNU make 3.79.1
	- GNU troff 1.15 (used to format some help & README)
	- The Z Shell 3.1.9

And as a some kind of reference output of ./xtags -h command:

USAGE: ./xtags [-flags] [-o outfile] [file...]
  What to print:
	-f - don't include functions
	-g - don't include global objects (variables, structs)
	-d - don't include #defines
	-l - include local variables
	-k - include keywords
	-a - print everthing...
  Syntax:
	-p - allow C++ style one-line comments (//)
	-P - allow C++ keywords
  General:
	-v - be verbose, use twice to double effect
	-h - display this help
	-? -       - " -

  Output format example:
	- func() [123]: 134, 1113.
	- cpp_sym# [112]: 1112, 1112.
	- var [12]: 34.
	- printf [0]: 12, 112, 115.
   This  donates:  function  named  `func' defined in 123rd line and
   used in 134th and 1113th  lines,  preprocessor  symbol  `cpp_sym'
   #defined  in  112th  line and used two times in 1112th line, some
   variable or structure named `var', defined in 12th line and  used
   in  34th,  and  finnaly  function `printf' not defined in current
   file (hence [0]) and used in 12th, 112th and 115th lines of  cur-
   rent file...  uff... ;)

   Note  that places of defintion are only best gueses, and creative
   uses of #defines can drive this simple program mad...


