toptesi (6sep20)

git-svn-id: svn://tug.org/texlive/trunk@56276 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 163 insertions, 118 deletions

diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
index 16091dc6188..a72cb2a7d53 100644
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
+++ b/Master/texmf-dist/source/latex/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