docs: Import the website and wiki and build with hotdoc

This allows us to more easily have the documentation in sync with
the source code as people will have to document new features etc
right at the time where they implement it.

1 files changed, 17 insertions, 0 deletions

diff --git a/docs/markdown/Include-directories.md b/docs/markdown/Include-directories.md
new file mode 100644
index 000000000..949bf2c5a
--- /dev/null
+++ b/docs/markdown/Include-directories.md
@@ -0,0 +1,17 @@
+# Include directories
+
+Most `C`/`C++` projects have headers in different directories than sources. Thus you need to specify include directories. Let's assume that we are at some subdirectory and wish to add its `include` subdirectory to some target's search path. To create a include directory object we do this:
+
+```meson
+incdir = include_directories('include')
+```
+
+The `incdir` variable now holds a reference to the `include` subdir. Now we pass that as an argument to a build target:
+
+```meson
+executable('someprog', 'someprog.c', include_directories : incdir)
+```
+
+Note that these two commands can be given in any subdirectories and it will still work. Meson will keep track of the locations and generate proper compiler flags to make it all work.
+
+Another thing to note is that `include_directories` adds both the source directory and corresponding build directory to include path, so you don't have to care.