9 files changed, 131 insertions, 134 deletions

diff --git a/Master/texmf-dist/doc/latex/sapthesis/README b/Master/texmf-dist/doc/latex/sapthesis/README
index 3e38b95ae67..38e07b53b86 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/README
+++ b/Master/texmf-dist/doc/latex/sapthesis/README
@@ -10,7 +10,7 @@
 
 ** License **********************************************************
 
-      Copyright (c) 2008-2013 by Francesco Biccari.
+      Copyright (c) 2008-2015 by Francesco Biccari.
 
       This work (specified below) may be distributed and/or
       modified under the conditions of the 
@@ -27,7 +27,7 @@
       The "Sapienza - University of Rome" logo is a registered
       trademark of "Sapienza" university. The logo can be used
       only according to the "Protocollo per l'uso del
-      marchio/logotipo e del sistema di identità visiva della
+      marchio/logotipo e del sistema di identità visiva della
       Sapienza" document available, with other information,
       at the following link (in italian):
       http://www.uniroma1.it/ateneo/chi-siamo/identit%C3%A0-visiva-e-marchio
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.tex
index edbf2252da5..6bddec4d07d 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.tex
@@ -1,6 +1,6 @@
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = it_IT
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
 
 \documentclass[Lau,binding=0.6cm]{sapthesis}
 
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex
index 4be77e41543..938f879b62f 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex
@@ -1,6 +1,6 @@
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = it_IT
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
 
 \documentclass[LaM,binding=0.6cm]{sapthesis}
 
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex
index 1b1a3f04723..b615b1a10f7 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex
@@ -1,6 +1,6 @@
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = it_IT
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
 
 \documentclass[MasterS,binding=0.6cm]{sapthesis}
 % use MasterP option, instead of MasterS, for a ``Master di primo livello''
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex
index 6a62de2f6f8..cb7d76dd961 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex
@@ -1,6 +1,6 @@
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = en_US
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
 
 \documentclass[PhD,binding=0.6cm]{sapthesis}
 
@@ -184,7 +184,7 @@ In this manual you can skip the gray text because it is just dummy text.
 
 There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
 \begin{equation}
-\der{f}{x} \qquad \pder[2]{f}{y}
+\der{f}{x} \qquad \pder{f}{*{2}{x},y}
 \end{equation}
 
 
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex
index f80f90ec4ce..0a9fb6c318a 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex
@@ -1,6 +1,6 @@
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = en_US
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
 
 \documentclass[Specialization,binding=0.6cm]{sapthesis}
 
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex
index 9892edbd2cc..ec0a1bb4799 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex
@@ -1,6 +1,6 @@
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = it_IT
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
 
 \documentclass[TFA,oneside]{sapthesis}
 
diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf
index 0729b6b9913..0994b27bc66 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf
+++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex
index d5e21735c79..9afe86e72c7 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex
@@ -1,6 +1,7 @@
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = en_US
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
+
 
 \documentclass[a5paper,11pt]{article}
 
@@ -52,7 +53,7 @@
 \author{\small Francesco Biccari\thanks{\href{mailto:biccari@gmail.com}{biccari@gmail.com}}}
 \title{\small Documentation of the \LaTeX\ class\\
 		\Large \textbf{\texttt{sapthesis.cls}}\\
-		\small \vspace{0.2cm} Version 3.7, 2013-07-20
+		\small \vspace{0.2cm} Version 3.8, 2015-12-04
 }
 \date{}
 
