About this clone

This is a clone of https://github.com/loarabia/Clang-tutorial .

What is differnet?

• Built against LLVM 5.0.0 (tested on Ubuntu 14.04)
• Use CMake to build
  • Making use of the cmake packages that come with LLVM, the CMakeLists.txt here is very compact.
• Win/ directory, which contains configurations for Windows Build, is removed, because I don't use it and don't know if it works correctly.

What is going on and what is this for?

If you don't know what is going on, you may want to:

• read the origin README
• read the tutorials mentioned in the origin README.
  • Particularly, https://github.com/loarabia/Clang-tutorial/wiki/TutorialOrig
    • The corresponding files are CItutorialN.cpp.

How to build this?

First, install LLVM and Clang (For me, I installed with the pre-built binaries: Clang for x86_64 Ubuntu 14.04)

Then, build this:

git clone https://github.com/fd3kyt/Clang-tutorial.git
cd Clang-tutorial
mkdir -p build/
cd build
CXX=clang++ cmake -make .. && make

If the compilation succeeds, run one of the program to confirm:

./build/CItutorial6

You should see something likes this:

input04.c:1:10: fatal error: 'stdio.h' file not found
#include <stdio.h>
         ^~~~~~~~~
Read top-level variable decl: 'a
Read top-level variable decl: 'a
Read top-level variable decl: 'b
Read top-level variable decl: 'c
Read top-level variable decl: 'funcp
Read top-level variable decl: 'fp2
Read top-level variable decl: 'fp3
Read top-level variable decl: 't

Below is the origin README

About

This is a collection of tutorials showing off how to use core Clang types. It is based directly on two older tutorials which no longer built due to code rot.

1. tutorial 1 by Nico Weber - 9/28/2008
2. tutorial 2 by Justin LaPre at Rensselaer Polytechnic Institute - 10/20/2009
3. tutorial 3 by Larry Olson - 4/14/2012

This particular set of tutorials tracks the llvm / clang mainline and is updated semi-regularly to account for llvm / clang API changes.

See contents of the links above for a walkthrough of what these tutorials are doing.

Last Update

This was last built on 5/25/2015 against
URL: http://llvm.org/svn/llvm-project/llvm/trunk
Revision:237487

Other Options

The Clang team has been hard at work making it easier to write tools using Clang. There are 4 options for developing tools using clang and llvm infrastructure.

Latest Stable LLVM / Clang (v3.4)

The master branch tracks recent commits to the clang and llvm svn. The tutorial assumes you have grabbed a copy of both llvm and clang by following these instructions and that you have modified the makefile of this project to point to the build's resulting llvm-config. If you want the latest public release, then checkout the 3.4 branch.

git clone git@github.com:loarabia/Clang-tutorial.git
git checkout 3.4

CI tutorials

The tutorials prefixed with CI are the same as the original tutorials but use the CompilerInstance object and its helper methods to perform the same tasks as the original tutorials. For the most part, this makes the code much more compact.

Tooling tutorials

These tutorials (and the clang tooling infrastrucutre) depend on having a file called compile_commands.json which defines the commands used to compile the input file. You will need to modify this file's directory field to point to the absolute path of the Clang-tutorial on your storage.

Update compile_commands.json to the directory containing input

./ToolingTutorial input04.c
./CommentHandling input04.c

Windows Build

Note on the Windows build: Currently the paths are hardcoded. Please see the SharedBuild.targets file inside of the SharedBuild project to update the path for your specific LLVM and CLANG install.

In particular, the LLVMLibsDirs property and the LLVMIncludes property should be updated.

Contact Me

For any questions, please ping me via my github account. Changes and additions are always welcome.