summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/toptesi/toptesi.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/toptesi/toptesi.dtx')
-rw-r--r--macros/latex/contrib/toptesi/toptesi.dtx281
1 files changed, 163 insertions, 118 deletions
diff --git a/macros/latex/contrib/toptesi/toptesi.dtx b/macros/latex/contrib/toptesi/toptesi.dtx
index 16091dc618..a72cb2a7d5 100644
--- a/macros/latex/contrib/toptesi/toptesi.dtx
+++ b/macros/latex/contrib/toptesi/toptesi.dtx
@@ -142,7 +142,7 @@ School of Turin.
%<topmag>\ProvidesPackage{toptesi-magistrale}[%
%<topdoc>\ProvidesPackage{toptesi-dottorale}[%
%<*driver,class,topsty,topcmn,topfrn,topscu,topmon,topsss,topmag,topdoc>
-2020-05-29 v.6.4.04
+2020-09-06 v.6.4.06
%<class>Class for typesetting university theses]
%<topsty>Extension for toptesi.cls]
%<topcmn>Additional commands for the TOPtesi bundle]
@@ -258,7 +258,7 @@ School of Turin.
%</driver>
% \fi
%
-% \CheckSum{8000}
+% \CheckSum{8010}
%
% \begin{abstract}
% This file describes the TOPtesi bundle; it consists of a set of files
@@ -2709,7 +2709,7 @@ School of Turin.
% metadata necessary to produce PDF/A compliant files. Its
% functionalities are now included in the \LaTeX kernel |filecontents|
% environment; therefore it is no longer needed; in any case it is
-% easier to use environment defined in TOPtesi for this specific
+% easier to use an environment defined in TOPtesi for this specific
% task; it relies on some low level native \TeX code contained
% in package |fancyvfb|; here we load it: the new environment
% |pdfxmetadata| is defined further on.
@@ -2741,14 +2741,14 @@ School of Turin.
% the most recent \TeX\ system complete and updated installation.
% \begin{macrocode}
\usepackage{trace}
-\RequirePackage{xkeyval}
+\usepackage{xkeyval}
\DeclareOptionX{formato}[a4paper]{\PassOptionsToClass{#1}{report}}
\DeclareOptionX*{\PassOptionsToClass{\CurrentOption}{report}}
\ExecuteOptionsX{formato}
\ProcessOptionsX*\relax
\LoadClass{report}
-\RequirePackage{iftex}
+\usepackage{iftex}
\ifPDFTeX
\usepackage[english,italian]{babel}
\else
@@ -2827,6 +2827,7 @@ School of Turin.
\def\TRON{\tracingcommands \tw@ \tracingmacros \tw@}
\def\TROFF{\tracingcommands\z@ \tracingmacros \z@}
\let\TROF\TROFF
+
% \end{macrocode}
%
% Now we define the specific package options: \texttt{classica} and
@@ -2837,7 +2838,7 @@ School of Turin.
% The option \opz{scudo} is used only to typeset doctoral
% dissertations with the special look required by the “Scuola
% di Dottorato” of Politecnico di Torino. The other options for
-% specific types of thesis, \opz{triennale}, \opz{monografia},
+% specific thesis types, \opz{triennale}, \opz{monografia},
% \opz{magistrale}, \opz{dottorale}, \opz{secondaria}, are
% described further on; options \opz{frontespizio} and
% \opz{custom} avoid loading the default module |topfront| or any
@@ -3005,9 +3006,9 @@ School of Turin.
% \begin{macrocode}
\RequirePackage{graphicx}
\RequirePackage{etoolbox}
-\RequirePackage{xspace}
\newcommand*\ifempty[1]{\edef\@tempA{#1}%
-\ifx\@tempA\@empty\expandafter\@firstoftwo\else\expandafter\@secondoftwo\fi}
+\ifx\@tempA\@empty\expandafter\@firstoftwo
+ \else\expandafter\@secondoftwo\fi}
% \end{macrocode}
%
% The |\textheight| is parametrised to the paper height and
@@ -3018,7 +3019,7 @@ School of Turin.
% \begin{macrocode}
\newlength\interno
\normalsize% necessary to have the correct value for \baselineskip
-\textheight \paperwidth
+\textheight=\paperwidth
\setlength{\textheight}{%
\dimexpr\textheight*\baselineskip/\baselineskip+\topskip}
% \end{macrocode}
@@ -3026,7 +3027,8 @@ School of Turin.
% a small correction is made if the extra size of 14pt is
% chosen. Also |\footskip| is parametrised to the paper height
% in a slightly different way when the large normal font size
-% is not smaller than 14\,pt; the |\if@xivpt| switch is set to true when the value is assigned to the key |corpo|.
+% is not smaller than 14\,pt; the |\if@xivpt| switch is set to true
+% when the value is assigned to the key |corpo|.
% \begin{macrocode}
\iflibro
\unless\if@xivpt
@@ -3049,6 +3051,7 @@ School of Turin.
\footskip=2\baselineskip
\fi
\fi
+
% \end{macrocode}
% The convenience of holding the spine margin within a
% dimensional register becomes really useful now in order
@@ -3138,8 +3141,8 @@ School of Turin.
% optional short argument.
% \begin{macrocode}
\if@twoside % two side
- \def\ps@headings{%
- \let\@mkboth\markboth\let\@oddhead\@empty\let\@evenhead\@empty
+ \def\ps@headings{\let\@mkboth\markboth% autoretitolo
+ \let\@oddhead\@empty\let\@evenhead\@empty
\unless\ifTOPfolioinhead % folio in head
\ifTOPnocenterfolio
\def\@oddfoot{\makebox[\textwidth][r]{\scshape\lapagina}}
@@ -3262,13 +3265,16 @@ School of Turin.
\penalty\@highpenalty
\endgroup
\fi}
+
% \end{macrocode}
% The various tables of contents, or figures, or tables
% require some boolean variables to be defined; in facts,
% although the \sigla{ISO} regulations require that every technical
% report contains the list of figures and/or tables,
% in Italy theses rarely contain these lists; the question is: “is a
-% thesis a technical report?”. In Italy, in most cases, the answer is “no”.
+% thesis a technical report?”. In Italy, in most cases, the answer
+% is “no”.
+%
% We require also some other boolean variables to handle the
% difference between front matter and main matter; these
% differences are already defined in the \texttt{book}
@@ -3290,7 +3296,7 @@ School of Turin.
\ifTOPnumerazioneromana\numeriromanitrue\fi
\frontmattertrue\@openrightfalse\c@secnumdepth=-2\relax
}
-
+
\def\mainmatter{\@mainmattertrue
\if@twoside\@openrighttrue\fi
\ifTOPnumerazioneromana\numeriromanifalse\fi
@@ -3354,11 +3360,12 @@ School of Turin.
\iffrontmatter\else\frontmattertrue\fi
\chapter*{\summaryname}}
\let\summary\sommario
-%
+
\def\ringraziamenti{%
\iffrontmatter\else\frontmattertrue\fi
\chapter*{\acknowledgename}}
\let\acknowledgements\ringraziamenti
+
% \end{macrocode}
% The strings |\summaryname| and |\acknowledgename| are not
% defined for every language option to \texttt{babel}. Default
@@ -3426,7 +3433,7 @@ School of Turin.
% the whole commands were redefined so that the new syntax is the
% following:
%\begin{flushleft}\obeylines
-%\cs{chapter}\meta{$\star$}\oarg{toc entry}\oarg{headings entries}\marg{title}\oarg{pagestyle}
+%\cs{chapter}\meta{$\star$}\oarg{toc entry}\oarg{headings entry}\marg{title}\oarg{pagestyle}
%\end{flushleft}
% The \meta{$\star$} is optional, and simply implies that no toc
% entry will be generated and the chapter title will not be
@@ -3442,54 +3449,54 @@ School of Turin.
% is five. Their meaning is the following.
%\begin{description}
%
-%\item[\meta{$\star$}] Controls the chapter numbering and the
-% toc entry; its absence implies numbering and toc entry;
-% its presence implies no numbering and no toc entry;
-% nevertheless is does not cancels the possibility of having
-% an header (if the page style accepts left and right marks);
-% for example, a command such as this one\\[1ex]
+%\item[\meta{$\star$}]
+% Controls the chapter numbering and the
+% toc entry; its absence implies numbering and toc entry;
+% its presence implies no numbering and no toc entry;
+% nevertheless is does not cancels the possibility of having
+% an header (if the page style accepts left and right marks);
+% for example, a command such as this one\\[1ex]
%\cs{chapter*}\Oarg{Short entry}\Marg{Long title}\\[1ex]
-% does not number the chapter with the |Long title|, but gets
-% the string |Short entry|; lacking the optional argument both
-% headers (see below) will contain the string |Long title|.
-% If you want an empty header, you have to specify an empty
-% optional argument; or before using the command, you specify
-% an empty or a plain page style
-%\item[\meta{toc entry}] is the entry for the table of contents;
-% its default value is \meta{title}, but since more often than
-% not the actual \meta{title} is a long string, it is better
-% to use such optional argument: of course, if the optional star
-% is used, its \meta{toc entry} is passed on as a default value
-% for the \meta{headings entry}.
-%
-%
-%\item[\meta{headings entry}] contains the string to be inserted
-% in both left and right headers, if the page style uses such
-% pieces of information; this is a deliberate choice in order
-% to have both headers correctly indicating the chapter title
-% even if the “chapter” contains no sections, for example indices,
-% lists of figures and/or tables, forewords and similar thesis
-% items. Of course if sections are used, their entries replace
-% that chapter entry in the right header. This choice of defining
-% both headings is useful also for those numbered chapters that
-% have a longish text preceding the first section.
-%
-%
-%\item[\meta{title}] with no surprise is the chapter title that
-% is printed in its opening page. It defines also the default
-% \meta{toc entry} and therefore the \meta{headings entry} if these
-% optional arguments are not specified.
-%
-%
-%\item[\meta{pagestyle}] solves a problem that arises more often
-% than not: by default the chapter opening page is typeset with
-% the |plain| page style; sometimes a different style is desired,
-% for example the |empty| one. The use can specify this optional
-% argument with |empty| to have a opening page without both a header
-% and a printed folio. Actually the user can specify any page style,
-% provided it satisfies the typographical best practice.
+% does not number the chapter with the |Long title|, but gets
+% the string |Short entry|; lacking the optional argument both
+% headers (see below) will contain the string |Long title|.
+% If you want an empty header, you have to specify an empty
+% optional argument; or before using the command, you specify
+% an empty or a plain page style.
+%\item[\meta{toc entry}]
+% is the entry for the table of contents;
+% its default value is \meta{title}, but since more often than
+% not the actual \meta{title} is a long string, it is better
+% to use such optional argument: of course, if the optional star
+% is used, its \meta{toc entry} is passed on as a default value
+% for the \meta{headings entry}.
+%\item[\meta{headings entry}]
+% contains the string to be inserted
+% in both left and right headers, if the page style uses such
+% pieces of information; this is a deliberate choice in order
+% to have both headers correctly indicating the chapter title
+% even if the “chapter” contains no sections, for example indices,
+% lists of figures and/or tables, forewords and similar thesis
+% items. Of course if sections are used, their entries replace
+% that chapter entry in the right header. This choice of defining
+% both headings is useful also for those numbered chapters that
+% have a longish text preceding the first section.
+%\item[\meta{title}]
+% with no surprise is the chapter title that
+% is printed in its opening page. It defines also the default
+% \meta{toc entry} and therefore the \meta{headings entry} if these
+% optional arguments are not specified.
+%\item[\meta{pagestyle}]
+% solves a problem that arises more often than not: by default the
+% chapter opening page is typeset with the |plain| page style;
+% sometimes a different style is desired, for example the |empty| one.
+% The use of this optional argument with |empty| allows to have an
+% opening page without both a header and a printed folio. Actually the
+% user can specify any page style, provided it satisfies the
+% typographical best practice.
%
%\end{description}
+%
% Actually the commands to typeset the Summary and the
% Acknowledgements chapters, as defined above, are regularly
% typeset in the front matter style, opening on any page
@@ -3512,42 +3519,52 @@ School of Turin.
%\begin{flushleft}\obeylines
%\Marg{\cs{chapter}*\oarg{header entry}\marg{chapter title}}
%\end{flushleft}
-% With the new definition there is non need to employ such (actually
+% With the new definition there is no need to employ such (actually
% simple) trick, because the |secnumdepth| counter value is saved, and
% this previous value is restored after the |\chapter| command is fully
% completed.
% \begin{macrocode}
+
\newcount\TOPsecnumdepth
-\RenewDocumentCommand{\chapter}
- {s O{#4} O{#2} m O{plain}}{%
+\newif\iftoc
+
+\RenewDocumentCommand{\chapter}{s O{#4} O{#2} m O{plain}}{%
\if@openright\cleardoublepage
\else\clearpage\fi
\thispagestyle{#5}%
\global\@topnum\z@
\@afterindentfalse
- \TOPsecnumdepth=\c@secnumdepth
\IfBooleanTF{#1}{%
+ \TOPsecnumdepth=\c@secnumdepth
\c@secnumdepth=-3\relax
- \let\iftoc\iffalse
+ \tocfalse
}{%
\iffrontmatter\mainmatter\fi
- \let\iftoc\iftrue
+ \toctrue
}%
-% Numbering and TOC entry
- \ifnum \c@secnumdepth >\m@ne
+ \ifnum \c@secnumdepth >\m@ne
\if@mainmatter % where \if@mainmatter is defined
% (e.g. book.cls, toptesi.cls)
\refstepcounter{chapter}%
\typeout{\@chapapp\space\thechapter.}%
- \iftoc\addcontentsline{toc}{chapter}{%
- \protect\numberline{\thechapter}#2}\fi
+ \iftoc
+ \addcontentsline{toc}{chapter}{%
+ \protect\numberline{\thechapter}#2}%
\else %
- \iftoc\addcontentsline{toc}{chapter}{#2}\fi
+ \addcontentsline{toc}{chapter}{#2}%
+ \fi
+ \else % When \mainmatter is not defined (e.g.report.cls)
+ \refstepcounter{chapter}%
+ \typeout{\@chapapp\space\thechapter.}%
+ \iftoc
+ \addcontentsline{toc}{chapter}{%
+ \protect\numberline{\thechapter}#2}%
+ \else %
+ \addcontentsline{toc}{chapter}{#2}%
\fi
- \else % Were \mainmatter is not defined (e.g.report.cls)
- \iftoc\addcontentsline{toc}{chapter}{#2}\fi
+ \fi
\fi
-% Headers
+%
\markboth{#3}{#3}% No \MakeUppercase
\iftoc
\addtocontents{lof}%
@@ -3555,15 +3572,16 @@ School of Turin.
\addtocontents{lot}%
{\protect\addvspace{10\p@}}%
\fi
-% Actual title in the opening chapter page.
+%
\if@twocolumn
\@topnewpage[\@makechapterhead{#4}]%
\else
\@makechapterhead{#4}%
\@afterheading
\fi
- \c@secnumdepth=\TOPsecnumdepth
+ \IfBooleanTF{#1}{\c@secnumdepth=\TOPsecnumdepth}{}%
}
+
% \end{macrocode}
% It would be possible to redefine in a similar manner also
% the |\part| command, but originally it was deemed unnecessary,
@@ -3655,11 +3673,18 @@ School of Turin.
% We need to define |\indici| (alias |\allcontents|) that typesets
% the table of contents and, optionally, the lists of tables and/or
% figures while softly maintaining the front matter style for
-% typesetting. In facts, if the user wants a different style s/he
-% can select it with a suitable argument to the |\pagestyle| command.
+% typesetting.
+%
+% The various tables and lists are typeset by default with the |plain|
+% page style; if another style is desired the |\indici| command accepts
+% an optional argument; the user may specify any (already defined) page
+% style that will apply to all lists: table of contents, and if the
+% suitable switches are |true|, also to the list of tables and/or the
+% list of figures.
% \begin{macrocode}
-\def\indici{% If headings are desired, the page style must be set in advance
+\NewDocumentCommand\indici{O{plain}}{%
\iffrontmatter\else\frontmattertrue\fi
+ \pagestyle{#1}%
\tableofcontents
\iftablespage
{\addvspace{10pt}
@@ -3707,7 +3732,7 @@ School of Turin.
\brokenpenalty=10000
% \end{macrocode}
%
-% Here comes a questionable command and/or environment; good
+% Now a questionable command and/or environment is defined; good
% typesetting requires the baseline skip to be proportioned
% to the font size, generally it is some 10--20\% larger
% than the font size. In some reasonable instances a larger
@@ -3745,8 +3770,8 @@ School of Turin.
% These geometrical parameters are critical and everybody
% has his/her own ideas of what are the best values for them.
% According to my experience the parameters set by this
-% extension file work quite well but I would not suggest
-% them for every kind of typewritten document.
+% extension file work quite well but I would not claim
+% that they are suitable for any typewritten document.
%
% In particular the zero value for the text fraction appears
% strange, but students have the tendency to create large figures
@@ -3791,9 +3816,9 @@ School of Turin.
% caption width. I initially set the caption width (a new
% length) to the overall text width diminished by 3em; then
% if the caption text, inclusive of the caption label and
-% number, is shorter than the text width it is typeset as
+% number, is shorter than this text width, it is typeset as
% centred text; if it exceeds the text width, it is set as
-% a justified paragraph whose line width equals the
+% a justified paragraph whose line length equals the
% established caption width; but in any case the last
% line of the paragraph is measured and, if it is shorter
% than one third of the caption width, this width is
@@ -3857,20 +3882,21 @@ School of Turin.
% has not been loaded the |\captionsetup| macro is not
% defined and its use (for example, as a leftover of some
% experiments with the \pack{caption} package) would produce
-% an error for this reason we define it as a gobbling macro
+% an error; for this reason we define it as a gobbling macro
% so as to neutralise its presence.
%
% At this point it is very simple to add the |\captionof|
% command in order to use a caption also for figures that
% are set outside floating bodies; it might be useful when
% small figures or tables are inserted in unusual places,
-% such as a table, a minipage, or similar non floating
+% such as a table, a |minipage|, or similar non floating
% environments. The only thing that suffices to insert is
% the name of the corresponding not used float.
% \begin{macrocode}
\AtBeginDocument{\@ifpackageloaded{caption}{}{%
\providecommand\captionsetup{}\renewcommand\captionsetup[2][]{}%
\providecommand\captionof[1]{\def\@captype{#1}\caption}
+
\let\originalcaption\caption
\newdimen\captionwidth
\newdimen\fullwidth
@@ -3914,11 +3940,11 @@ School of Turin.
% \end{macrocode}
%
% ^^A SDFIGURE
-% Always delayed to the |\begin{document}| statement execution
+% Always delayed to the |\begin{document}| statement execution,
% we define a new (possibly floated) environment
% |SD| that creates a box where there is the main environment
% contents with its caption to a side, precisely to the side
-% close to the outer margin of the page. This implies that
+% close to the outer margin of the page. This implies that
% in one side printing the caption is always on the right,
% while in two side printing the caption is on the right in
% right/odd pages and on the left in left/even pages.
@@ -3944,7 +3970,7 @@ School of Turin.
% very \amb{SD} environment.
%
% The actual commands for inserting
-% the picture and its caption within the |figure| environment
+% the image and its caption within the |figure| environment
% have names starting with |SD|, namely |\SDcaption| and
% |\SDimage|. Its syntax is as follows:
%\begin{flushleft}\obeylines
@@ -4050,9 +4076,12 @@ School of Turin.
% used by the final user in those rare circumstances where
% just an explanation is required and the object being
% explained does not require to be cross referenced.
+%
%^^A CONFLITTO CON \CAPTION* DI LONGTABLE? -- CONTROLLARE<<<< !
+%
% \begin{macrocode}
-\NewDocumentCommand\captionSD{s O{} m}{% O: optional arg. with null default
+\NewDocumentCommand\captionSD{s O{} m}{%
+% O: optional arg. with null default
\IfBooleanTF{#1}%
{%
\@makecaption{}{#3}%
@@ -4069,7 +4098,7 @@ School of Turin.
% Then the environment |SDbox| is defined by means of the
% facilities of the |xparse| package; this allows the use of
-% the “non delimited” asterisk argument. It also requires other
+% the “non delimited” asterisk argument. It also requires other
% arguments, the first of which is mandatory and specifies the
% contents kind, be it a figure, or a table, or an algorithm,
% or anything else that has been introduced with the facilities
@@ -4194,7 +4223,7 @@ School of Turin.
% but it actually performs several actions; the first
% (optional) argument is intended to collect the “short
% caption” to be used, if specified, for the list of floats
-% entry; if not specified ,as usual, the “long caption”
+% entry; if not specified, as usual, the “long caption”
% second argument is used for this entry. The third (optional)
% brace delimited argument, on the contrary, is the label
% string that usually is passed as the argument of the
@@ -4208,7 +4237,6 @@ School of Turin.
% and cannot be cross referenced; there are circumstances
% when this situation is very useful, but it is up to the
% user to decide when it is useful for his/her needs.
-% interpretation.
%
% In this macro definition the boolean switch |NumberSD|
% has been already set by the opening statement commands
@@ -4269,9 +4297,9 @@ School of Turin.
% in a parbox or a minipage; it can be an actual picture
% imported with an |includegraphics| command, it can be a
% drawing or a diagram created with the |picture|, or |tikz|,
-% or |pgfplots|, or |pstricks| commands; it can be a table,
-% an algorithm, an example, a theorem; anything that can be
-% typeset within a box. With this name in mind we create
+% or |pgfplots|, or |pstricks| commands/environments; it can be
+% a table, an algorithm, an example, a theorem; anything that can
+% be typeset within a box. With this name in mind we create
% the |SDimage| command to insert the object into our |SDbox|.
% A |\SDtabular| command is an alias to |\SDimage|; the user
% may define other such aliases for inserting other objects
@@ -4430,8 +4458,8 @@ School of Turin.
% involuntary reassignment to this register. At the same
% time if a specific language option was not specified, a
% warning message is issued, but compilation goes on any way
-% without the sectioning string names. For being sure no
-% other `undefined' error messages are issued, the |\summaryname|
+% without the sectioning string names. To be sure, no
+% other `undefined' error messages are issued, and the |\summaryname|
% and |\acknowledgename| are let to |\empty|.
% \begin{macrocode}
\providecommand*\summaryname{}
@@ -4450,7 +4478,7 @@ Skipping any redefinition\MessageBreak}%
}}}%
% \end{macrocode}
% For Italian and English there are no problems; we provide
-% immediately these extensions by means of the newly available macro:
+% immediately these extensions by means of the newly available macros:
% \begin{macrocode}
\ExtendCaptions{italian}{Sommario}{Ringraziamenti}
\ExtendCaptions{english}{Summary}{Acknowledgements}
@@ -4461,7 +4489,9 @@ Skipping any redefinition\MessageBreak}%
% and |\captionsenglish| are already defined and can be
% freely extended. For any other language the corresponding
% language option must be entered in the class opening
-% statement, otherwise a warning is issued but compilation
+% statement if babel is used, or it must be set with |polyglossia|
+% |\setotherlanguage| when the latter language handler is being used;
+% otherwise a warning is issued but compilation
% is not stopped. Therefore if, for example, the user wants
% to write the thesis in Spanish, the thesis main file shall
% start like this:
@@ -4474,7 +4504,18 @@ Skipping any redefinition\MessageBreak}%
% ...
% \end{verbatim}
% and the rest of the thesis will be typeset correctly in
-% Spanish. Remember that Italian is the main language and
+% Spanish. similarly, if |polyglossia| is being used The code is:
+%\begin{verbatim}
+% \documentclass[...]{toptesi}
+% ...
+% \setotherlanguage{spanish}
+% \ExtendCaptions{spanish}{Resumen}{Agradecimientos}
+% ...
+% \begin{document}
+% \selectlanguahe{spanish}
+% ...
+%\end{verbatim}
+% Remember that Italian is the main language and
% nothing is necessary to set up the Italian defaults.
% If English is desired, then after |\begin{document}| it
% is necessary to specify the default language; for ease
@@ -4505,12 +4546,11 @@ Skipping any redefinition\MessageBreak}%
% specify |\english| \emph{after} the |\begin{document}|
% statement, if English is supposed to be the main language, or
% \item
-% specify the language name, other than Italian or English,
-% among the class options; use the |\ExtendCaptions| macro
-% for extending the list of sectioning commands infix strings
-% as explained above; specify with |\selectlanguage| the new
-% language as the default one \emph{after} the |\begin{document}|
-% statement;
+% if babel is being used, specify the language name, other than Italian
+% or English, among the class options; use the |\ExtendCaptions| macro
+% for extending the list of sectioning commands infix strings as
+% explained above; specify with |\selectlanguage| the new language as
+% the default one \emph{after} the |\begin{document}| statement;
% \item
% if \XeLaTeX\ or LuaLaTeX\ is being used for typesetting, it
% suffices to specify in the preamble the name of the other
@@ -4529,8 +4569,8 @@ Skipping any redefinition\MessageBreak}%
%
% At last the subsidiary and independent packages
% \texttt{topcoman} and \texttt{topfront} are requested
-% for input; the latter is loaded only when the
-% |documentclass| option |noTOPfront| has NOT been declared.
+% for input; the latter is loaded only when the switch |noTOPfront|
+% has NOT been set |true| by using any \texttt{tipotesi=\meta{option}}.
% This action, therefore has to be delayed till the “begin
% document” step, in order to be sure that other packages
% have possibly been loaded to typeset the title page, and/or
@@ -4538,7 +4578,7 @@ Skipping any redefinition\MessageBreak}%
% of measure. This delayed loading implies that the
% commands defined in |topfront| and in |topcomand| cannot
% be used in the preamble. Notice that also the \textsl{scudo}
-% option implies that the title page is typeset with its
+% option value implies that the title page is typeset with its
% special commands and environments, therefore it sets the
% suitable switches so as to avoid loading the |topfront|
% module. This applies also to the other modules specific for
@@ -4560,7 +4600,7 @@ Skipping any redefinition\MessageBreak}%
% because they have a declared width of 0\,pt; this
% is no problem for \texttt{pdflatex}, but it is a problem
% for the \sigla{PDF/A} format. Therefore, and only when
-% \texttt{pdflatex} is used for typesettiNg the document,
+% \texttt{pdflatex} is used for typesetting the document,
% these commands must be replaced by equivalent ones that
% do not use zero-width glyphs. For |\not|, another slash can
% be used, but in order to have it the right size in all math
@@ -6656,6 +6696,11 @@ security of personal data.}
\newcommand\printloghi{\unless\ifvoid\TPT@logobox\usebox{\TPT@logobox}\fi}
% \end{macrocode}
+% The author/candidate name by defaukt is underlined by five spaced stars; This is the decoration approved by the ScuDo directors. After all, such a decoration might be a little soberer something else, such as a thin rule, or simply omitted; this is possible by redefining the following macro:
+% \begin{macrocode}
+\newcommand\fivestars{* * * * *}
+% \end{macrocode}
+%
% Next the disclaimer and the signature macros are defined;
% the disclaimer text and the signature layout may be changed
% by these commands; but if the user does not use these
@@ -6718,7 +6763,7 @@ Turin, \@examinationdate
\@subtitle
{\Large\bfseries \@author\par}
\smallskip
-\mbox{* * * * * *}
+\mbox{\fivestars}
\vspace{\stretch{1}}
{\large\bfseries \ifcase\@supervisornumber
@@ -6840,13 +6885,13 @@ This class is available in every up-to-date and complete
% \begin{macrocode}
%%
%%================================================================
-%% This file is the only file of the TOPtesi bundle that the user
-%% can modify without restrictions in order to customise the
-%% contents of this configuration file to his/her needs. The user
-%% can add or remove lines, comment or uncomment lines, change the
-%% arguments to macros, add definitions and so on.
%% Use this file by copying the relevant section to another file
%% to be named as the thesis main file and with extension .cfg.
+%% This copied and renamed file is the only file of the TOPtesi
+%% bundle that the user can modify without restrictions in order to
+%% customise the contents of this configuration file to his/her needs.
+%% The user can add or remove lines, comment or uncomment lines,
+%% change the arguments to macros, add definitions and so on.
%% This bundle will try to read "\jobname.cfg"; if this file does
%% not exist, the bundle files don't do anything. This implies that
%% the provided file toptesi.cfg is to be used as a model, not to