This is working note for tracking activities other projects, especially activity at exuberant-ctags.

I put this as the top of this hacking guide because I consider tracking activities as the first class fruits of this project.

• status

  Revisions up to <r815> are merged except:

  NOTHING HERE NOW

  (Mon Sep 22 12:41:32 2014 by yamato)

• howto

  <svn>
  => <git: local exuberant repo>
     => <git: local exuberant repo>
  

  1. prepare your own exuberant repo: a local git repo cloned from github. You may know how to do it :)

     $ git clone https://github.com/fishman/ctags.git
     

  2. prepare exuberant SVN repo: a local git repo clone from exuberant svn tree.

  The original clone is already part of exuberant tree.

  To initialize your git repository with the required subversion information do

  $ git svn init https://svn.code.sf.net/p/ctags/code/trunk
  $ git update-ref refs/remotes/git-svn refs/remotes/origin/sourceforge
  

  and then

  $ git svn fetch
  $ git svn rebase
  

  to get the latest changes and reflect it to the local copy.

  3. merge

  TODO

  4. cherry-pick

     4.1. Make a branch at local exuberant repo and switch to it.

     4.2. Do cherry-pick like:

     $ git cherry-pick -s -x c81a8ce
     

     You can find commit id on the another terminal <git: local exuberant repo>:

     $ git log
     

     or

     $ git log --oneline
     

     If conflicts are occurred in cherry-picking, you can abort/reset cherry-picking with:

     $ git reset --hard
     

     <git: local exuberant repo>

     at the branch for picking.

<358> Vim parser: Segmentation fault when reading empty vim file

• directly contributed by the original author of bug report and patch:

  e0f854f0100e7a3cb8b959a23d6036e43f6b6c85
  

• it is fixed in sf, too:

  5d774f6022a1af71fa5866994699aafce0253085
  

<355> Error when parsing empty file (OCaml)

• fixed:

  02ec2066b5be6b129eba49685bd0b17fef4acfa
  

<341> Introducing ctags.conf.d

• merged the improved version:

  216880c5287e0421d9c49898d983144db61c83aa
  

<271> regex callback is broken; <320> [PATCH] fix regex callback match count

• merged patch (with updated bug number):

  a12b3a24b62d6535a968e076675f68bac9ad32ba
  

Tracking the tickets in patch tracker is quite fruitful. Patches are always there. So it is easy to evaluate the value:)

