diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 0000000..494f28a
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,4 @@
+*.texi
+usermanual.txt
+usermanual.pdf
+*.sw?
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..c208358
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,42 @@
+# XSL stylesheets downloaded from http://docbook.sourceforge.net/release/xsl/current/html/
+# Makefile from BitBake/OpenEmbedded manuals
+
+topdir = .
+manual = $(topdir)/usermanual.xml
+# types = pdf txt rtf ps xhtml html man tex texi dvi
+# types = pdf txt
+types = $(docbooktotypes)
+docbooktotypes = pdf txt
+# htmlcssfile =
+# htmlcss =
+cleanfiles = $(foreach i,$(types),$(topdir)/$(i))
+
+ifdef DEBUG
+define command
+ $(1)
+endef
+else
+define command
+ @echo $(2) $(3) $(4)
+ @$(1)
+endef
+endif
+
+all: $(types)
+
+lint: $(manual) FORCE
+ $(call command,xmllint --xinclude --postvalid --noout $(manual),XMLLINT $(manual))
+
+$(types): lint FORCE
+
+
+$(docbooktotypes): $(manual)
+ $(call command,docbook2$@ $(manual),DOCBOOK2 $@ $(manual))
+
+clean:
+ rm -rf $(cleanfiles)
+
+$(foreach i,$(types) $(foreach type,$(htmltypes),$(type)-nochunks),clean-$(i)):
+ rm -rf $(patsubst clean-%,%,$@)
+
+FORCE:
diff --git a/docs/README b/docs/README
new file mode 100644
index 0000000..0a70c26
--- /dev/null
+++ b/docs/README
@@ -0,0 +1,9 @@
+This should be our user manual, it is created using docbook and
+can be compiled by either. Patches for additional sections are
+more than welcome.
+
+$ make
+
+or
+
+$ dblatex usermanual.tex
diff --git a/docs/chapters/appendix.xml b/docs/chapters/appendix.xml
new file mode 100644
index 0000000..2f684a3
--- /dev/null
+++ b/docs/chapters/appendix.xml
@@ -0,0 +1,9 @@
+
+
diff --git a/docs/chapters/building.xml b/docs/chapters/building.xml
new file mode 100644
index 0000000..7c4c9ac
--- /dev/null
+++ b/docs/chapters/building.xml
@@ -0,0 +1,8 @@
+
+
+ Getting and Building the Software
+
+ Installing Dependencies
+
+
+
diff --git a/docs/chapters/introduction.xml b/docs/chapters/introduction.xml
new file mode 100644
index 0000000..885d7c4
--- /dev/null
+++ b/docs/chapters/introduction.xml
@@ -0,0 +1,8 @@
+
+
+ Introduction
+
+
diff --git a/docs/chapters/using.xml b/docs/chapters/using.xml
new file mode 100644
index 0000000..f0afd30
--- /dev/null
+++ b/docs/chapters/using.xml
@@ -0,0 +1,20 @@
+
+
+ Sniffing your SIM
+
+
+ Launching SIMtrace
+
+
+$ simtrace
+
+
+
+
+ Launching Wireshark
+
+
+$ wireshark
+
+
+
diff --git a/docs/usermanual.xml b/docs/usermanual.xml
new file mode 100644
index 0000000..8ff39ad
--- /dev/null
+++ b/docs/usermanual.xml
@@ -0,0 +1,46 @@
+
+
+
+
+
+
+]>
+
+
+
+
+
+ 0.0.1
+ 12 July 2011
+ z
+ Initial
+
+
+
+ SIMtrace Usermanual
+
+
+ 2011
+
+
+
+ This work is licensed under a Creative Commons Attribution 3.0
+ Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/
+ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford,
+ California 94305, USA.
+
+
+
+
+ &chapter-introduction;
+ &chapter-using;
+ &chapter-building;
+
+ &chapter-appendix;
+