1st step in reorganization of DCT_Documentation

- improved Makefile
- common directory
- fixed layout
...

git-svn-id: https://svn.code.sf.net/p/dct/code/trunk@703 4c865b51-4357-4376-afb4-474e03ccb993

DCT_Documentation/Makefile

-# Variables
+###############
+#  Variables  #
+###############
+
+# Main documentation
 MAIN = main
-MAIN_TEXFILES  = $(wildcard $(MAIN)/*.tex)
+MAIN_TEXFILES = $(wildcard $(MAIN)/*.tex)
+
+# User manual documentation
 USER_MANUAL = user_manual
-USER_TEXFILES  = $(wildcard $(USER_MANUAL)/*.tex)
-PHOTO_FILES = $(wildcard photos/*.jpg)
-FIGURE_FILES = $(wildcard figures/*.*)
-PLOT_FILES = $(wildcard plots/*.*)
+USER_TEXFILES = $(wildcard $(USER_MANUAL)/*.tex)
+
+# Common files for each document
+COMMON    = $(wildcard common/*.tex)
 FUNCTIONS = $(wildcard functions/*.tex)
-LATEX = pdflatex
-# check if all references are there
-CHECKCITE = grep 'Citation.*undefined' main.log
-# Targets
+
+# Graphics files
+PHOTO_FILES   = $(wildcard photos/*.jpg)
+FIGURE_FILES  = $(wildcard figures/*.*)
+PLOT_FILES    = $(wildcard plots/*.*)
+GRAPHIC_FILES = $(PHOTO_FILES) $(FIGURE_FILES) $(PLOT_FILES)
+
+# Dependencies
+MAIN_DEP  = $(MAIN_TEXFILES) $(COMMON) $(FUNCTIONS) $(GRAPHIC_FILES)
+USER_DEP  = $(USER_TEXFILES) $(COMMON) $(FUNCTIONS) $(GRAPHIC_FILES)
+DOCUMENTS = $(MAIN) $(USER_MANUAL)
+
+# Shell and commands
+SHELL  = /bin/sh
+ECHO   = /bin/echo -e
+RM     = /bin/rm
+LS     = /bin/ls
+#LATEX  = pdflatex --interaction nonstopmode -shell-escape
+LATEX  = pdflatex -halt-on-error -shell-escape
+BIBTEX = bibtex
+VIEWER = evince
+
+# Check if it is needed to rerun LaTeX
+RERUN     = 'There were undefined references|Rerun to get (cross-references|citations|the bars|outlines) (right|correct)'
+# Check if all references and citations are defined 
+UNDEFINED = '(Reference|Citation) `[[:alnum:]:_-]*[[:punct:]] on page [[:digit:]]+ undefined on input line [[:digit:]]+\.|Label `[[:alnum:]:_-]*[[:punct:]] multiply defined.|Acronym `[[:alnum:]:_-]*[[:punct:]] is not defined on input line [[:digit:]]+\.'
+
+Package acronym Warning: Acronym `OAR' is not defined on input line 105.
+
+# Colors
+RED   =\033[31m
+NORMAL=\033[0m
+BOLD  =\033[1m
+
+#############
+#  Targets  #
+#############
+
+.PHONY: all main user_manual example clean reallyclean help
+
 all: $(MAIN).pdf $(USER_MANUAL).pdf
+
 main: $(MAIN).pdf
-manual: $(USER_MANUAL).pdf
-example: f_example.tex \
-	$(FUNCTIONS)
-	$(LATEX) --interaction nonstopmode f_example.tex
-	$(LATEX) --interaction nonstopmode f_example.tex	
-
-$(MAIN).pdf: $(MAIN).tex \
-	$(MAIN_TEXFILES) \
-	$(PHOTO_FILES) \
-	$(FIGURE_FILES) \
-	$(PLOT_FILES) \
-	$(FUNCTIONS) 
-	$(LATEX) --interaction nonstopmode $(MAIN).tex	
-	$(LATEX) --interaction nonstopmode $(MAIN).tex
-	
-$(USER_MANUAL).pdf: $(USER_MANUAL).tex \
-	$(USER_TEXFILES) \
-	$(PHOTO_FILES) \
-	$(FIGURE_FILES) \
-	$(PLOT_FILES) \
-	$(FUNCTIONS) \
-	main/acronyms.tex
-	$(LATEX) --interaction nonstopmode $(USER_MANUAL).tex
-	$(LATEX) --interaction nonstopmode $(USER_MANUAL).tex
-
-#%.pdf:	%.fig
-#	fig2dev -L pdf $< $@
-
-#%.pdf: src/%.dot
-#	dot -Tpdf -o $@ $<
-
-.PHONY: clean reallyclean 
+
+user_manual: $(USER_MANUAL).pdf
+
+example: f_example.tex $(FUNCTIONS)
+	@$(LATEX) $<	
+	@grep -qE $(RERUN) $(f_example).log && $(LATEX) $<
+	@grep -qE $(RERUN) $(f_example).log && $(LATEX) $<
+	@grep -qE $(RERUN) $(f_example).log && $(LATEX) $<
+	@$(call f_info,f_example)
+
+$(MAIN).pdf: $(MAIN).tex $(MAIN_DEP)
+	@$(LATEX) $<	
+	@grep -qE $(RERUN) $(MAIN).log && $(LATEX) $<
+	@grep -qE $(RERUN) $(MAIN).log && $(LATEX) $<
+	@grep -qE $(RERUN) $(MAIN).log && $(LATEX) $<
+	@$(call f_info,$(MAIN))
+
+$(USER_MANUAL).pdf: $(USER_MANUAL).tex $(USER_DEP)
+	@$(LATEX) $<
+	@grep -qE $(RERUN) $(USER_MANUAL).log && $(LATEX) $<
+	@grep -qE $(RERUN) $(USER_MANUAL).log && $(LATEX) $<
+	@grep -qE $(RERUN) $(USER_MANUAL).log && $(LATEX) $<
+	@$(call f_info,$(USER_MANUAL))
 
 clean:
-	rm -f *.bbl *.blg 
-	rm -f $(MAIN).pdf $(MAIN).toc $(MAIN).log  $(MAIN).out *.aux
-	rm -f $(USER_MANUAL).toc $(USER_MANUAL).pdf $(USER_MANUAL).log  $(USER_MANUAL).out *.aux
-	rm -f $(MAIN)/*.aux
-	rm -f $(USER_MANUAL)/*.aux
-	rm -f functions/*.aux
-	rm -f f_example.pdf
+	@$(call f_clean,$(USER_MANUAL))
+	@$(call f_clean,$(MAIN))
+	@for file in `$(LS) functions/*.aux 2> /dev/null` ; do \
+	  echo -n "- Deleting $$file ... " && $(RM) $$file ; done
+	@rm -f f_example.pdf
+
 reallyclean: clean
-	rm -f *~;\
-	rm -f *.aux *.log *.out
-	rm -f *.idx
+	@echo "Cleaning pdf files :"
+	@for proj in $(DOCUMENTS=) ; do \
+	  [ -f $$proj.pdf ] && echo -n "- Deleting $$proj.pdf ... " && \
+	  $(RM) $$proj.pdf && echo done ; done
+
+info:
+	@$(call f_info,$(USER_MANUAL))
+
+help:
+	@echo "--------------------------------------------------------------------"
+	@echo "Makefile usage:"
+	@echo "- all         : build the pdf for all documents"
+	@echo "- main        : build the pdf for the main documentation"
+	@echo "- clean       : clean intermediate files"
+	@echo "- reallyclean : clean intermediate files and resulting pdf file"
+	@echo "--------------------------------------------------------------------"
+
+###############
+#  Functions  #
+###############
+
+define f_info
+  $(ECHO) "-----------------------------------------"
+  # This work but it is ugly when undefined references
+  #if [ -f $1.blg ] ; then $(ECHO) -n "BibTeX Warnings : $(RED)" && grep '^Warning' $1.blg || $(ECHO) "$(NORMAL)None ; fi
+  #grep -iE $(UNDEFINED) $1.log || $(ECHO) "$(NORMAL)None"
+  # This work better
+  if [ -f $1.blg ] ; then $(ECHO) -n "BibTeX Warnings : " && ($(ECHO) "$(RED)"; grep '^Warning' $1.blg) | sed '$$s/^\x1b\[31m$$/\x1b[0mNone/' ; fi
+  $(ECHO) -n "$(NORMAL)Citations or references undefined : "
+  ($(ECHO) "$(RED)"; cat $1.log | tr -d '\n' | grep -Eio $(UNDEFINED)) | sed '$$s/^\x1b\[31m$$/\x1b[0mNone/'
+  $(ECHO) -n "$(NORMAL)Overfull boxes  : " && grep -E -c 'Overfull \\[hv]box'  $1.log || true
+  $(ECHO) -n "$(NORMAL)Underfull boxes : " && grep -E -c 'Underfull \\[hv]box' $1.log || true
+  $(ECHO) -n "$(BOLD)Size of $1.pdf : " && du -h $1.pdf | cut -f 1 && $(ECHO) -n "$(NORMAL)"
+  $(ECHO) "-----------------------------------------"
+endef
+
+define f_clean
+  echo "Cleaning compilation files for project : $1"
+  for ext in log aux dvi toc lot lof maf nav out snm bbl blg tns bmt idx hd spl ; do \
+    if [ -f $1.$$ext ] ; then \
+      echo -n "- Deleting $1.$$ext ... " && $(RM) $1.$$ext && echo done ; fi ; done
+  if [ -d $1 ] ; then \
+    for f in `$(LS) $1/*.aux 2> /dev/null` ; do \
+      echo -n "- Deleting $${f%.*}.aux ... " && $(RM) $${f%.*}.aux && echo "done" ; done ; fi
+  for ext in aux bbl blg ; do \
+    if [ -f $1.1.$$ext ] ; then \
+      echo -n "- Deleting $1.XXX.$$ext ... " && $(RM) $1.[0-9].$$ext $1.[0-9][0-9].$$ext && echo done ; fi ; done
+  if [ -f $1.mtc ] ; then \
+  echo -n "- Deleting $1.mtc* ... " && $(RM) $1.mtc $1.mtc[0-9]* && echo done ; fi
+endef
 

DCT_Documentation/common/Preamble.tex

+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%                        PACKAGES                      %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\usepackage[latin1]{inputenc} % use applemac if you are on an apple laptop, ansinew for Windows, but latin1 should be fine for most systems
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage{textcomp}
+\usepackage[pdftex, colorlinks=true, pdfstartview=FitV, linkcolor=red, citecolor=green, urlcolor=blue]{hyperref} % hyperlinks
+\usepackage[pdftex]{graphicx}
+\usepackage[pdftex]{color}
+\usepackage{a4}
+\usepackage{acronym} % texlive-latex-extra should be installed to compile with acronym style
+\usepackage{makeidx}
+\usepackage[all]{hypcap}
+\usepackage{appendix}
+
+\usepackage{subfigure} % OBSOLETE
+
+\usepackage{amsmath,amssymb,amsbsy} % match package, eg align statt eqnarray
+\usepackage{amsfonts} % set of miscellaneous TeX fonts that augment the standard Computer Modern set normally distributed with TeX
+%\usepackage{bm}	% to use bold greek letters % OBSOLETE / USELESS
+\usepackage{xspace} % extra spaces and lengths
+\usepackage{enumerate} % enumerate geht einfach zu aendern zb zu latein 2 anfangen
+\usepackage{multirow}
+\usepackage{longtable} % long tables over multiple pages
+%\usepackage{draftcopy} % does not work with pdflatex
+\usepackage[cm]{fullpage} % shorten margin, wider text layout
+\usepackage{listings}   % To insert code
+%\usepackage[2007/09/29]{kvsetkeys}
+%\usepackage{svn-multi}  % To interact with svn
+\usepackage{fancyhdr} % headers and footers
+%\usepackage{subcaption} % latest caption package % TOO RECENT FOR REDHAT4
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%                        SETTINGS                      %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% If you put this into your preamble, floats on pages of their own will appear at the top of the page.
+% If it's too high just take a different value than 0pt.  
+% fig or tab alone on page no longer in center
+\makeatletter
+\setlength{\@fptop}{0pt}
+\makeatother
+
+% Use \index{word} to tag special expressions \printindex will then give you word-page-index
+\makeindex
+
+\setcounter{tocdepth}{1}
+\setcounter{secnumdepth}{1}
+\uchyph=0 % stop hypenation of upper case words
+% Distance to figures in floatin environment
+%\setlength{\intextsep}{3mm plus2mm minus2mm}
+%\setlength{\abovecaptionskip}{0mm}
+%\setlength{\belowcaptionskip}{0mm}
+
+% Fix header layout and space
+\pagestyle{headings}
+\headsep=20pt
+\headheight=14.2pt
+
+% Remove all indentation
+\setlength{\parindent}{0pt}
+
+% autoref names, you can change here the default behaviour link names
+\renewcommand{\figureautorefname}{fig.}
+\newcommand{\subfigureautorefname}{fig.}
+\renewcommand{\tableautorefname}{tab.}
+\renewcommand{\chapterautorefname}{chap.}
+\renewcommand{\sectionautorefname}{sect.}
+\renewcommand{\subsectionautorefname}{subsect.}
+\renewcommand{\equationautorefname}{eq.}
+
+% Cosmetics
+\renewcommand{\setthesection}{\Alph{section}}
+\renewcommand{\labelitemi}{$\cdot$}
+\renewcommand{\labelitemii}{$\bullet$}
+\renewcommand{\labelitemiii}{$\diamond$}
+\renewcommand{\labelitemiv}{$\ast$}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%                      COMMANDS                        %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% define here useful and often used commands to shorten writing unless you define it in acronyms
+\newcommand{\dct}{Diffraction Contrast Tomography}
+

DCT_Documentation/main.tex

-\documentclass[a4paper,%
-               pagesize,%
+\documentclass[a4paper,
+               pagesize,
                DIV13,%12,% type area 
                twoside,% bookstyle, even and odd pages style different
-               openright,%			%chapter always starts on the right page
+               openright,% chapter always starts on the right page
                cleardoublepage=empty,%
                titlepage,%
                %parskip,%			
@@ -16,116 +16,40 @@
                liststotoc,%
                tocindent,%
                listsindent,%
-               abstracton,%
+               %abstracton,%
                pointlessnumbers,% srcreprt
                BCOR=15mm,	% binding correction
-               draft     %final
+               final
                %tablecaptionabove
                ]
                {scrreprt}
-               
-               
-               
-%If you put this into your preamble, floats on pages of their own will appear at the top of the page. If it's too high just take a different value than 0pt.  
-%fig or tab alone on page no longer in center
-\makeatletter
-\setlength{\@fptop}{0pt}
-\makeatother
 
-% put here the usepackage commands
-\usepackage[latin1]{inputenc}%use applemac if you are on an apple laptop, ansinew for Windows, but latin1 should be fine for most systems
-\usepackage[pdftex, colorlinks=true, pdfstartview=FitV, linkcolor=red, citecolor=green, urlcolor=blue]{hyperref} %hyperlinks
-\usepackage[pdftex]{graphicx}
-\usepackage[pdftex]{color}
-\usepackage{a4}
-\usepackage{acronym}		% texlive-latex-extra should be installed to compile with acronym style
-\usepackage{makeidx}
-\usepackage[all]{hypcap}
-\usepackage[bf, footnotesize, normal]{caption2}[2002/08/03]
-\usepackage{appendix}
-
-\usepackage{textcomp}
-\usepackage{amsmath}        %match package, eg align statt eqnarray
-\usepackage{amssymb}
-\usepackage{amsbsy}
-\usepackage{bm}				%to use bold greek letters
-\usepackage{xspace}         %extra spaces and lengths
-\usepackage{enumerate}   	%enumerate geht einfach zu aendern zb zu latein 2 anfangen
-\usepackage{amsfonts} 		%set of miscellaneous TeX fonts that augment the standard Computer Modern set normally distributed with TeX
-\usepackage{multirow}
-\usepackage{longtable} 		%long tables over multiple pages
-%\usepackage{draftcopy} does not work with pdflatex
-
-
-
-% use \index{word} to tag special expressions \printindex will then give you word-page-index
-%\makeindex
-
-\addtolength{\oddsidemargin}{-1.5cm}
-\addtolength{\evensidemargin}{-1.5cm}
-\addtolength{\textwidth}{3cm}:
-\addtolength{\topmargin}{-1.0cm}
-\addtolength{\textheight}{1.0cm}
-
-\setcounter{tocdepth}{1}
-\uchyph=0 %stop hypenation of upper case words
-%Distance to figures in floatin environment
-%\setlength{\intextsep}{3mm plus2mm minus2mm}
-%\setlength{\abovecaptionskip}{0mm}
-%\setlength{\belowcaptionskip}{0mm}
-
-
-\usepackage{fancyhdr}
-\pagestyle{headings}
-
-%define here useful and often used commands to shorten writing unless you define it in acronyms
-\newcommand{\dct}{Diffraction Contrast Tomography}
-
-
-
-%autoref names, you can change here the default behaviour link names
-\renewcommand{\figureautorefname}{fig.}
-\renewcommand{\tableautorefname}{tab.}
-\renewcommand{\chapterautorefname}{chap.}
-\renewcommand{\sectionautorefname}{sect.}
-\renewcommand{\subsectionautorefname}{subsect.}
-%\renewcommand{\equationautorefname}{eq.}
-\renewcommand{\setthesection}{\Alph{section}}
-\renewcommand{\labelitemi}{$\cdot$}
-\renewcommand{\labelitemii}{$\bullet$}
-\renewcommand{\labelitemiii}{$\diamond$}
-\renewcommand{\labelitemiv}{$\ast$}
+% All the packages, settings and commands should be put in the Preamble.tex file
+\input{common/Preamble.tex}
 
 \begin{document}
 
-	%use include only on top chapter level, in the chapters use \input{sub-file}
-
-	\include{main/titlepage}
-
-	\include{main/missing}	
-
-	\tableofcontents
-
-	\include{main/introduction}
-
-	\include{main/3DRXD}
-
-	\include{main/DCT_Setup}
-
-	\include{main/Geometry}
+  % use include only on top chapter level, in the chapters use \input{sub-file}
 
-	\include{main/FED_Strain}
+  \include{main/titlepage}
 
-	\include{main/DCT_Operation}
+  \tableofcontents
 
-	\include{main/Software}
+  \include{main/missing}
 
-	\include{main/Calibration_Measurements}
-	% put acronyms and technical terms in this chapter, they are then also available in shortform and hyperlinked via \acs{DCT},\acf{DCT},\acl{DCT}
-	\include{main/acronyms}
+  \include{main/introduction}
+  \include{main/3DRXD}
 
-	\include{main/Links}
+  \include{main/DCT_Setup}
+  \include{main/Geometry}
+  \include{main/FED_Strain}
+  \include{main/DCT_Operation}
+  \include{main/Software}
+  \include{main/Calibration_Measurements}
 
-	\include{main/bibliography}
+  % put acronyms and technical terms in this chapter, they are then also available in shortform and hyperlinked via \acs{DCT},\acf{DCT},\acl{DCT}
+  \input{common/acronyms}
+  \include{main/Links}
+  \include{main/bibliography}
 
 \end{document}

DCT_Documentation/user_manual.tex

@@ -9,7 +9,7 @@
                headsepline,%
                footsepline=false,%
                chapterprefix=false,%
-              %appendixprefix,%
+               %appendixprefix,%
                onelinecaption,%  1st line: centered, otherwise
                12pt,%
                bigheadings,%
@@ -24,99 +24,31 @@
                ]
                {scrreprt}
 
-% If you put this into your preamble, floats on pages of their own will appear at the top of the page. 
-% If it's too high just take a different value than 0pt.  
-% fig or tab alone on page no longer in center
-\makeatletter
-\setlength{\@fptop}{0pt}
-\makeatother
-
-% put here the usepackage commands
-\usepackage[latin1]{inputenc} % use applemac if you are on an apple laptop, ansinew for Windows, but latin1 should be fine for most systems
-\usepackage[pdftex, colorlinks=true, pdfstartview=FitV, linkcolor=red, citecolor=green, urlcolor=blue]{hyperref} % hyperlinks
-\usepackage[pdftex]{graphicx}
-\usepackage[pdftex]{color}
-\usepackage{a4}
-\usepackage{acronym} % texlive-latex-extra should be installed to compile with acronym style
-\usepackage{makeidx}
-\usepackage[all]{hypcap}
-\usepackage{appendix}
-
-\usepackage{subfigure}
-
-\usepackage{textcomp}
-\usepackage{amsmath} % match package, eg align statt eqnarray
-\usepackage{amssymb}
-\usepackage{amsbsy}
-\usepackage{bm}	% to use bold greek letters
-\usepackage{xspace} % extra spaces and lengths
-\usepackage{enumerate} % enumerate geht einfach zu aendern zb zu latein 2 anfangen
-\usepackage{amsfonts} % set of miscellaneous TeX fonts that augment the standard Computer Modern set normally distributed with TeX
-\usepackage{multirow}
-\usepackage{longtable} % long tables over multiple pages
-\usepackage[bf, footnotesize, normal]{caption2}[2002/08/03]
-%\usepackage{draftcopy} does not work with pdflatex
-
-\makeindex
-
-\addtolength{\oddsidemargin}{-1.5cm}
-\addtolength{\evensidemargin}{-1.5cm}
-\addtolength{\textwidth}{3cm}
-\addtolength{\topmargin}{-1.0cm}
-\addtolength{\textheight}{1.0cm}
-
-\setlength{\parindent}{0pt}
-
-\setcounter{tocdepth}{1}
-\setcounter{secnumdepth}{1}
-\uchyph=0 % stop hypenation of upper case words
-% Distance to figures in floatin environment
-%\setlength{\intextsep}{3mm plus2mm minus2mm}
-%\setlength{\abovecaptionskip}{0mm}
-%\setlength{\belowcaptionskip}{0mm}
-
-\usepackage{fancyhdr}
-\pagestyle{headings}
-
-% define here useful and often used commands to shorten writing unless you define it in acronyms
-\newcommand{\dct}{Diffraction Contrast Tomography}
+% All the packages, settings and commands should be put in the Preamble.tex file
+\input{common/Preamble.tex}
 
+\begin{document}
 
+  % use include only on top chapter level, in the chapters use \input{sub-file}
 
-% autoref names, you can change here the default behaviour link names
-\renewcommand{\figureautorefname}{fig.}
-\renewcommand{\tableautorefname}{tab.}
-\renewcommand{\chapterautorefname}{chap.}
-\renewcommand{\sectionautorefname}{sect.}
-\renewcommand{\subsectionautorefname}{subsect.}
-\renewcommand{\equationautorefname}{eq.}
-\renewcommand{\setthesection}{\Alph{section}}
-\renewcommand{\labelitemi}{--}
-\renewcommand{\labelitemii}{$\bullet$}
-\renewcommand{\labelitemiii}{$\diamond$}
-\renewcommand{\labelitemiv}{$\ast$}
+  \include{user_manual/titlepage}
 
+  \tableofcontents
 
-\begin{document}
+  \include{user_manual/missing}
 
-	% use include only on top chapter level, in the chapters use \input{sub-file}
-	\include{user_manual/titlepage}
+  \include{user_manual/General_introduction}
+  \include{user_manual/Setup}
+  \include{user_manual/Preprocessing}	
+  \include{user_manual/Segmentation}
+  \include{user_manual/Matching}
+  \include{user_manual/Indexing}
+  \include{user_manual/ForwardSimulation}
+  \include{user_manual/Reconstruction}
+  \include{user_manual/Visualization}
 
-	\tableofcontents
-	
-	\include{user_manual/missing}
-	
-	\include{user_manual/General_introduction}
-	\include{user_manual/Setup}
-	\include{user_manual/Preprocessing}	
-	\include{user_manual/Segmentation}
-	\include{user_manual/Matching}
-	\include{user_manual/Indexing}
-	\include{user_manual/ForwardSimulation}
-	\include{user_manual/Reconstruction}
-	\include{user_manual/Visualization}
-        \include{main/acronyms}
-        % put acronyms and technical terms in this chapter, they are then also available in shortform and hyperlinked via \acs{DCT},\acf{DCT},\acl{DCT}
-	%\include{texfiles/bibliography} % not used at the moment	
+  % Put acronyms and technical terms in this chapter, they are then also available in shortform and hyperlinked via \acs{DCT},\acf{DCT},\acl{DCT}
+  \input{common/acronyms}
+  %\include{texfiles/bibliography} % not used at the moment	
 
 \end{document}

DCT_Documentation/user_manual/titlepage.tex

-\begin{titlepage}
+%\begin{titlepage}
 
-\begin{titlepage}
+%  \pagestyle{empty}
+%  \begin{center}
 
-  \pagestyle{empty}
-  \begin{center}
+%    \vspace*{3cm}
+%    {\Huge DCT User Manual}
 
-    \vspace*{3cm}
-    {\Huge DCT User Manual}
+%    \vspace*{1cm}
+%    Compiled on: \today\par
+%    % Don't edit the following line (especially between $s because it is automatically put by SVN
+%    %Subversion $ $Rev$ $
 
-    \vspace*{1cm}
-    Compiled on: \today\par
-    % Don't edit the following line (especially between $s because it is automatically put by SVN
-    %Subversion $ $Rev$ $
+%    \vspace{2cm}
 
-    \vspace{2cm}
+%    {\it editors}\par
 
-    {\it editors}\par
+%    \vspace{5mm}
 
-    \vspace{5mm}
+%    % Add your name here if you contribute
+%    Y. Guilhem, A. King, W. Ludwig, L. Nervo, N. Vigano, P. Reischig, S. Schmiederer 
 
-    % Add your name here if you contribute
-    Y. Guilhem, A. King, W. Ludwig, L. Nervo, N. Vigano, P. Reischig, S. Schmiederer 
-    
-  \end{center}
+%  \end{center}
 
-\end{titlepage}
+%\end{titlepage}
 
 
 
-\end{titlepage}
+\title{DCT User Manual\\[1em]Compiled on: \today}
+
+\author{Y. Guilhem \and A. King \and W. Ludwig \and L. Nervo \and N. Vigano \and P. Reischig \and S. Schmiederer}
+
+%\date{}
+
+\maketitle