@@ -141,6 +142,7 @@ In those files the page layout and the layout choices are explained.
 I would like to thank the Italian \TeX\ user group (\href{http://www.guitex.org/}{GuIT}) for the help provided, in particular Enrico Gregorio and Claudio Beccari. I would also thank all the users who reported bugs and suggestions.
 
 \section[Requirements\\ and installation]{Requirements and installation}
+\label{requirements_installation}
 
 The simplest way to install \textsf{sapthesis} is by the package manager of 
 your \TeX\ distribution (\TeX\ Live or MiK\TeX). For manual installation see 
@@ -172,7 +174,7 @@ As usual, in order to use this class, you need to call it by
 \begin{lstlisting}
 \documentclass[|\textit{\texttt{options}}|]{sapthesis}
 \end{lstlisting}
-You have to specify the class options for your case (see Sec.~\ref{class_options}). Then you have to provide some fundamental information (title, author, etc\ldots) by specific commands (see Sec.~\ref{commands_titlepage}). Finally remember to follow a source code structure similar to those of the examples given in App.~\ref{sec:PhDexample} and~\ref{sec:LaMexample}.
+You have to specify the class options for your case (see Sec.~\ref{class_options}). Then you have to provide some fundamental information (title, author, etc\ldots) by specific commands in the preamble (see Sec.~\ref{commands_titlepage}). Finally, remember to follow a source code structure similar to those of the examples given in App.~\ref{sec:PhDexample} and~\ref{sec:LaMexample}.
 Especially the usage of the commands \texttt{\bs frontmatter}, \texttt{\bs mainmatter} and \texttt{\bs backmatter} is mandatory, otherwise the page style of the document will be wrong!
 
 This class supports, at the moment, two languages: Italian and English. English is the default.
@@ -181,7 +183,7 @@ If your thesis contains only English or very few paragraphs in another language,
 
 \subsection{Class options}
 \label{class_options}
-The following options can be passed to the documentclass command.
+The following options can be passed to the \texttt{\bs documentclass} command.
 
 \begin{description}
 \item[\texttt{PhD}] Option to typeset a \textit{Dottorato di Ricerca} (PhD) thesis.
@@ -203,13 +205,15 @@ The following options can be passed to the documentclass command.
 \item[\texttt{binding=\textsl{length}}] (zero default binding)
 The value of this option is an offset of the text column.
 It is useful to take into account the margin for the binding (ask to your bookbinder for information).
-\item[\texttt{noexaminfo}] Remove the final exam informations.
+\item[\texttt{noexaminfo}] Suppress all the final exam informations. Indeed, by default, \textsf{sapthesis} shows some information about the final thesis discussion on the back of the title page. By default it shows the phrase ``Thesis not yet defended''. Otherwise, as explained later, giving the commands 
+\texttt{\bs examdate\{\dots\}} and \texttt{\bs examiner\{\dots\}} the date and
+the examiners list are shown.
 \item[\texttt{italian} or \texttt{english}] Explicitly declare the language of 
 the title page. Useful when you want to write the title page in a language 
 and the thesis in a different language.
 \item[\texttt{nodefaultfont}] Avoid the loading of packages \textsf{fontenc}, \textsf{textcomp} and \textsf{lmodern}.
 \item[\texttt{romandiff}] See App.~\ref{sec:usefulcommands}.
-\item[\texttt{fem}] Use the feminine (only Italian): ``candidata'' instead of ``candidato''.
+\item[\texttt{fem}] Use the feminine (only Italian): shows ``candidata'' instead of ``candidato''.
 \end{description}
 
 \subsection[Commands for the\\ title page]{Commands for the title page}
@@ -229,8 +233,6 @@ in the preamble.
 
 \item[\texttt{\bs courseorganizer\{\dots\}}] Mandatory.
 
-\item[\texttt{\bs cycle\{\dots\}}] Mandatory only for PhD's. Use the form: \texttt{\bs cycle\{XXII\}}
-
 \item[\texttt{\bs submitdate\{\dots\}}] Mandatory. Use the form \texttt{\bs submitdate\{April 2009\}} for PhD's and the form \texttt{\bs submitdate\{2009/2010\}} for Laurea theses.
 
 \item[\texttt{\bs AcademicYear\{\dots\}}] Alias for \texttt{\bs submitdate}.
@@ -245,30 +247,33 @@ If you have more than one advisor, put several advisor commands in the correct o
 \item[\texttt{\bs coadvisor\{\dots\}}] Optional. Co-advisors of the thesis. 
 Same syntax of the \texttt{\bs advisor} command. 
 
-\item[\texttt{\bs tutor\{\dots\}} and \texttt{\bs tutorcoord\{\dots\}}] Only for TFA. Mandatory.
-
-\item[\texttt{\bs director\{\dots\}}] Only for Specialization. Mandatory.
-
 \item[\texttt{\bs authoremail\{\dots\}}] Mandatory. Email of the thesis author.
 It is automatically hyper-linked if \textsf{hyperref} package is loaded.
 
-\item[\texttt{\bs examdate\{\dots\}}] Optional. Date of the final exam. 
-Use the form\\ \texttt{\bs examdate\{16 February 2010\}}.
+\item[\texttt{\bs versiondate\{\dots\}}] Optional. Date version of the thesis.
+
+\item[\texttt{\bs website\{\dots\}}] Optional. Thesis website. Automatically 
+hyper-linked if \textsf{hyperref} package is loaded.
+
+\item[\texttt{\bs ISBN\{\dots\}}] Optional. ISBN
+
+\item[\texttt{\bs examdate\{\dots\}}] Optional. Date of the final exam.\\
+Example: \texttt{\bs examdate\{16 February 2010\}}.
 
 \item[\texttt{\bs examiner\{\dots\}}] Optional. Specifies the members of the
 board of examiners of the final exam. Usage similar to \texttt{\bs advisor} command.
 
+\item[\texttt{\bs cycle\{\dots\}}] Mandatory only for PhD's. Use the form: \texttt{\bs cycle\{XXII\}}
+
+\item[\texttt{\bs director\{\dots\}}] Only for Specialization. Mandatory.
+
+\item[\texttt{\bs tutor\{\dots\}} and \texttt{\bs tutorcoord\{\dots\}}] Only for TFA. Mandatory.
+
 \item[\texttt{\bs schoolname\{\dots\}}] Only for TFA. Mandatory. Name of the school.
 \item[\texttt{\bs schooladdress\{\dots\}}] Only for TFA. Mandatory. School's address.
 \item[\texttt{\bs schoolwebsite\{\dots\}}] Only for TFA. Optional. School's website.
 \item[\texttt{\bs schoolprincipal\{\dots\}}] Only for TFA. Mandatory. School's principal.
 
-\item[\texttt{\bs versiondate\{\dots\}}] Optional. Date version of the thesis.
-
-\item[\texttt{\bs website\{\dots\}}] Optional. Thesis website. Automatically 
-hyper-linked if \textsf{hyperref} package is loaded.
-
-\item[\texttt{\bs ISBN\{\dots\}}] Optional. ISBN
 \end{description}
 
 
@@ -298,7 +303,7 @@ This color is switched to black if the \texttt{bn} option is in use. Example of
 
 \item Do \textbf{not} change the default layout and do \textbf{not} use packages which can modify the layout of your thesis. However if you want to change the interline spacing, do not use the \texttt{\bs linespread} command. Load instead the \textsf{setspace} package and use the \texttt{\bs onehalfspacing} command.
 
-\item Do \textbf{not} load the following packages in the preamble of your document because already loaded by \textsf{sapthesis}: \textsf{xkeyval}, \textsf{geometry}, \textsf{ifxetex}, \textsf{xltxtra}, \textsf{fontenc}, \textsf{textcomp}, \textsf{lmodern}, \textsf{caption}, \textsf{graphicx}, \textsf{color}, \textsf{booktabs}, \textsf{amsmath}, \textsf{fancyhdr}.
+\item Do \textbf{not} load the packages already loaded by \textsf{sapthesis} (see Sec.~\ref{requirements_installation}).
 
 \item As you already should know, \LaTeX\ can process only documents
 in pure ASCII. If you want to insert \emph{directly} other characters, not included in the 128 ASCII
@@ -327,7 +332,7 @@ is not very professional. The dedication should be enough.
 \item Usually tables and figures are centered. Remember that, according to the typographic rules, the table captions should be placed \textbf{above} the table, whereas the figure caption should be placed \textbf{below} the figure.
 
 \item If the figure has a small width, it is possible to put the figure caption
-aside the figure using the \texttt{sidecap} package (not preloaded in \texttt{sapthesis.cls}).
+aside the figure using the \texttt{sidecap} package (not preloaded by \textsf{sapthesis}).
 
 \item Avoid the use of colors unless really necessary. Remember that the figures should be readable even if they are printed in gray scale!
 
@@ -335,51 +340,97 @@ aside the figure using the \texttt{sidecap} package (not preloaded in \texttt{sa
 
 \item The name of operators should be typed in roman. Example: use $\sin$ (\texttt{\$\bs sin\$}) instead of $sin$ (\texttt{\$sin\$}).
 
-\item The margin notes are rarely used in scientific documents and should \textbf{not} be used in a thesis.
+\item The margin notes are rarely used in scientific documents and should \textbf{not} be used in a scientific thesis.
 
 \item Do not divide the bibliography per chapter unless it is \textbf{really} necessary.
 This will save you from wasting a lot of time to prepare your \LaTeX\ source code.
 Order your bibliography alphabetically according to the
-first author surname: this order is very useful, contrary to the other typical order, the citation order. In this regard
-I recommend the usage of the \texttt{backref} package.
+first author surname: this order is very useful, contrary to the other typical order, the citation order.
 
 \end{itemize}
 
 
+\appendix
+
+\section{A very brief introduction to the \TeX\ world}
 
-% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
-\addcontentsline{toc}{section}{\refname}
-\begin{thebibliography}{9}
-\item[]
-\hskip-\leftmargin
-\begin{minipage}{\textwidth}
 Many people want to (or are compelled to) write in \LaTeX\ without studying
-a basic manual. Here follows a brief list of documents, especially useful for
-italian students.
-\end{minipage}
-\medskip
-\bibitem{Pantieri_Arte}
-\href{http://www.lorenzopantieri.net/LaTeX_files/ArteLaTeX.pdf}{\textsc{L. 
-Pantieri \& T. Gordini}, \textit{L'arte di scrivere con \LaTeX}, (2012)}
+a basic manual. Here follows a very brief introduction to the \TeX\ world.
+
+\TeX, the document preparation system designed by Donald Knuth in 1978, is a program to typeset documents.
+It is a mark-up language: you write a simple text decorated with \TeX\ commands (source code) which is then compiled to obtain the final product, a document in pdf format. 
+\LaTeX\ is just a set of macros, written in \TeX, to simplify the writing of the source code: it can be thought as a simpler programming language with respect to \TeX. A source code written in \LaTeX\ can be compiled by several ``compilers'': \texttt{pdflatex} (the most common), or \texttt{xelatex}, or others.
+
+The following list of \LaTeX\ manuals, may be especially useful for Italian authors.
+
+\begin{itemize}
+\item \href{http://www.lorenzopantieri.net/LaTeX_files/ArteLaTeX.pdf}{\textsc{L. 
+Pantieri \& T. Gordini}, \textit{L'arte di scrivere con} \LaTeX, (2012)}
+
+\item \href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive} \LaTeX\ \textit{symbol list}, (2015)}
+
+\item \href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \LaTeX\textit{: breve guida ai pacchetti di uso pi\`u comune}, (2010)}
+\end{itemize}
+
+In order to use \LaTeX, you have to install a \TeX\ distribution. It contains the compilers, several fonts and other files needed by the compilers and also many \emph{packages}, which can be thought as libraries or extensions of \LaTeX. The most famous distributions are \href{http://miktex.org/}{MiKTeX} (available only for Windows), \href{http://www.tug.org/texlive/}{TeX Live} (available both for Windows and Linux) and \href{http://www.tug.org/mactex/2011/}{MacTeX} (available only for Mac OS).
+
+Finally we discuss the editor, that is the program used to write your source file. Since a source file written in \LaTeX, like in any other programming language, is a simple text file, you can write your code with any text editor you want (for example Notepad in Windows). However the suggested editors are:
+\begin{itemize}
+\item \href{http://tug.org/texworks/}{TeXworks}. Already installed with any \TeX\ distribution. Very simple and powerful. Use TeXworks if you are not an expert. Enrico Gregorio has written a very good and brief TeXworks manual in Italian, which can be found at: {\small \url{http://profs.sci.univr.it/~gregorio/egtex.html}}.
+
+\item \href{http://texstudio.sourceforge.net/}{TeXstudio} (cross-platform), \href{http://www.xm1math.net/texmaker/}{TeXmaker} (cross-platform), \href{http://pages.uoregon.edu/koch/texshop/}{TeXshop} (only for Mac), \href{http://kile.sourceforge.net/}{Kile} (only for Linux). Powerful editors.
+
+\item \textbf{Avoid} other editors unless you know what you are doing!
+
+\end{itemize}
+
+Finally we explain how to compile the example documents provided in the \textsf{sapthesis} package. Double click on one of the \texttt{.tex} file in the \texttt{examples} folder. 
+TeXworks should start showing the content of that file. 
+The \texttt{pdflatex} compiler should be automatically selected thanks to the \emph{magic lines} placed at the beginning of the file.
+Now, in order to compile, press the green button. 
+At the end of the compilation the resulting pdf appears in a separate window. Remember to compile at least three times, because \LaTeX\ needs more than one compilation to correctly resolve the internal cross references (for example for the table of contents composition, or when you refer to a figure by the \texttt{\bs label}\,--\,\texttt{\bs ref}\,/\,\texttt{\bs pageref} mechanism).
+
+
+
+\section{Using LyX}
+
+LyX is an advanced \LaTeX\ editor which does not simply show the source code like any text editor, but instead it renders maths, images, tables and some text formatting commands. However this ``layer'' between the writer and the real source code is sometimes frustrating and many authors discourage the usage of LyX.
+
+Using \textsf{sapthesis} with LyX is quite straightforward.
+\begin{itemize}
+\item
+Install \textsf{sapthesis} by the package manager of your \TeX\ distribution or manually.
+
+\item
+Copy the file \texttt{sapthesis.layout} in the directory\\ \texttt{C:\bs Program Files\bs Lyx20\bs Resources\bs layouts\bs}\\ and then, in LyX, click on \textsf{Tools > Reconfigure}. This will add the \textsf{sapthesis} class in the list of LyX available classes.
+
+\item
+In LyX, first of all, go in \textsf{Tools > Preferences > Language Settings > Language} and choose ``none'' in Language package. This step is necessary because LyX not only loads babel with the desired language, but it passes the language also as an option for the class! This triggers an error in many classes.
+
+\item 
+Create a new document and go in \textsf{Document > Settings > Document Class}. Here you can choose \textsf{sapthesis} as the class for the document and write the class options.
+
+\item 
+Write the preamble in \textsf{Document > Settings > LaTeX Preamble}.
+
+\item Create the titlepage inserting the title by the \textsf{Title} item in the LyX left menu.
+
+\end{itemize}
+
+It is recommended to activate \textsf{View > Source Pane}. This step is not necessary but it is very useful to observe the \LaTeX\ code produced by LyX (on the right choose ``Complete source'' or ``Preamble'').
 
-\bibitem{Pakin_Symbol}
-\href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive \LaTeX\ symbol list}, (2009)}
 
-\bibitem{Gregorio_Pacchetti}
-\href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \textit{\LaTeX: breve guida ai pacchetti di uso pi\`u comune}, (2010)}
-\end{thebibliography}
 
 
-\appendix
 
 \clearpage
 \section{PhD thesis example}
 \label{sec:PhDexample}
 
 \begin{lstlisting}
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = en_US
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
 
 \documentclass[binding=0.6cm,PhD]{sapthesis}
 
@@ -431,9 +482,9 @@ This thesis deals with myself.
 \label{sec:LaMexample}
 
 \begin{lstlisting}
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = it_IT
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
 
 \documentclass[binding=0.6cm,Lau]{sapthesis} % LaM for a Laurea Magistrale
 
@@ -486,9 +537,9 @@ Questa tesi parla di me.
 \label{sec:TFAexample}
 
 \begin{lstlisting}
-% !TEX encoding = UTF-8
-% !TEX program = pdflatex
-% !TEX spellcheck = it_IT
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
 
 \documentclass[binding=0.6cm,TFA]{sapthesis}
 
@@ -546,9 +597,11 @@ Questa tesi parla di me.
 
 \item[\texttt{\bs iu}] Imaginary unit, $\mathrm{i}$,  in roman.
 
-\item[\texttt{\bs der[\dots]\{\dots\}\{\dots\}}] Derivative. The optional parameter is the order of the derivative. The following two arguments are the numerator and the denominator. The differential symbol is automatically inserted.
+\item[\texttt{\bs der\{\dots\}\{\dots\}}] Derivative. The first argument represents the function to derive while the second the variables separated by commas. The differential symbol is automatically inserted. Examples:
+\texttt{\bs der\{f\}\{x\}}, \texttt{\bs der\{f\}\{x,y\}}, \texttt{\bs der\{f\}\{*\{3\}\{x\}\}}, 
+\texttt{\bs der\{f\}\{*\{2\}\{x\},*\{2\}\{y\},z\}}.
 
-\item[\texttt{\bs pder[\dots]\{\dots\}\{\dots\}}] Partial derivative. Same as above
+\item[\texttt{\bs pder\{\dots\}\{\dots\}}] Partial derivative. Same syntax of the \texttt{\bs der} command.
 
 \item[\texttt{\bs rb\{\dots\}}] Roman suBscript
 
@@ -583,62 +636,6 @@ For heavy usage of measurement units and to insert numbers in the form
 \end{description}
 
 
-\section{A very brief introduction to the \TeX\ world}
-
-\TeX, the document preparation system designed by Donald Knuth in 1978, is a program to typeset documents.
-It is a mark-up macro language: you write a source text decorated with \TeX\ commands, which is then compiled to obtain the final product, a document in pdf format in our case. 
-\LaTeX\ is just a set of macros written in \TeX\ to simplify the writing of the source text: you can think about it as a simpler programming language with respect to \TeX. A source code written in \LaTeX\ can be compiled by several ``compilers': \texttt{pdflatex} (the most common), or \texttt{xelatex}, or others. The following list of \LaTeX\ manuals, may be especially useful for Italian authors.
-
-\begin{itemize}
-\item \href{http://www.lorenzopantieri.net/LaTeX_files/ArteLaTeX.pdf}{\textsc{L. 
-Pantieri \& T. Gordini}, \textit{L'arte di scrivere con} \LaTeX, (2012)}
-
-\item \href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive} \LaTeX\ \textit{symbol list}, (2009)}
-
-\item \href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \LaTeX\textit{: breve guida ai pacchetti di uso pi\`u comune}, (2010)}
-\end{itemize}
-
-In order to use \LaTeX, you have to install a \TeX\ distribution. It contains the compilers, several fonts and other files needed by the compilers and also many \emph{packages}, which can be thought as libraries or extensions of \LaTeX. The most famous distributions are \href{http://miktex.org/}{MiKTeX} (available only for Windows), \href{http://www.tug.org/texlive/}{TeX Live} (available both for Windows and Linux) and \href{http://www.tug.org/mactex/2011/}{MacTeX} (available only for Mac OS).
-
-Finally we discuss the editor, that is the program used to write your source file. Since a source file written in \LaTeX, like in any other programming language, is a simple text file, you can write your code with any text editor you want (for example Notepad in Windows). However the suggested editors are:
-\begin{itemize}
-\item \href{http://tug.org/texworks/}{TeXworks}. Already installed with any \TeX\ distribution. Very simple and powerful. Use TeXworks if you are not an expert. Enrico Gregorio has written a very good and brief TeXworks manual in Italian, which can be found at: {\small \url{http://profs.sci.univr.it/~gregorio/egtex.html}}.
-
-\item \href{http://texstudio.sourceforge.net/}{TeXstudio} (cross-platform), \href{http://www.xm1math.net/texmaker/}{TeXmaker} (cross-platform), \href{http://pages.uoregon.edu/koch/texshop/}{TeXshop} (only for Mac), \href{http://kile.sourceforge.net/}{Kile} (only for Linux). Powerful editors.
-
-\item \textbf{Avoid} other editors unless you know what you are doing!
-
-\end{itemize}
-
-Finally we explain how to compile the example document provided in the \textsf{sapthesis} package. Double click on the file \texttt{sapthesis-example.tex}. 
-TeXworks should start showing the content of that file. 
-The \texttt{pdflatex} compiler should be automatically selected thanks to the \emph{magic lines} placed at the beginning of the file.
-Now, in order to compile, press the green button. 
-At the end of the compilation the resulting pdf appears in a separate window. Remember to compile at least three times, because \LaTeX\ needs more than one compilation to correctly resolve the internal cross references (for example for the table of contents composition, or when you refer to a figure by the \texttt{\bs label}\,--\,\texttt{\bs ref}\,/\,\texttt{\bs pageref} mechanism).
-
-
-
-\section{Using LyX}
-
-LyX is an advanced \LaTeX\ editor which does not simply show the source code like any text editor, but instead it renders maths, images, tables and some text formatting commands. However this ``layer'' between the writer and the real source code is sometimes frustrating and many authors discourage the usage of LyX.
-
-Using \textsf{sapthesis} with LyX is quite straightforward.
-\begin{itemize}
-\item
-Install \textsf{sapthesis} by the package manager of your \TeX\ distribution or manually.
-
-\item
-In LyX, first of all, go in \textsf{Tools > Preferences > Language Settings > Language} and choose "none" in Language package. This step is necessary because LyX not only loads babel with the desired language, but it passes the language also as an option for the class! This triggers an error in many classes.
-
-\item
-In LyX, go in \textsf{View > View Source}. This step is not necessary but it is very useful to observe the \LaTeX\ code produced by LyX (on the right choose ``Complete source'').
-
-\item
-Copy the file \texttt{sapthesis.layout} in the directory\\ \texttt{C:\bs Program Files\bs Lyx20\bs Resources\bs layouts\bs}\\ and then, in LyX, click on \textsf{Tools > Reconfigure}. 
-\end{itemize}
-
-Now you are ready to use \textsf{sapthesis} in LyX.
-Create a new document and go in \textsf{Document > Settings > Document Class}. Here you can choose \textsf{sapthesis} as the class for the document and write the class options. Then you have to write the preamble of the document in \textsf{Document > Settings > LaTeX Preamble}.