[Ctags] Pb generating tags for 11g OCI headers

[Dominique D. <dde...@gm...>]

Hi community,

I've been using ctags + vim for a while now, with no particular
issues, but today I'm stumped trying to generate the tags file for all
C headers of OCI, the Oracle Call Interface API for Oracle DB 11g.

My usual command of "ctags  --extra=f -R ." generates the tags file
OK, but I'm missing tags to function prototypes from the ociap.h file.
For example, the only reference to OCIHandleAlloc in the tags file is
from oci.h, which is only a #define OCIHandleAlloc ocighndl inside a
#ifdef SLSHORTNAME block, when the reference I'm interested in is in
ociap.h and reads:

sword   OCIHandleAlloc(const void  *parenth, void  **hndlpp, const ub4 type,
                       const size_t xtramem_sz, void  **usrmempp);

Thus, when I ":ta OCIHandleAlloc" in vim, I end up in oci.h at the
line of the define, and no ":tn" takes me to ociap.h for the actual
prototype.

Note that ociap.h is processed correctly, as all typedefs from this
file are properly "tagged". It's all the function prototypes which are
somehow ignored.

I then tried to RTFM, and tried various combinations of --C-kinds=+px
and --C++-kinds=+px and --language-force=C, all the no avail. (I tried
--c-kinds and --c++-kinds too, but case doesn't seem to matter). If I
read the doc correctly, the +p should have added function prototypes
are code to tag, but that doesn't seem to work for me.

Can anyone help me understand what's going on here please?

Thanks, --DD

C:\oracle\product\11.1.0\db_1\OCI\include>ctags --version
Exuberant Ctags 5.6, Copyright (C) 1996-2004 Darren Hiebert
  Compiled: Jul 30 2006, 16:12:20
  Addresses: <dhi...@us...>, http://ctags.sourceforge.net
  Optional compiled features: +win32, +regex, +internal-sort