[(<]TICKET#[>)] TITLE

• STATUS
  • MORE STATUS

<TICKET#>

means the ticket is closed from the view of exuberant tree developers. We don't have to take time for this ticket.

(TICKET#)

means the ticket is still opened from the view of exuberant tree developers. We don't have to take time for this ticket.

<84> C++11 new using semantics

• solved by another implementation:

  c93e3bfa05b70d7fbc2539454c957eb2169e16b3
  502355489b1ba748b1a235641bbd512ba6da315e
  

<83> New full non-regex PHP parser

• contributed by the original author

<82> Support for comments in .ctags files

• contributed by the original author:

  cab4735e4f99ce23c52b78dc879bc06af66796fd
  

<81> ocaml parser segfaults on invalid files

• the bug is not reproduced

<80> Add support for falcon pl

• contributed by the original author

<67> Objective C language parser

• This is the implementation is we have in exuberant tree.

<65> absoluteFilename uses strcpy on overlapping strings

• Fixed in exuberant tree, however the ticket is still open:

  d2bdf505abb7569deae2b50305ea1edce6208557
  

<64> Fix strcpy() misuse

• Fixed in exuberant tree, however the ticket is still open:

  d2bdf505abb7569deae2b50305ea1edce6208557
  

<51> Ada support

• Ada support is now available in exuberant tree:

  4b6b4a72f3d2d4ef969d7c650de1829d79f0ea7c
  

<38> Ada support

• Ada support is now available in exuberant tree:

  4b6b4a72f3d2d4ef969d7c650de1829d79f0ea7c
  

<33> Add basic ObjC support

• This one is written in regexp.
• we have better objc parser.

(1) bibtex parser

• Reject because...

  • the owner of the ticket is anonymous.
  • the name of patch author is not written explicitly at the header of patch.

• Alternative

  https://gist.github.com/ptrv/4576213

<[Ctags] Shebang with python3 instead of python> From: Martin Ueding <dev@ma...> - 2013-01-26 18:36:32

Added python, python2 and python3 as extensions of python parser:

bb81485205c67617f1b34f61341e60b9e8030502

<[Ctags-devel] Lack of fnmatch(3) in Windows> From: Frank Fesevur <ffes@us...> - 2013-08-24 20:25:47

There is no fnmatch() in the Windows C library. Therefore a string comparison is done in fileNameMatched() in strlist.c and patterns are not recognized:

698bf2f3db692946d2358892d228a864014abc4b

<Re: [Ctags-devel] WindRes parser> From: Frank Fesevur <ffes@unns...> - 2013-08-30 21:23:50

A parser for Windows Resource files. http://en.wikipedia.org/wiki/Resource_%28Windows%29

95b4806ba6c006e4b7e72a006700e33c720ab9e7

([Ctags-devel] Skip repeat PATH_SEPARATORs in relativeFilename()) From: Seth Dickson <whefxlr@gm...> - 2013-12-24 04:51:01

Looks interesting.

Some patches are maintained in ctags package of Fedora. Inventory of patches are http://pkgs.fedoraproject.org/cgit/ctags.git/tree/ctags.spec

<ctags-5.7-destdir.patch>

This patch was merged in exuberant ctags git tree:

d4b5972427a46cbdcbfb050a944cf62b300676be

<ctags-5.7-segment-fault.patch>

This patch was merged in exuberant ctags git tree:

8cc2b482f6c7257c5151893a6d02b8c79851fedd

(ctags-5.8-cssparse.patch)

Not in exuberant tree.

The reproducer is attached to following page: https://bugzilla.redhat.com/show_bug.cgi?id=852101

However, exuberant-ctags doesn't reproduce with it.

I, Masatake YAMATO, read the patch. However, I don't understand the patch.

<ctags-5.8-css.patch>

This patch was merged in exuberant ctags git tree:

80c1522a36df3ba52b8b7cd7f5c79d5c30437a63

<ctags-5.8-memmove.patch>

This patch was merged in exuberant ctags svn tree. As the result this patch is in exuberant tree:

d2bdf505abb7569deae2b50305ea1edce6208557

<ctags-5.8-ocaml-crash.patch>

This patch was merged in exuberant ctags svn tree. As the result this patch is in exuberant tree:

ddb29762b37d60a875252dcc401de0b7479527b1

<ctags-5.8-format-security.patch>

This patch was merged in exuberant ctags svn tree. As the result this patch is in exuberant tree:

2f7a78ce21e4156ec3e63c821827cf1d5680ace8

Some patches are maintained in ctags package of Debian. Inventory of patches are http://anonscm.debian.org/cgit/users/cjwatson/exuberant-ctags.git/tree/debian/patches/series

(python-disable-imports.patch)

Not in exuberant tree.

I don't want to merge this patch. I think ctags should extract as much as possible information from input source code. The user has responsibility to filter out the noise. The definition of noise is up to the user.

<vim-command-loop.patch>

This patch was merged as an alternative for 7fb36a2f4690374526e9e7ef4f1e24800b6914ec

Discussed on universal-ctags#74

e59325a576e38bc63b91abb05a5a22d2cef25ab7

There are several interesting repo's with ctags around. These are interesting to integrate in the future.

Repo

https://github.com/geany/geany/tree/master/tagmanager/ctags

Geany has created a library out of ctags

universal-ctags#63

Their language parsers have many improvements to various parsers. Changes known by devs worth backporting:

• HTML reads <h1><h2><h3> tags
• Make has support for targets
• Various fixes for D parser (c.c), but currently the code diverges from ours to some extent.

They have these additional language parsers:

• Abaqus
• ActionScript
• AsciiDoc
• DocBook
• Ferite (c.c)
• GLSL (c.c)
• Haskell
• Haxe
• NSIS
• R
• reStructuredText (reST)
• txt2tags
• Vala (c.c)

These changes have been merged:

• Fix regex callback match count - universal-ctags#104
• SQL tags are stored with scopes instead of "tablename.field" - universal-ctags#100
• Some fixes for D parser
• C++11's enum class/struct support

VIM-Japan have some interesting things, especially regarding encoding.

Anjuta is a Gnome IDE. They did not fork Exuberant ctags, but they did natively include it in Anjuta. They have made several additions to their version of it including fairly extensive Vala language support.

Wiki

https://github.com/majutsushi/tagbar/wiki

This is a gold mine of xcmd and optlib.

Near feature exuberant-ctags can invoke external command as a specialized parser though some glue code or script may be needed. Sometimes we may have to hack the external command to adjust the interface between the command and exuberant-ctags.

So let's track external commands maintained out exuberant-ctags. If we prepare glue code or script, mark it with <>, and if not, mark it with ().

<CoffeeTags>

This is the primary target during developing xcmd feature. CoffeeTags side hacking is done.

(perl-tags)