Build procedure on README file may needs update.

[remy-j-a-moueza]

This concerns my experience at compiling dstep on an Ubuntu Linux 12.04, 32 bits system.

Tango-D2 dependence

the last version as of June 2013 no longer compiles on dmd 2.060.
Dmd 2.061 is required.

Location of libclang.so

My build of dstep could not find libclang.so. I ran sudo ldconfig <libclang directory> to be able to run it.
Note that it can also be handled by setting the LD_LIBRARY_PATH to the directory where libclang is located.

Include path issues

On the first dstep run, clang stopped with an error telling me it could
not find "stddef.h".
A quick google search seemed to indicate that I needed to upgrade from llvm-3.1 to llvm-3.2 to automagically solve that problem but after trying it, that was not the case.

I finally figured out the include path of my system using the distribution's clang (from llvm-3.0 - incompatible with dstep):

  /usr/local/include
  /usr/include
  /usr/include/i386-linux-gnu/
  /home/ray/apps/llvm-3.2/include/clang/   # wherever is installed llvm/clang
  /usr/lib/gcc/i686-linux-gnu/4.6/include/
  /usr/lib/gcc/i686-linux-gnu/4.6/include-fixed/ 

So I ran dstep like this:

$ ~/dev/dee/dstep/bin/dstep mongoose.h -o mongoose_d.d -v \
      -I/usr/local/include \
      -I/usr/include \
      -I/usr/include/i386-linux-gnu/  \
      -I/home/ray/apps/llvm-3.2/include/clang \
      -I/usr/lib/gcc/i686-linux-gnu/4.6/include/ \
      -I/usr/lib/gcc/i686-linux-gnu/4.6/include-fixed/ 

Using on the IUP header

I ran dstep on a header file (within that header's directory) including another one located within the very same directory:

$ ls -1 
...
iupdef.h
iup.h
iupkey.h
...

I got an error telling me that the included file was not found:

$ dstep iup.h -o iup_d.d -v -I [...] 
File(823D0EC, "")iup.h:13:10: error: 'iupkey.h' file not found with <angled> include; use "quotes" instead
File(823D0EC, "")iup.h:14:10: error: 'iupdef.h' file not found with <angled> include; use "quotes" instead

I solved this by adding -I$(pwd) to the command line.