← Back to branch summary

~ubuntu-branches/ubuntu/lucid/codelite/lucid

« back to all changes in this revision

Viewing changes to sdk/ctags/README

  • Committer: Bazaar Package Importer
  • Author(s): Chow Loong Jin
  • Date: 2009-02-10 02:27:55 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20090210022755-m5692nfc1t5uf1w9
Tags: 1.0.2759+dfsg-0ubuntu1
https://launchpad.net/bugs/327216
* New upstream release (LP: #327216).
* debian/patches/series, debian/patches/00_fix-ia64-build.patch:
  + Dropped, applied upstream already.
* debian/patches/02_fix-desktop.patch,
  debian/patches/03_fix-sh.patch:
  + Refreshed to patch cleanly.
* debian/rules:
  + Make get-orig-source honour UPSTREAM_VERSION if set.
* debian/ctags-le.1,
  debian/codelite_indexer.1,
  debian/codelite.manpages:
  + Dropped ctags-le manpage, since ctags-le was replaced by
    codelite_indexer.
  + Added codelite_indexer manpage.

Show diffs side-by-side

added added

removed removed

Lines of Context:
sdk/ctags/README
1
 
Exuberant Ctags
2
 
===============
3
 
Author: Darren Hiebert <dhiebert at users.sourceforge.net>
4
 
        http://ctags.sourceforge.net
5
 
        Instant Messaging:
6
 
          Yahoo! ID     : dbhiebert
7
 
          AIM ScreenName: darrenhiebert
8
 
 
9
 
Exuberant Ctags is a multilanguage reimplementation of the much-underused
10
 
ctags(1) program and is intended to be the mother of all ctags programs. It
11
 
generates indexes of source code definitions which are used by a number of
12
 
editors and tools. The motivation which drove the development of Exuberant
13
 
Ctags was the need for a ctags program which supported generation of tags
14
 
for all possible C language constructs (which no other ctags offers), and
15
 
because most were easily fooled by a number of preprocessor contructs.
16
 
 
17
 
 
18
 
Exuberant Ctags offers the following features:
19
 
 
20
 
1.  It supports the following languages: Assembler, AWK, ASP, BETA,
21
 
    Bourne/Korn/Z Shell, C, C++, C#, COBOL, Eiffel, Erlang, Fortran, Java, Lisp,
22
 
    Lua, Makefile, Pascal, Perl, PHP, PL/SQL, Python, REXX, Ruby, Scheme,
23
 
    S-Lang, SML (Standard ML), Tcl, Vera, Verilog, Vim, and YACC.
24
 
 
25
 
2.  It is capable of generating tags for virtually all C language constructs.
26
 
 
27
 
3.  It is very robust in parsing code. In particular, the C/C++ parser is
28
 
    far less easily fooled by code containing #if preprocessor conditional
29
 
    constructs, using a conditional path selection algorithm to resolve
30
 
    complicated situations, and a fall-back algorithm when this one fails.
31
 
 
32
 
4.  Supports output of Emacs-style TAGS files (i.e. "etags").
33
 
 
34
 
5.  User-defined languages, using Posix regular expressions.
35
 
 
36
 
6.  Supports UNIX, MSDOS, Windows 95/98/NT/2000/XP, OS/2, QNX, Amiga, QDOS,
37
 
    RISC OS, VMS, Macintosh, and Cray. Some pre-compiled binaries are
38
 
    available on the web site.
39
 
 
40
 
 
41
 
Visit the Exuberant Ctags web site:
42
 
 
43
 
    http://ctags.sourceforge.net
44
 
 
45
 
 
46
 
Which brings us to the most obvious question:
47
 
 
48
 
  Q: Why is it called "Exuberant" ctags?
49
 
  A: Because one of the meanings of the word is:
50
 
 
51
 
     exuberant : produced in extreme abundance : PLENTIFUL syn see PROFUSE
52
 
 
53
 
Compare the tag file produced by Exuberant Ctags with that produced by any
54
 
other ctags and you will see how appropriate the name is.
55
 
 
56
 
 
57
 
This source code is distributed according to the terms of the GNU General
58
 
Public License. It is provided on an as-is basis and no responsibility is
59
 
accepted for its failure to perform as expected. It is worth at least as
60
 
much as you paid for it!
61
 
 
62
 
Exuberant Ctags was originally derived from and inspired by the ctags
63
 
program by Steve Kirkendall (kirkenda@cs.pdx.edu) that comes with the Elvis
64
 
vi clone (though almost none of the original code remains). This, too, is
65
 
freely available.
66
 
 
67
 
Please report any problems you find. The two problems I expect to be most
68
 
likely are either a tag which you expected but is missing, or a tag created
69
 
in error (shouldn't really be a tag). Please include a sample of code (the
70
 
definition) for the object which misbehaves.
71
 
 
72
 
--
73
 
vim:tw=76:sw=4:et: