summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/toptesi
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/toptesi')
-rw-r--r--Master/texmf-dist/source/latex/toptesi/toptesi.dtx790
1 files changed, 310 insertions, 480 deletions
diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
index 0e006e96844..2bf9d7ef74f 100644
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
+++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
@@ -25,7 +25,7 @@ This work is "author-maintained"
This work consists of this file toptesi.dtx, a README file
and the derived files:
-toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty,
toptesi.cfg, and the English documentation toptesi.pdf;
Furthermore the bundle contains the documentation source file toptesi-doc.tex
@@ -39,7 +39,7 @@ frontpages.
The toptesi.cfg file is a sample of a local configuration file that can be
freely edited and modified.
-By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+By running pdflatex on toptesi.dtx the user gets the cls, sty and cfg files
and the English documentation file in pdf format.
The documentation file toptesi-doc.pdf is in Italian; its source file is
@@ -51,7 +51,6 @@ another example of how to use toptesi.
\generateFile{toptesi.sty}{t}{\from{toptesi.dtx}{topsty}}
\generateFile{topcoman.sty}{t}{\from{toptesi.dtx}{topcmn}}
\generateFile{topfront.sty}{t}{\from{toptesi.dtx}{topfrn}}
-\generateFile{topsiz14.clo}{t}{\from{toptesi.dtx}{top14}}
\generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}}
\def\tmpa{plain}
@@ -59,7 +58,7 @@ another example of how to use toptesi.
\endgroup
%</internal>
%
-% Copyright 1989--2006 Claudio Beccari
+% Copyright 2005--2011 Claudio Beccari
%
% This file is part of the TOPtesi bundle
% -------------------------------------------
@@ -86,7 +85,7 @@ another example of how to use toptesi.
% \iffalse
%<*driver>
\documentclass{ltxdoc}
-\ProvidesFile{toptesi.dtx}[2011/05/11 v.5.05 Documented TeX file for
+\ProvidesFile{toptesi.dtx}[2011/05/25 v.5.50 Documented TeX file for
the TOPtesi bundle]
\GetFileInfo{toptesi.dtx}
\title{The TOPtesi bundle}
@@ -101,7 +100,7 @@ the TOPtesi bundle]
%</driver>
% \fi
%
-% \CheckSum{2933}
+% \CheckSum{2441}
%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -134,7 +133,7 @@ the TOPtesi bundle]
% \end{abstract}
%
% \section{Introduction}
-% The TOPtesi bundle collects a certain number of files, specifically
+% The TOPtesi bundle collects a certain number of files, specifically:
% \begin{itemize}
% \item a class file \texttt{toptesi.cls} to be used as the main document class; the main
% document may be any of a certain number of reports that in Italy
@@ -143,8 +142,8 @@ the TOPtesi bundle]
% magistrale'', ``tesi di dottorato'', ``dissertazione di dottorato'', and so on.
% All these documents have in common the fact that they all conclude a period of university
% education. Moreover since they may conclude a double degree university program, they may
-% receive foreign names such as, for example, ``Projet de fin d'\'etudes'', ``Master thesis'',
-% and the like.
+% receive foreign names such as, for example, ``Projet de fin d'\'etudes'', ``Master
+% thesis'', and the like.
% \item An extension package \texttt{toptesi.sty} that contains most of the code
% for the real typesetting; it might be used as an extension to the report class file,
% although this use is discouraged.
@@ -155,19 +154,14 @@ the TOPtesi bundle]
% title page fixed information in languages different from Italian.
% \item A third extension package \texttt{topcoman.sty} that defines a certain number
% of user commands suitable for typesetting technical matters.
-% \item A fourth extension package \texttt{trieste.sty} and its accompanying package option
-% \texttt{topsiz14.clo} that is used as an option by
-% \texttt{toptesi.cls} in order to define a certain number of variations required
-% for theses in humanities at the university of Trieste; these variations are not that
-% important, but they may be preferred also in other faculties so that the suitable option
-% comes handy also in other situations.
-% \item The logos of a certain number of Italian universities in \texttt{.eps},
-% \texttt{.jpg}, and \texttt{.pdf} formats; such logos are included for the user sake, but
-% the user should pay attention to use them according to the rules and limitations of
-% each university and it is strongly advised to look up such regulations in each
-% university Web site.
+% \item Previous version of this bundle contianed also the logos of a certain number of
+% universities; These logos are not distributed anymore because of legal constraints. Every
+% one who is working on his/her degree course final report must retrieve the logo of his/her
+% university, but s/he should pay attention to use it according to the rules and limitations
+% of the university.
% \item A documentation file \texttt{toptesi-doc.pdf} written in Italian where every feature
-% is explained in detail; essential information is given in this English documentation.
+% is explained in detail; this English documentation gives a summary of the necessary
+% information and contains the code description.
% \end{itemize}
%
% The above files are complemented with a configuration file that any user may
@@ -193,7 +187,7 @@ the TOPtesi bundle]
% texts written in non latin alphabets, special symbols for philological mark-up, and
% the like; a common typewriter would not be suitable and the quality of the contents
% requires professional typesetting; this is why I strongly believe that instructions
-% on typesetting styles that refer to the good old times of mechanical typewriters
+% on typesetting styles that refer to the ``good old times'' of mechanical typewriters
% should be banned.
%
% Most new commands refer themselves to the information that should be typeset in the
@@ -210,7 +204,7 @@ the TOPtesi bundle]
% indication.
%
% \Item[classica] Specifies a general modification of certain details that are
-% supposed to be more adequate in the humanities; specifically this option
+% supposed to be more adequate in the humanities fields; specifically this option
% lets old style numbers to be used for certain numerical pieces of information;
% some variations are also introduced in the title page.
%
@@ -223,18 +217,14 @@ the TOPtesi bundle]
% \Item[14pt] Extends the normal size choice to 14 points; it is appreciated
% in various fields of humanities, but I would discourage this use in a technical
% thesis, where 10 point perhaps is too small, but 11 point or 12 point typesetting
-% may be adequate. It is worth mentioning that this option implements the font
-% settings in a different way from what is being done with the \texttt{extsizes} package
-% bundle; this is why the original \texttt{size14.clo} class option file has been renamed
-% \texttt{topsiz14.clo} so as to avoid conflicts with the \texttt{size14.clo} file belonging
-% to that bundle.
+% may be adequate.
%
% \Item[autoretitolo] This option modifies the left hand (even numbered) pages
% in two side typesetting; normally the even numbered page headings contain
% the chapter title, while the odd numbered ones contain the current section title.
-% If the \texttt{classica} option has been specified, then with this option it is possible to
-% have even numbered headings contain the author's name and the thesis title, while the odd
-% numbered ones contain the chapter title. Since the thesis title might be too
+% If the \texttt{classica} option has been specified, then with this option it is possible
+% to have even numbered headings contain the author's name and the thesis title, while the
+% odd numbered ones contain the chapter title. Since the thesis title might be too
% long to fit in the header together with the author's name, the |\title| macro
% as been modified so as to accept an optional short title, similarly to the
% sectioning commands.
@@ -293,8 +283,8 @@ the TOPtesi bundle]
% \Item[tutore] gets the name of the doctorate tutor; there is no difference with regards
% to the \cs{relatore}, but the default phrase ``Tutore'' is printed above
% this person's name.
-% \Item[TutorName] gets the phrase that describes the tutor position, possibly in a different
-% language.
+% \Item[TutorName] gets the phrase that describes the tutor position, possibly in a
+% different language.
% \Item[AdvisorName] gets the string that qualifies the supervisor(s); the default string
% is ``Relatore:'' or ``Relatori:'' for the plural; in another language
% this command is used to define the string, say, ``Supervisors:'' if the
@@ -310,13 +300,13 @@ the TOPtesi bundle]
% \Item[terzocandidato] gets the name of the third male author
% \Item[terzacandidata] gets the name of the third female author; most often the thesis
% author is just one person; but there are some institutions where group
-% final works are accepted; it is assumed that the group does not contain more
-% than three authors. The specification of the gender allows the software
-% to determine the correct labeling phrase in the proper gender and proper
-% number.
+% final works are accepted; it is assumed that the group does not contain
+% more than three authors. The specification of the gender allows the
+% software to determine the correct labeling phrase in the proper gender
+% and proper number.
% For different languages there might be no difference in gender but
% there is a difference in the plural ending.
-% \Item[CandidateName] gets the string that describes the student status in a foreign
+% \Item[CandidateName] gets the string that describes the student status in a foreign
% language or even in Italian; the default string is ``Candidato:'' (with
% colons) adjusted to masculine or feminine, singular or plural; with the
% option \texttt{classica} the string becomes ``Laureando:''; in other
@@ -352,12 +342,12 @@ the TOPtesi bundle]
% after all the command |\annoaccademico| is defined only with that option.
% \Item[logosede] specifies the name of the file that contains the university logo;
% no default is defined; rather a warning message is issued if no name is
-% given or the file is missing, but typesetting goes on without the inclusion
-% of any logo.
+% given or the file is missing, but typesetting goes on without the
+% inclusion of any logo.
% \Item[setbindingcorrection] sets up the length to displace the text block to the external
-% margin so as to have a wider internal margin to accommodate for the binding
-% correction. Its argument is not optional and is used to modify the default
-% correction of 7\,mm.
+% margin so as to have a wider internal margin to accommodate for the
+% binding correction. Its argument is not optional and is used to modify
+% the default correction of 7\,mm.
% \end{description}
%
% Since the infix strings are all memorized into control sequences and for each of them it
@@ -409,17 +399,16 @@ the TOPtesi bundle]
% not.
%
% Should the required language(s) be missing, the user is forced to read his/her
-% distribution
-% instructions, so as to find out how to configure his/her system so as to consider the
-% languages s/he wants to work with, and finally s/he must recreate the format files and put
-% them in the proper places of the standard or the local folder tree. The user is invited to
-% carefully investigate on these fine points and to configure the system properly; it would
-% be very upsetting using fine software for producing a perfectly typeset thesis that,
-% unfortunately, has wrong hyphenation points! Luckily enough, recent distributions of the
-% \TeX\ system have all the known hyphenation rules preloaded; in any case even older
-% distributions have available command line commands or graphical user interfaces that make
-% it easy to perform the tasks of changing the list of preloaded hyphenation rules and
-% rebuilding all the format files, moving them to the proper places.
+% distribution instructions, so as to find out how to configure his/her system so as to
+% consider the languages s/he wants to work with, and finally s/he must recreate the format
+% files and put them in the proper places of the standard or the local folder tree. The user
+% is invited to carefully investigate on these fine points and to configure the system
+% properly; it would be very upsetting using fine software for producing a perfectly typeset
+% thesis that, unfortunately, has wrong hyphenation points! Luckily enough, recent
+% distributions of the \TeX\ system have all the known hyphenation rules preloaded; in any
+% case even older distributions have available command line commands or graphical user
+% interfaces that make it easy to perform the tasks of changing the list of preloaded
+% hyphenation rules and rebuilding all the format files, moving them to the proper places.
% \end{itemize}
%
% The TOPtesi bundle adds very little to the user commands; nevertheless the package
@@ -487,7 +476,7 @@ the TOPtesi bundle]
% nowadays the letter ``j'' in Italian is called with the English name
% (much shorter than the traditional Italian name ``i~lunga'') and the
% indicated spelling ``gei'' is the phonetic Italian rendering of the
-% English word. The imaginary unit is not a variable, it is a vector operator,
+% English word. The imaginary unit is not a variable, it may be viewed as a vector operator,
% so that the ISO regulations require for this symbol an upright type.
% %
% \Item[eu] inserts the Euler number symbol ``e'' in upright type; since
@@ -502,13 +491,13 @@ the TOPtesi bundle]
% written for the thesis; for best results it is recommended that the source program has
% lines not longer than 80 characters. There exists an external package \texttt{listings},
% that the user might want to load, that does a similar work in a more professional and
-% configurable way; our package simpler command might be preferable for its simplicity.
+% configurable way; this package simpler command might be preferable for its simplicity.
% \end{description}
%
% All these commands are defined into the separate package \texttt{topcoman.sty}
% that can be used as an independent extension package with (possibly) any document class.
%
-% \section{Format PDF suitable for archiving}
+% \section{PDF format suitable for archiving}
% Politecnico di Torino as well as many other Italian and foreign universities are
% moving towards archiving theses in electronic format, specifically in the PDF one. The
% problem of course is: ``Will it be possible to read the archived documents, say, fifty
@@ -559,12 +548,12 @@ the TOPtesi bundle]
% not already part of your \TeX\ system installation.
% \item Install in the main \texttt{pdfx} directory a good version of a color model
% profile file, such as, for example, \texttt{ECI-RGB-V1.0.icc} (see in the download
-% page of the site \texttt{www.eci.org}).
+% page of the web site \texttt{www.eci.org}).
% \item If your thesis main file, the one you run your \texttt{pdflatex} on, is named,
% say, \texttt{JohnSmithMasterThesis.tex}, prepare in the same directory another file
% named \texttt{JohnSmithMasterThesis.xmpdata} that contains the \emph{metadata}
% relative to the thesis; pay attention to follow the stringent syntax described and
-% exemplified in the \textsf{pdfx} documetation. A minimal set of \emph{metadata}
+% exemplified in the \textsf{pdfx} documentation. A minimal set of \emph{metadata}
% example would be the following one:
% \begin{verbatim}
% \Title{Experiments in Trichotetratomy}
@@ -576,7 +565,7 @@ the TOPtesi bundle]
% and the standard mathematical fonts require some patching that is already included
% in this \texttt{ToPtesi} bundle; but it is not excluded that with other fonts similar
% patches might be requested.
-% \item Use only PNG and JPEG images with RGB color profiles.
+% \item Use only PNG and JPEG or PDF images with RGB color profiles.
% \item If you include PDF images that contain some text, be sure that the font for
% this text is completely embedded in the included file. Should the PDF file come
% from an external drawing program be sure to configure that program so that it embeds
@@ -586,7 +575,7 @@ the TOPtesi bundle]
% conformity.
% \item Verify your final PDF file with a suitable program and do not give up doing the
% necessary corrections or modifications while the verification program keeps saying
-% the this or that is not conforming to the PDF/A specification. A suitable program
+% that this or that is not conforming to the PDF/A specification. A suitable program
% is the Preflight plug-in of Adobe Acrobat Professional version 8 or later, but this,
% although the most authoritative, is a commercial program; probably your university
% has special facilities for this task.
@@ -595,7 +584,7 @@ the TOPtesi bundle]
% Up to day the realization of a PDF/A conforming file sets forth several problems
% that are of great concern for the large Institutions that have thousands of document
% a year to archive; it is not a question implied in the free nature of the
-% \texttt{pdflatex} program, that, on the opposite, according to our experience has
+% \texttt{pdflatex} program, that, on the opposite, according to my experience has
% a very high rate of success in producing PDF/A conforming documents. If you stick to
% the default \TeX\ system fonts and use this patched version of \texttt{ToPtesi} you
% should be able to avoid most problems.
@@ -605,14 +594,14 @@ the TOPtesi bundle]
% \section{Documented code}
% \subsection{The class code}
%
-% Here begins the usual machinery for stating the required \TeX\ format
-% and for sharing some code between the driver and the class part of the code, since they are
+% Here begins the usual machinery for stating the required \TeX\ format and for sharing some
+% code between the driver and the class part of the code, since they are
% supposed to carry the same date and version number, besides the description string.
% \begin{macrocode}
%<*class>
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{toptesi}%
-[2011/05/11 v.5.05 Class for typesetting university theses]
+[2011/05/25 v.5.50 Class for typesetting university theses]
% \end{macrocode}
%
% The class itself is very simple since it requires just the \texttt{report}
@@ -620,12 +609,14 @@ the TOPtesi bundle]
% specified for the \texttt{toptesi} class are passed on to the \texttt{report}
% class; the latter, on turn, is called with the \texttt{a4paper} option.
% According to the \LaTeX\ machinery of option passing the options passed on to
-% the loaded class should be appended to the existing options, so that if \texttt{letterpaper}
+% the loaded class should be appended to the existing options, so that if
+% \texttt{letterpaper}
% was specified in the calling statement of \texttt{toptesi}, this last option would
% override the default \texttt{a4paper} option. The same holds true for the other package
-% options except for the encoding name used as an option for the \texttt{inputenc} package; this % simply does not work and the package is not loaded any more as it was in the previous % versions\footnote{Thanks to Enrico Gregorio who pointed out this feature.}.
+% options except for the encoding name used as an option for the \texttt{inputenc} package;
+% this simply does not work and the package is not loaded any more as it was in the previous % versions\footnote{Thanks to Enrico Gregorio who pointed out this feature.}.
% Similarly if another language was specified in the list of \texttt{toptesi}
-% options, this language would be appended yo the \texttt{babel} package default options
+% options, this language would be appended to the \texttt{babel} package default options
% and would become the default language.
% \begin{macrocode}
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}}
@@ -640,17 +631,18 @@ the TOPtesi bundle]
% \subsection{The \texttt{toptesi.sty} code}
% The greatest part of the \texttt{toptesi} class code is saved into a separate file
% partly for backward compatibility reasons (before version 3.x \texttt{toptesi} was just
-% an extension to the \texttt{report} class) and partly because it might be used as a standaolone
-% package, although, take notice, it might conflict with the \texttt{book} class code and certainly
-% it is incompatible with the \texttt{article} class. This package must contain its own \TeX\
-% format declaration and might have different version and subversion numbers compared to the
-% class file and the other invoked packages that are part of the same bundle.
+% an extension to the \texttt{report} class) and partly because it might be used as a
+% standalone package, although, take notice, it might conflict with the \texttt{book} class
+% code and certainly it is incompatible with the \texttt{article} class. This package must
+% contain its own \TeX\ format declaration and might have different version and subversion
+% numbers compared to the class file and the other invoked packages that are part of the
+% same bundle.
%
% \begin{macrocode}
%<*topsty>
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{toptesi}%
-[2011/05/11 v.5.05 Extension for toptesi.cls]%
+[2011/05/25 v.5.50 Extension for toptesi.cls]%
% \end{macrocode}
%
% We start by defining the debugging macros; these trace commands and macros
@@ -664,16 +656,21 @@ the TOPtesi bundle]
% Now we define the specific package options: \texttt{classica} and \texttt{trieste}
% are identical; \texttt{trieste} is maintained for backward compatibility.
% The option \texttt{14pt} is for choosing a normal size of 14pt; the class option
-% file \texttt{topsiz14.clo} has a name that should not conflict with other
-% similar class option packages and is in line with the other standard \texttt{size??.clo}
-% files. \texttt{chapterbib} allows to set a list of references at the end of each chapter.
+% file \texttt{size14.clo} is distributed with the \texttt{extsizes} pacckage and is already
+% included in any complete distribution of the major \TeX\ system ones; in previous versions
+% of this bundle there was a specific option class file for this large size, but with the
+% latest complete distributions available, there is no chance that the existing option file
+% is missing.
+%
+% \texttt{chapterbib} allows to set a list of references at the end of each chapter.
% For the options specific to the \texttt{classica} style a couple of boolean variables are
% defined and the option definitions set them to the value ``true''.
% \begin{macrocode}
\newif\if@utoretitolo \@utoretitolofalse
\newif\if@ldstyle \@ldstylefalse
+\newif\if@xivpt \@xivptfalse
% \end{macrocode}
-
+%
% \begin{macrocode}
\newlength\T@Pbinding\setlength\T@Pbinding{7mm}\def\setbindingcorrection#1{\T@Pbinding=#1}
\newif\if@binding \@bindingfalse
@@ -681,9 +678,9 @@ the TOPtesi bundle]
\newif\ifchapterbibliography \chapterbibliographyfalse
\newif\ifclassica \classicafalse
\DeclareOption{cucitura}{\@bindingtrue}
-\DeclareOption{14pt}{\input{topsiz14.clo}}
+\DeclareOption{14pt}{\@xivpttrue}
\DeclareOption{chapterbib}{\chapterbibliographytrue}
-\DeclareOption{trieste}{\classicatrue}
+\DeclareOption{trieste}{\classicatrue}% Just for backwards compatibility
\DeclareOption{classica}{\classicatrue}
\DeclareOption{autoretitolo}{\ifclassica\@utoretitolotrue\fi}
\DeclareOption{oldstyle}{\ifclassica\@ldstyletrue\fi}
@@ -691,14 +688,14 @@ the TOPtesi bundle]
%
\ProcessOptions\relax
% \end{macrocode}
-% The \texttt{graphicx} package is loaded by default; it is required for
-% inserting the university logo; if the user forgets that this package has already
-% been loaded
+% The \texttt{graphicx} package is loaded by default; it is required for inserting the
+% university logo; if the user forgets that this package has already been loaded
% nothing dramatic happens, because the |\usepackage| and |\RequirePackage| macros
% perform the necessary tests in order to avoid reloading the same packages again
% and again.
% \begin{macrocode}
\RequirePackage{graphicx}
+\if@xivpt\input{size14.clo}\fi
% \end{macrocode}
%
% The text height gets set so as to cope with the standard UNI A4 size; in
@@ -808,12 +805,12 @@ the TOPtesi bundle]
Use the optional argument of command \string#1\MessageBreak
See the LaTeX Handbook (1994) on section C.4.1\MessageBreak}}
% \end{macrocode}
-% The various tables of contents or figures or tables require some boolean variables to
-% be defined; in facts, although the ISO regulations require that every technical report contains
-% the list of figures and/or tables, in Italy theses rarely contain these lists; after all: is
-% a thesis a technical report? We require also some other boolean variables to handle
-% the difference between front matter and main matter; this differences are already defined
-% in the \texttt{book} document class, but not in the \texttt{report} one.
+% The various tables of contents or figures or tables require some boolean variables to be
+% defined; in facts, although the ISO regulations require that every technical report
+% contains the list of figures and/or tables, in Italy theses rarely contain these lists;
+% after all: is a thesis a technical report? We require also some other boolean variables to
+% handle the difference between front matter and main matter; this differences are already
+% defined in the \texttt{book} document class, but not in the \texttt{report} one.
% \begin{macrocode}
\newif\iffigurespage
\newif\iftablespage
@@ -831,8 +828,8 @@ the TOPtesi bundle]
\AtBeginDocument{\frontmatter}
% \end{macrocode}
% The main matter is automatically established with the first |\chapter| command issued by
-% the user; this means that every command that starts a section at the ``chapter'' level within
-% the front matter must be executed without an explicit call to |\chapter|.
+% the user; this means that every command that starts a section at the ``chapter'' level
+% within the front matter must be executed without an explicit call to |\chapter|.
%
% By default we set to false the boolean variables that control the typesetting of the
% list of figures and the list of tables.
@@ -970,15 +967,15 @@ the TOPtesi bundle]
\brokenpenalty=10000
% \end{macrocode}
%
-% Here comes a questionable command and/or environment; 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 wider or a narrower baseline skip
+% Here comes a questionable command and/or environment; 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 wider or a narrower baseline skip
% might be required; the \LaTeX\ kernel allows to use the |\linespread| command;
% in the previous versions of this bundle a command |\interlinea| and an environment
% \texttt{interlinea} were defined so as to allow to set the line spread factor.
% The experience has shown that students tend to use this command so as to typeset a poor
-% and thin thesis on more pages. Well, every instrument can be judiciously or maliciously used;
-% this is one of those double sided instruments.
+% and thin thesis on more pages. Well, every instrument can be judiciously or maliciously
+% used; this is one of those double sided instruments.
% \begin{macrocode}
\def\interlinea#1{\linespread{#1}\selectfont}
\def\endinterlinea{\par}
@@ -994,17 +991,18 @@ the TOPtesi bundle]
\@setminipage
}
% \end{macrocode}
-% Since we are at it we define the floating bodies placing parameters; not only the
-% values ``here'', ``top of the page'' and ``bottom of the page'', that we set as default ones
-% leaving to the user to explicitly specify the ``page of floats'', but also the numerical and
-% geometrical parameters that control the float placements.
-% These geometrical parameters are critical and everybody has his/her own ideas of
-% what are the best values for them. According to my experience these parameters work quite well
+% Since we are at it we define the floating bodies placing parameters; not only the values
+% ``here'', ``top of the page'' and ``bottom of the page'', that we set as default ones
+% leaving to the user to explicitly specify the ``page of floats'', but also the numerical
+% and geometrical parameters that control the float placements.
+% These geometrical parameters are critical and everybody has his/her own ideas of what are
+% the best values for them. According to my experience these parameters work quite well
% but I would not suggest them for every kind of typewritten document.
% In particular the zero value for the text fraction appears strange, but students have
-% the tendency to create large figures (more than large tables) and these tend to clog the figure queue.
-% A 100\% space for the top of page figures and a requirement of 0\% text allows large floats
-% to exit the queue provided they do not exceed the text height.
+% the tendency to create large figures (more than large tables) and these tend to clog the
+% figure queue.
+% A 100\% space for the top of page figures and a requirement of 0\% text allows large
+% floats to exit the queue provided they do not exceed the text height.
% \begin{macrocode}
\def\fps@figure{htb} \def\fps@table{htb}
%
@@ -1019,24 +1017,24 @@ the TOPtesi bundle]
\def\dbltopfraction{1}
\def\dblfloatpagefraction{0}
% \end{macrocode}
-% One command that the default definition does not satisfy me very much is the caption command;
-% actually it is the internal |\@makecaption| macro that performs the job. The point is that
-% I prefer a narrower justified caption rather than a caption where the last line is just a short word
-% or the right segment of an hyphenated word. If one sets the
+%I don't like too much the default definition of the |\caption| command; actually
+% it is the internal |\@makecaption| macro that performs the job i don't like. The
+% point is that I prefer a narrower justified caption rather than a caption where the last
+% line is just a short word or the right segment of an hyphenated word. If one sets the
% |\finalhyphendemerits| counter to an incredibly high value, one might succeed
% in avoiding hyphenation in the last word of a caption; but this might lead
% to a very loose typesetting of the caption paragraph, especially
-% if the horizontal box that contains it hardly exceeds the caption width.
-% I initially set the caption width (a new length) to the overall text width diminished by 3em;
+% if the horizontal box that contains it hardly exceeds the 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 type string and number, is shorter than
-% the text width it is typeset as centered text; if it exceeds the text width
-% it is set as a justified paragraph whose line width 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 shortened a little bit and the paragraph is set again
+% the text width it is typeset as centered text; if it exceeds the text width it is set as a
+% justified paragraph whose line width 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 latter width is shortened a little bit and the paragraph is set again
% with this shortened caption width; in order to be sure that one iteration is
% sufficient, the shrinking of the caption width must be computed according to
% the number of lines the paragraph occupies.
-% In order to count the number of lines the caption paragraph occupies it is
+% In order to count the number of lines the caption paragraph occupies, it is
% necessary to recall that the first line occupies a vertical space that equals
% |\topskip| while the other lines occupy a vertical space equal to
% |\baselineskip|; the latter one is generally larger than |\topskip| therefore
@@ -1051,7 +1049,7 @@ the TOPtesi bundle]
% and we must remember the presence of this line in our arithmetics.
% If the length of the stripped last line is longer that one third of the
% caption width, then the vertical box is recomposed by restacking the
-% individual lines, but if this last line is shorter than one third of the
+% individual lines; on the opposite, if this last line is shorter than one third of the
% caption width, this width is recomputed in this way: let $N-1$ be the number
% of lines obtained with the integer division, i.e.\ one line less than those
% actually contained in the vertical box. Let $x$ be the initial caption
@@ -1064,7 +1062,7 @@ the TOPtesi bundle]
% space, some words might have been hyphenated in a different way, and so on.
% Moreover we do not want a caption that barely exceeds the length of
% |\captionwidth| to be retyped into a two line caption width that is about one half
-% of the width of the other captions. Therefore we allow for some white space in
+% the width of the other captions. Therefore we allow for some white space in
% the last line by computing the new caption width with the following formula
% \[ y=\frac{(N+0.5)x + x_2}{N+1} \]
% \begin{macrocode}
@@ -1158,14 +1156,28 @@ the TOPtesi bundle]
% old time files might still be around.
%
% The cryptic code that redefines the comma in math mode establishes that this
-% character is a normal math character, instead of a math punctuation mark;
-% this should not be necessary with the Italian option for the \texttt{babel}
-% package and it is possible that in a future version it will be eliminated.
+% character is a normal math character, instead of a math punctuation mark. Actually the
+% code that defines the mathematical active comma is a new addition that lets the comma
+% perform correctly in its double function (decimal separator and punctuation mark). The
+% only point where this code fails is when a list of numbers is typeset: When a numeric list
+% must be typeset, such as, for example, $\forall i=0,\,1,\,2,\,3, n$, in the source code
+% a space \emph{must} be inserted after every punctuating comma while no space follows a
+% decimal comma: for example \verb*+$\forall i=0, 1, 2, 3,n$+. The space before the |n| is
+% not necessary (but it wouldn't hurt) beecause |n| is not recognized as a digit, therefore
+% the ``intelligent'' comma inserts the necessary space by itself.
%
% |\topmargin| set to 0pt simply means that the real top margin is 25.4mm, i.e.\ one
% inch, since the output offset is one inch by default.
% \begin{macrocode}
-\mathcode`\,="013B
+ \DeclareMathSymbol{\virgola}{\mathpunct}{letters}{"3B}
+ \DeclareMathSymbol{\virgoladecimale}{\mathord}{letters}{"3B}
+ \AtBeginDocument{\mathcode`\,=\string"8000}
+ {\catcode `,=\active \gdef,{\futurelet\let@token\m@thcomma}}
+\def\m@thcomma{\let\@tempB\virgola
+\@tfor\@tempA:=0123456789\do{%
+\expandafter\ifx\@tempA\let@token\let\@tempB\virgoladecimale
+\@break@tfor\fi}\@tempB}
+%
\catcode`\^^Z=10
\topmargin 0pt
% \end{macrocode}
@@ -1175,14 +1187,14 @@ the TOPtesi bundle]
% that start these sections depend on the used language.
%
% Because of this it is necessary to extend the list of infix string definitions provided
-% the |\captions|$\langle$\texttt{language}$\rangle$ macros defined by the
-% language description files of \texttt{babel}; for this purpose we define a macro for
-% adding new items for these two new sectioning commands. This macro receives three arguments:
-% the first is the babel language name, the second is the string for the summary name, and finally
-% the third is the string for the acknowledgements name; everything is contained within a group
-% and only the relevant captions macro is globally redefined. The token register `0' is normally
-% for scratch usage, but the fact that its value is restored upon exiting the
-% group provides the necessary protection against an involuntary reassignment
+% the |\captions|$\langle$\texttt{language}$\rangle$ macros defined by the language
+% description files of \texttt{babel}; for this purpose we define a macro for adding new
+% items for these two new sectioning commands. This macro receives three arguments: the
+% first is the babel language name, the second is the string for the summary name, and
+% finally the third is the string for the acknowledgements name; everything is contained
+% within a group and only the relevant captions macro is globally redefined. The token
+% register `0' is normally for scratch usage, but the fact that its value is restored upon
+% exiting the group provides the necessary protection against an involuntary reassignment
% to this register. At the same time if a specific language option was not
% specified, a warning message is issued, but compilations goes on any way
% without the sectioning string names. For being sure no other undefined error
@@ -1204,7 +1216,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:
+% by means of the newly available macros:
% \begin{macrocode}
\ExtendCaptions{italian}{Sommario}{Ringraziamenti}
\ExtendCaptions{english}{Summary}{Acknowledgements}
@@ -1213,8 +1225,8 @@ Skipping any redefinition\MessageBreak}%
% default; therefore both caption macros |\captionsitalian| 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 is not stopped. Therefore if, for example, the user wants to write the
-% thesis in Spanish, the thesis main file shall start like this:
+% 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:
% \begin{verbatim}
% \documentclass[...,spanish]{toptesi}
% \ExtendCaptions{spanish}{Resumen}{Agradecimientos}
@@ -1239,16 +1251,18 @@ Skipping any redefinition\MessageBreak}%
\def\english{\selectlanguage{english}}%
\let\inglese\english
% \end{macrocode}
-% At the beginning of the document the following commands are executed; the general macro |\italiano| sets the
-% summary and the acknowledgements names in Italian, as the default language; and the |\@chapapp|
-% macro is redefined so as to agree with the default language. If a different default language is desired,
-% we recall it again, it is necessary to do the following:
+% At the beginning of the document the following commands are executed; the general macro
+% |\italiano| sets the summary and the acknowledgements names in Italian, as the default
+% language; and the |\@chapapp| macro is redefined so as to agree with the default language.
+% If a different default language is desired, we recall it again, it is necessary to do the
+% following:
% \begin{itemize}
% \item specify |\english| \emph{after} the |\begin{document}| statement, if English is
-% supposed to be the default 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.
+% supposed to be the default 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.
% \end{itemize}
% \begin{macrocode}
\AtBeginDocument{%
@@ -1262,7 +1276,6 @@ Skipping any redefinition\MessageBreak}%
% \begin{macrocode}
\RequirePackage{topfront}
\RequirePackage{topcoman}
-\def\sf@size{7}
% \end{macrocode}
%
% \subsection{The \texttt{classica} option}
@@ -1270,10 +1283,10 @@ Skipping any redefinition\MessageBreak}%
% in humanities and the specifications came from Paolo Ciacchi, a student of the University
% of Trieste, who was preparing a master thesis in classical Greek philology. The necessity
% of the large normal size derived from the necessity of having clear mark-up signs among
-% the myriad philologists use, that sometimes let me believe that the philological mark-up
-% requires typesetting environments similar to the mathematical ones, since the material to
-% be typeset does not form a linear sequence, as in plain text, but a bi-dimensional
-% structure as in mathematics.
+% the myriad signs philologists use, that sometimes let me believe that the philological
+% mark-up requires typesetting environments similar to the mathematical ones, since the
+% material to be typeset does not form a linear sequence, as in plain text, but a
+% bi-dimensional structure as in mathematics.
%
% The other requirements involve the title page and I agreed to implement them, since they
% are likely to be useful for other universities as well; the effort for localizing this
@@ -1405,7 +1418,7 @@ Skipping any redefinition\MessageBreak}%
% \end{macrocode}
% Here |\annoaccademico| is defined that typesets the infix string corresponding to
% ``Anno accademico'' followed by the year range in old style numbers (irrespective
-% of the \texttt{oldstyle} option); Commands for the localization are provided so as
+% of the \texttt{oldstyle} option); localization commands are provided so as
% to set a different string, possibly through the configuration file. In order to set
% an adequate en-dash between the old style numbers a new definition is given that
% takes care to set the dash at a height above the base line that copes the specific
@@ -1432,14 +1445,14 @@ Skipping any redefinition\MessageBreak}%
\vrule\@width\dimen@\@height\dimen4\@depth-\dimen\tw@}}}
% \end{macrocode}
% The footnote rule separator is also longer that the default one. Dealing with notes
-% the footnote separator is also changes as well as the footnote skip. But the humanists
+% the footnote separator is also changed as well as the footnote skip. But the humanists
% like to have also unnumbered notes within numbered ones, as if they were two separate
% sets; of course specialized extensions are available on CTAN, but as a poor man solution
% the command |\nota| was introduced that inserts a note with a symbol as a note mark;
-% the symbol \emph{must} be a mathematica symbol as the dagger or the double dagger;
+% the symbol \emph{must} be a mathematical symbol as the dagger or the double dagger;
% by default it is the asterisk. At the same time the default definition of the mathematical
% asterisk is that of a binary operator; I have experienced that the note symbol gets a
-% better positioning if if is declared an ordinary symbol, treated as, say, a letter. This
+% better positioning if it is used as an ordinary symbol through |\mathord|. This
% is why its math code is redefined. A final unusual request was to be able to put a blank
% unnumbered note, as a (rather wide) note separator. The command |\NoteWhiteLine| has to
% be used at the end of the text of the preceding note.
@@ -1450,8 +1463,7 @@ Skipping any redefinition\MessageBreak}%
\kern5.6\p@}
\setlength\footnotesep{12\p@}
\setlength{\skip\footins}{24\p@ \@plus 4\p@ \@minus 2\p@}
-\DeclareMathSymbol{*}{\mathalpha}{symbols}{"03}
-\newcommand*\nota[1][*]{%
+\newcommand*\nota[1][\mathord{*}]{%
\xdef\@thefnmark{\ensuremath{\m@th#1}}\@footnotemark\@footnotetext
}
\newcommand*{\NoteWhiteLine}{\par\vspace*{-.3\baselineskip}}
@@ -1506,7 +1518,7 @@ Skipping any redefinition\MessageBreak}%
% all the patches to the macros |\not| and |\mapstochar| that produce problems with
% the format, because they have a declared width of 0\,pt; this is no problem for
% \texttt{latex} or \texttt{pdflatex}, but it is a problem for the PDF/A format.
-% Therefore these command must be replaced by equivalent ones that do not use zero-width
+% Therefore these commands must be replaced by equivalent ones that do not use zero-width
% glyps. For |\not|, another slash can be used, but in order to have it the right size
% in all math typesetting modes it is necessary to have a different command for
% every mode; this is achieved with the |\mathchoice| primitive as such:
@@ -1545,7 +1557,7 @@ Skipping any redefinition\MessageBreak}%
% a PDF/A compliant file; one might need to produce a traditional PDF file, or even a
% DVI file, to be converted to the PS format, in order to possibly further transform
% it to PDF/A by means of \texttt{ghostscript} (see the details in the
-% \texttt{ps2pdf.html} file belonging to the \texttt{ghostscript} documentationx).
+% \texttt{ps2pdf.html} file belonging to the \texttt{ghostscript} documentation).
%
% Finally, if the class option |pdfa| was specified, we load the |pdfx.sty| file
% with the suitable option for typesetting a (hopefully) PDF/A conforming file.
@@ -1557,40 +1569,42 @@ Skipping any redefinition\MessageBreak}%
\ifT@Ppdfa\RequirePackage[a-1b]{pdfx}\fi
%</topsty>
% \end{macrocode}
+%
% \subsection{The package file \texttt{topfront.sty}}
-% This file is input by \texttt{toptesi}, version 5.x, but it can be used as an
-% independent extension package.
+% This file is input by \texttt{toptesi}, but it can be used as an
+% independent extension package also with other classes.
%
-% It contains all the definition for the composition of just the title page
-% along the style requirements of \texttt{toptesi}, version 5.x.
-% It makes use of an optional configuration file where the user can define
+% It contains all the definitions for the composition of just the title page
+% along the style requirements of \texttt{toptesi}. Since version 5.x
+% it makes use of an optional configuration file where the user can define
% a lot of default information and all the infix language dependent strings
% that are peculiar to this title page.
%
% This file specifies that it requires the \LaTeXe\ format and identifies itself. Since the
% package might be used to extend the performances of other classes, this package does not
-% specify any input encoding, assuming that the calling class already provided this information.
+% specify any input encoding, assuming that the calling class already provided this
+% information.
% \begin{macrocode}
%<*topfrn>
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{topfront}[2011/04/11 v.5.04 Title page for TOPtesi]
+\ProvidesPackage{topfront}[2011/05/25 v.5.50 Title page for TOPtesi]
% \end{macrocode}
%
% The title page information depends on the type of ``thesis' that is being typeset.
% The following commands specify the kind of information that is going to be typeset.
% Some boolean variables are automatically set by the commands in order to change some
-% formatting depending on the kind of thesis. For languages that distinguish
-% feminine from masculine adjectives or qualifications some automatic machinery is
-% set up in order to format some infix strings in a way that copes with the singular or plural
-% forms; in particular when there is a multitude of authors (maximum three) of different gender
-% the adjectives or qualifications are set masculine plurals, while when there is just one author
-% or the authors are of the same gender the adjectives or qualifications are set according to
-% number and gender. Al this is done by setting or resetting the truth value associated to
-% the boolean variable \texttt{femminile}. The boolean variable \texttt{dottorato}
-% controls the PhD thesis format, while the other variable \texttt{laureatriennale}
-% controls the formatting of the bachelor's degree report. All other theses are treated
-% as master theses, and in all cases the appropiate infix string is typeset in the title
-% page
+% formatting depending on the kind of thesis. For languages that distinguish feminine from
+% masculine adjectives or qualifications some automatic machinery is set up in order to
+% format some infix strings in a way that copes with the singular or plural forms; in
+% particular when there is a multitude of authors (maximum three) of different gender the
+% adjectives or qualifications are set masculine plurals, while when there is just one
+% author or the authors are of the same gender the adjectives or qualifications are set
+% according to number and gender. Al this is done by setting or resetting the truth value
+% associated to the boolean variable \texttt{femminile}. The boolean variable
+% \texttt{dottorato} controls the PhD thesis format, while the other variable
+% \texttt{laureatriennale} controls the formatting of the bachelor's degree report. All
+% other theses are treated as master theses, and in all cases the appropriate infix string
+% is typeset in the title page
% \begin{macrocode}
\newif\iffemminile
\newif\ifdottorato \dottoratofalse
@@ -1690,36 +1704,33 @@ Skipping any redefinition\MessageBreak}%
\def\terzacandidata#1{\gdef\@thirdauthor{#1}}
% \end{macrocode}
%
-% The next set of macros is used to typeset the ``date'' of the
-% thesis defense or presentation or whatever is done for the final
-% exam. The macro si sort of complicated because the input format for this
-% ``date'' may vary from a single year, to a year range, to a month and year specification
-% so that different actions must be taken; if the option \texttt{classica} is in
-% force\footnote{This option cannot be active if this extension package is used to extend
-% a document class other than \texttt{toptesi}; nevertheless if the package \texttt{trieste.sty}
-% is loaded before this package, the relevant information equivalent to \texttt{classica}
-% is fully defined and this package works as it should.} then the formatting of the ``date''
-% may be still different. This command is aliased with |\esamendidottorato| which literally means
-% ``defense of the doctoral dissertation''; nevertheless both commands refer to a simple date in
-% one of those formats.
-%
-% |\getseduta| splits the date in its two components, month and year;
-% if the argument is a single string without intervening spaces, the first one is the string
-% itself and the second is empty; this emptiness may be tested and in case the date formatting
-% is modified accordingly.
-% In particular if the string is a single spaceless one, this string is
-% assigned to |\@submitdate|; otherwise a different treatment is made according to the fact that
-% \texttt{classica} is in force; if \texttt{classica} is not in force the total string,
+% The next set of macros is used to typeset the ``date'' of the thesis defense or
+% presentation or whatever is done for the final exam. The macro is sort of complicated
+% because the input format for this ``date'' may vary from a single year, to a year range,
+% to a month and year specification so that different actions must be taken; if the option
+% \texttt{classica} is in force\footnote{This option cannot be active if this extension
+% package is used to extend a document class other than \texttt{toptesi}.} then the
+% formatting of the ``date'' may be still different. This command is aliased with
+% |\esamendidottorato| which literally means ``defense of the doctoral dissertation'';
+% nevertheless both commands refer to a simple date in one of those formats.
+%
+% |\getseduta| splits the date in its two components, month and year; if the argument is a
+% single string without intervening spaces, the first one is the string itself and the
+% second is empty; this emptiness may be tested and in case the date formatting is modified
+% accordingly. In particular if the string is a single spaceless one, this string is
+% assigned to |\@submitdate|; otherwise a different treatment is made according to the fact
+% that \texttt{classica} is in force; if \texttt{classica} is not in force the total string,
% including spaces is assigned to |\@submitade|. If \texttt{classica} is in force,
% |\s@dutaTrieste| is called with the whole string. On turn |\s@dutaTrieste| verifies
-% if the date should be typeset with old style numbers or in the usual way; in the latter case
-% the whole string is assigned to |\@submitdate|; in the former one the year part may be a
-% single year or a year range; This separation is tested by splitting the year part across
-% one dash; If the dash is present the extremes of the year range are assigned to |\1| and |\2|,
-% otherwise the year part is a single year;. If a single year is given this is simply typeset
-% with old style numbers and the appropriate commands are assigned to the |\@submitdate|
-% control sequence.. If a year range is given, this year range is also typeset with old style
-% numbers, and the dash is executed with a regular en-dash surrounded with white space.
+% if the date should be typeset with old style numbers or in the usual way; in the latter
+% case the whole string is assigned to |\@submitdate|; in the former one the year part may
+% be a single year or a year range; This separation is tested by splitting the year part
+% across one dash; if the dash is present the extremes of the year range are assigned to
+% |\1| and |\2|, otherwise the year part is a single year;. If a single year is given this
+% is simply typeset with old style numbers and the appropriate commands are assigned to the
+% |\@submitdate| control sequence.. If a year range is given, this year range is also
+% typeset with old style numbers, and the dash is executed with a regular en-dash surrounded
+% with white space.
%
% \begin{macrocode}
\def\sedutadilaurea#1{\getseduta#1 !}
@@ -1765,29 +1776,26 @@ Skipping any redefinition\MessageBreak}%
% depending on the default language and the configuration file.
%
% |\scuoladidottorato| gets the name of the PhD School; |\ateneo| gets the the generic name
-% of the university; |\nomeateneo| gets the proper name of the university. In Italy Universities
-% are generally named after the city they are in; in large cities where there are several
-% universities, each one of them has a proper name. For example the generic name might be
-% ``Universit\`a di Roma'' and the proper name might be ``La Sapienza''.
-% |\facolta| receives an optional argument that is the uppercase roman numeral
-% specific of the faculty and a compulsory argument that corresponds to the
-% type of faculty; for example,
-% with |\facolta[II]{Ingegneria}| the package typesets in the title page
-% ``II Facolt\`a di Ingengeria''; if the optional argument is not specified non
-% roman numeral is typeset; the infix string \verb*+Facolt\`a di + may be
-% changed with the configuration file depending on the default language.
-% Finally |\logosede| gets the name of the graphic file that contains
-% the information relative to the university logo. If such logo is not
-% available, the user does not specify this command; if the user uses this
-% command to insert the university logo but the file is not available the usual
-% \texttt{graphicx} package warning is issued but compilation goes on
-% without the logo.
-% The |\tutoreaziendale| macro is the last addition; several students who work
-% on their thesis or final project in a company want to have the company
-% supervisor name printed in the
-% title page; this does not preclude expressing the student's deepest thanks in
-% the acknowledgements
-% section, but it does not harm ro name this person also in the title page.
+% of the university; |\nomeateneo| gets the proper name of the university.
+% In Italy Universities are generally named after the city they are in; in large cities
+% where there are several universities, each one of them has a proper name. For example the
+% generic name might be ``Universit\`a di Roma'' and the proper name might be ``La
+% Sapienza''.
+% |\facolta| receives an optional argument that is the uppercase roman numeral specific of
+% the faculty and a compulsory argument that corresponds to the type of faculty; for
+% example, with |\facolta[II]{Ingegneria}| the package typesets in the title page
+% ``II Facolt\`a di Ingengeria''; if the optional argument is not specified non roman
+% numeral is typeset; the infix string \verb*+Facolt\`a di + may be changed with the
+% configuration file depending on the default language.
+% Finally |\logosede| gets the name of the graphic file that contains the information
+% relative to the university logo. If such logo is not available, the user does not specify
+% this command; if the user uses this command to insert the university logo but the file is
+% not available the usual \texttt{graphicx} package warning is issued but compilation goes
+% on without the logo.
+% The |\tutoreaziendale| macro is the last addition; several students who work on their
+% thesis or final project in a company want to have the company supervisor name printed in
+% the title page; this does not preclude expressing the student's deepest thanks in the
+% acknowledgements section, but it does not harm ro name this person also in the title page.
% \begin{macrocode}
\def\ciclodidottorato#1{\gdef\@ciclo{#1 \@cyclename}}%
\def\corsodilaurea#1{\global\dottoratofalse\gdef\@corso{#1}}
@@ -1856,18 +1864,19 @@ Skipping any redefinition\MessageBreak}%
\newcommand\NomeQuartoTomo[1]{\gdef\QuartoTomo{#1}}
% \end{macrocode}
%
-% Now we can read the configuration file if it exists; in any case what is possibly
-% defined or redefined in the configuration file must not be redefined in the following
-% Lines and this is why everything is subject to the test |\@ifundefined|. Most default
-% definitions are simply ``blank''; the others are in Italian. All of them, except the
-% supervisor and candidate strings may be individually be redefined in the configuration file
-% or in the preamble. Those that cannot be redefined such as the four ``candidate'' strings
-% may be actually redefined through the only |\CandidateName| that should be used in a language depended
-% way and with the correct number and gender once for all. The four endings in the Italian
-% strings allow to exercise the correct selection only for Italian; a specific test is made
-% inside the |\frontespizio| command; because of this the same machinery cannot be used, say, for French
-% but may be in the future this feature is resolved in a proper way. The same is true for the supervisor
-% and the co-supervisor strings that may be changed once for all with |\AdvisorName| and |\CoAdvisorName|.
+% Now we can read the configuration file if it exists; in any case what is possibly defined
+% or redefined in the configuration file must not be redefined in the following lines and
+% this is why everything is subject to the test |\@ifundefined|. Most default definitions
+% are simply ``blank''; the others are in Italian. All of them, except the supervisor and
+% candidate strings may be individually be redefined in the configuration file or in the
+% preamble. Those that cannot be redefined such as the four ``candidate'' strings may be
+% actually redefined through the only |\CandidateName| that should be used in a language
+% dependent way and with the correct number and gender once for all. The four endings in the
+% Italian strings allow to exercise the correct selection only for Italian; a specific test
+% is made inside the |\frontespizio| command; because of this the same machinery cannot be
+% used, say, for French but may be in the future this feature is resolved in a proper way.
+% The same is true for the supervisor and the co-supervisor strings that may be changed once
+% for all with |\AdvisorName| and |\CoAdvisorName|.
% \begin{macrocode}
\IfFileExists{toptesi.cfg}{\input{toptesi.cfg}}{}
%
@@ -1977,11 +1986,11 @@ Skipping any redefinition\MessageBreak}%
\evensidemargin \oddsidemargin
% \end{macrocode}
%
-% We select the \texttt{myheadings} page style; setting the page counter to zero
-% is a remain of old settings, but it does not hurt; the |\null| command inserts a void horizontal box
-% into the vertical list; it is useful to act as a block against which the vertical glue pushes
-% for setting the subsequent material. The normal font is chosen in case preceding commands did change
-% the font characteristics.
+% We select the \texttt{myheadings} page style; setting the page counter to zero is a remain
+% of old settings, but it does not hurt; the |\null| command inserts a void horizontal box
+% into the vertical list; it is useful to act as a block against which the vertical glue
+% pushes for setting the subsequent material. The normal font is chosen in case preceding
+% commands did change the font characteristics.
% \begin{macrocode}
\thispagestyle{myheadings}%
\null\setcounter{page}{1}%
@@ -2011,9 +2020,9 @@ Skipping any redefinition\MessageBreak}%
\fi
\par\medskip}%
% \end{macrocode}
-% Further specification: it inserts the field of the PhD research or the degree course name; for example
-% it inserts the line ``Philosophy Degree in Applied Tetratricotomy~--~XVI~cycle'' or
-% ``Master of Science in Applied Tetratricotomy''.
+% Further specification: it inserts the field of the PhD research or the degree course name;
+% for example it inserts the line ``Philosophy Degree in Applied Tetratricotomy~--VI~cycle''
+% or ``Master of Science in Applied Tetratricotomy''.
% \begin{macrocode}
\ifx\@corso\empty \else{\large
\ifdottorato
@@ -2025,8 +2034,9 @@ Skipping any redefinition\MessageBreak}%
\fi
\end{center}
% \end{macrocode}
-% It now centers the name of the report, be it ``Doctoral Dissertation'' or ``Master Thesis'' or whatever; in case
-% the command |\materia| was used, it then centers the area which the thesis deals with.
+% It now centers the name of the report, be it ``Doctoral Dissertation'' or ``Master
+% Thesis'' or whatever; in case the command |\materia| was used, it then centers the area
+% which the thesis deals with.
% \begin{macrocode}
\vfill
\begin{center}
@@ -2045,7 +2055,8 @@ Skipping any redefinition\MessageBreak}%
\fi
\end{center}
% \end{macrocode}
-% Next comes the real title entered with |\titolo| or |\monografia| and the possible subtitle.
+% Next comes the real title entered with |\titolo| or |\monografia| and the possible
+% subtitle.
% \begin{macrocode}
\vfill
\begin{center}
@@ -2059,11 +2070,11 @@ Skipping any redefinition\MessageBreak}%
\end{center}%
\fi
% \end{macrocode}
-% If the option \texttt{classica} is in force the thesis might be divided in several volumes;
-% apparently these in humanities are often oversized. In this case the |\frontespizio|
-% command may be given at the beginning of every volume and the counter \texttt{tomo} is
-% stepped up; the volume number is therefore printed in each title page; the infix string
-% may be redefined as it was shown above.
+% If the option \texttt{classica} is in force the thesis might be divided in several
+% volumes; apparently these in humanities are often oversized. In this case the
+% |\frontespizio| command may be given at the beginning of every volume and the counter
+% \texttt{tomo} is stepped up; the volume number is therefore printed in each title page;
+% the infix string may be redefined as it was shown above.
% \begin{macrocode}
\expandafter
\ifx\csname StileTrieste\endcsname\relax
@@ -2087,21 +2098,22 @@ Skipping any redefinition\MessageBreak}%
\fi
\par
% \end{macrocode}
-% Going down in the title page now comes the optional insertion of the university logo; this is a simple task
-% once |\@logosede| has been defined, and this was done either with an explicit command |\logosede| with its argument
-% in the preamble, or a specific line in the configuration file.
+% Going down in the title page now comes the optional insertion of the university logo;
+% this is a simple task once |\@logosede| has been defined, and this was done either with
+% an explicit command |\logosede| with its argument in the preamble, or a specific line in
+% the configuration file.
% \begin{macrocode}
\ifx\@logosede\@empty\else
\vspace*{\bigskipamount}
{\centering \@logosede\par}\fi
% \end{macrocode}
%
-% the final task is to typeset the possible supervisors' names, the candidates' names and all the rest
-% of the bureaucratical terms. We have to distinguish between a bachelor degree report that is not
-% supposed to have a supervisor, from the doctoral dissertation where we do not indicate the supervisor, but
-% the School Director, and the master thesis where there might be one or more supervisors; with the
-% \texttt{classica} option in force no label is printed over the supervisor's name, unless there is
-% a plurality od supervisors.
+% The final task is to typeset the possible supervisors' names, the candidates' names and
+% all the rest of the bureaucratical terms. We have to distinguish between a bachelor degree
+% report that is not supposed to have a supervisor, from the doctoral dissertation where we
+% do not indicate the supervisor, but the School Director, and the master thesis where there
+% might be one or more supervisors; with the \texttt{classica} option in force no label is
+% printed over the supervisor's name, unless there is a plurality od supervisors.
% \begin{macrocode}
\vfill
\iflaureatriennale
@@ -2120,10 +2132,11 @@ Skipping any redefinition\MessageBreak}%
\fi
\fi
% \end{macrocode}
-% Similarly the label names for the exam candidates are chosen; in Italian the names are infix strings
-% that are selected according the gender and the number; if these labels have to be set in a different language
-% it is necessary to define one string that has to be selected by the user according to number and gender.
-% The label for the doctorship is left empty.
+% Similarly the label names for the exam candidates are chosen; in Italian the names are
+% infix strings that are selected according the gender and the number; if these labels have
+% to be set in a different language it is necessary to define one string that has to be
+% selected by the user according to number and gender. The label for the doctorship is left
+% empty.
% \begin{macrocode}
\ifdottorato
\let\@nomecandidato\empty
@@ -2144,23 +2157,25 @@ Skipping any redefinition\MessageBreak}%
\fi
% \end{macrocode}
%
-% For the names of the supervisor(s) and of the candidate(s) a different approach is used for each one
-% of the three categories of theses. If a bachelor degree report is dealt with, the name of the \emph{only}
-% candidate is centerd and written in caps-and-small-caps.
+% For the names of the supervisor(s) and of the candidate(s) a different approach is used
+% for each one of the three categories of theses. If a bachelor degree report is dealt with,
+% the name of the \emph{only} candidate is centerd and written in caps-and-small-caps.
% \begin{macrocode}
\iflaureatriennale
\begin{center}%
\large\mdseries\textsc{\@author}
\end{center}%
% \end{macrocode}
-% For doctoral and master theses two virtual boxes (actually macros) are filled up so as to align
-% the supervisor name(s) and, in second virtual box, the candidate name(s). The label is set in the
-% first line with proper number and gender; in the second line the first name, and in the subsequent lines,
-% if there are any, the other names. These virtual boxes actually contain a tabular environment each; these
-% environments shall be actually typeset when these virtual box macros are executed. If the \texttt{classica}
-% option is in force no label is set over the principal advisor name, but a label is set over the co-advisor
-% name(s). The type size is also e little different for the \texttt{classica} option. The |\protect| command
-% is used to protect the names in case they contain accent macros that might be expanded at the wrong moment.
+% For doctoral and master theses two virtual boxes (actually macros) are filled up so as to
+% align the supervisor name(s) and, in second virtual box, the candidate name(s). The label
+% is set in the first line with proper number and gender; in the second line the first name,
+% and in the subsequent lines, if there are any, the other names. These virtual boxes
+% actually contain a tabular environment each; these environments shall be actually typeset
+% when these virtual box macros are executed. If the \texttt{classica} option is in force no
+% label is set over the principal advisor name, but a label is set over the co-advisor
+% name(s). The type size is also e little different for the \texttt{classica} option. The
+% |\protect| command is used to protect the names in case they contain accent macros that
+% might be expanded at the wrong moment.
% \begin{macrocode}
\else
% Per laurea e dottorato con relatori e correlatori...
@@ -2205,12 +2220,12 @@ Skipping any redefinition\MessageBreak}%
}%
% \end{macrocode}
% The real typesetting of these name lists takes place now; if the thesis is referred to the
-% PhD school one type of layout is used, otherwise the default master thesis layout is used; remember
-% that the bachelor degree case has already taken place. For the doctoral dissertation the doctoring
-% person name is typeset centered in one line by itself and everything else is set 3em below
-% into a three column table extended to the |\hsize|, the first line containing the person labels
-% and the second line containing the true names. The central column is used just for spacing, but it does
-% not contain anything.
+% PhD school one type of layout is used, otherwise the default master thesis layout is used;
+% remember that the bachelor degree case has already taken place. For the doctoral
+% dissertation the doctoring person name is typeset centered in one line by itself and
+% everything else is set 3em below into a three column table extended to the |\hsize|, the
+% first line containing the person's qualifiers and the second line containing the true
+% names. The central column is used just for spacing, but it does not contain anything.
% \begin{macrocode}
\ifdottorato
\begin{center}\large
@@ -2237,9 +2252,10 @@ Skipping any redefinition\MessageBreak}%
\end{center}
\else
% \end{macrocode}
-% For the master thesis the two virtual boxes are set one besides the other but skewed
-% so that to the right or, respectively, to the left of every name there is enough space for the signatures.
-% With the \texttt{classica} option in force the two boxes are simply aligned.
+% For the master thesis the two virtual boxes are set one besides the other but skewed so
+% that to the right or, respectively, to the left of every name there is enough space for
+% the signatures. With the \texttt{classica} option in force the two boxes are simply
+% aligned.
% \begin{macrocode}
\@ifundefined{StileTrieste}{%
\begin{flushleft}%
@@ -2262,8 +2278,8 @@ Skipping any redefinition\MessageBreak}%
\@tutoreaziendale\par}
\fi
% \end{macrocode}
-% All the material now is on the page; we put some more vertical glue and we close
-% the page sending it to the output file; the final |\endgroup| closes the |\begingroup| that was
+% All the material now is on the page; we put some more vertical glue and we close the page
+% sending it to the output file; the final |\endgroup| closes the |\begingroup| that was
% set at the beginning of this long macro.
% \begin{macrocode}
\vfill\par\null
@@ -2307,7 +2323,7 @@ Skipping any redefinition\MessageBreak}%
%<*topcmn>
\NeedsTeXFormat{LaTeX2e} % lavora solo con LaTeX 2e
\ProvidesPackage{topcoman}%
- [2008/12/15 v.5.00 Additional commands for the TOPtesi bundle]
+ [2011/05/25 v.5.50 Additional commands for the TOPtesi bundle]
% \end{macrocode}
% The new command |\DeclareSlantedCapitalGreekLetters| optionally sets the capital
% Greek letters in math mode with the glyphs taken from the math italic fonts, not from
@@ -2334,11 +2350,11 @@ Skipping any redefinition\MessageBreak}%
% \begin{macrocode}
\providecommand{\ensuremath}[1]{\ifmmode#1\else$#1$\fi}%
% \end{macrocode}
-% The following commands may be already defined; should they be missing they are supplied here.
-% The greatest part of them is already defined in the Italian option to the
-% \texttt{babel} language; but remember; this package may be used as a stand alone one, without
-% the initial call by the \texttt{toptesi} document class, so that the language Italian might
-% be undefined.
+% The following commands may be already defined; should they be missing they are supplied
+% here. The greatest part of them is already defined in the Italian option to the
+% \texttt{babel} language; but remember; this package may be used as a stand alone one,
+% without the initial call by the \texttt{toptesi} document class, so that the language
+% Italian might be undefined.
% \begin{macrocode}
\providecommand{\ohm}{\ensuremath{{\mathrm{\Omega}}}}
\providecommand{\ped}[1]{\ensuremath{_{\mathrm{#1}}}}
@@ -2433,192 +2449,6 @@ Skipping any redefinition\MessageBreak}%
\DisableFigTabNames
%</topcmn>
% \end{macrocode}
-% \subsection{The class option file \texttt{topsiz14.clo}}
-% Among the options available there is the possibility of typesetting the thesis with
-% a large normal font size, specifically 14pt. The following file is just a copy of the
-% other size??.clo class option files where the font dimensions have been modified so
-% as to be coherent whit a normal size of 14pt. There is nothing unusual except that
-% the font sizes are taken from the kernel macros where the magic numbers of non
-% integer sizes are specified. The baseline skips are substantially the ones taken
-% from the 10pt default size and multiplied by 1.44, or those of the 12pt option
-% multiplied by 12; in both cases they were rounded to integers most of the times.
-% Since the whole bundle works only under \LaTeXe, we deleted all the tests for
-% compatibility with \LaTeX\,209 and the corresponding test branches.
-% \begin{macrocode}
-%<*top14>
-\NeedsTeXFormat{LaTeX2e}
-\ProvidesFile{topsiz14.clo}%
- [2008/12/15 v.5.00 TopTesi 14pt size-option file]
-\renewcommand\normalsize{%
- \@setfontsize\normalsize\@xivpt{18}%
- \abovedisplayskip 14\p@ \@plus3\p@ \@minus7\p@
- \abovedisplayshortskip \z@ \@plus3\p@
- \belowdisplayshortskip 8.5\p@ \@plus3.5\p@ \@minus3\p@
- \belowdisplayskip \abovedisplayskip
- \let\@listi\@listI}
-\normalsize
-\renewcommand\small{%
- \@setfontsize\small\@xiipt{14}%
- \abovedisplayskip 13\p@ \@plus3\p@ \@minus6\p@
- \abovedisplayshortskip \z@ \@plus3\p@
- \belowdisplayshortskip 7.5\p@ \@plus3.5\p@ \@minus3\p@
- \def\@listi{\leftmargin\leftmargini
- \topsep 9\p@ \@plus3\p@ \@minus5\p@
- \parsep 4.5\p@ \@plus2\p@ \@minus\p@
- \itemsep \parsep}%
- \belowdisplayskip \abovedisplayskip
-}
-\renewcommand\footnotesize{%
- \@setfontsize\footnotesize\@xipt{13}
- \abovedisplayskip 12\p@ \@plus2\p@ \@minus5\p@
- \abovedisplayshortskip \z@ \@plus3\p@
- \belowdisplayshortskip 7\p@ \@plus3\p@ \@minus3\p@
- \def\@listi{\leftmargin\leftmargini
- \topsep 6\p@ \@plus2\p@ \@minus2\p@
- \parsep 3\p@ \@plus2\p@ \@minus\p@
- \itemsep \parsep}%
- \belowdisplayskip \abovedisplayskip
-}
-\renewcommand\scriptsize{\@setfontsize\scriptsize\@xpt{12}}
-\renewcommand\tiny{\@setfontsize\tiny\@viiipt\@xpt}
-\renewcommand\large{\@setfontsize\large\@xviipt{22}}
-\renewcommand\Large{\@setfontsize\Large\@xxpt{25}}
-\renewcommand\LARGE{\@setfontsize\LARGE\@xxvpt{30}}
-\renewcommand\huge{\@setfontsize\huge\@xxvpt{30}}
-\let\Huge=\huge
-\if@twocolumn
- \setlength\parindent{1em}
-\else
- \setlength\parindent{1.5em}
-\fi
-\setlength\smallskipamount{3.5\p@ \@plus 1\p@ \@minus 1\p@}
-\setlength\medskipamount{7\p@ \@plus 2\p@ \@minus 2\p@}
-\setlength\bigskipamount{14\p@ \@plus 4\p@ \@minus 4\p@}
-\setlength\headheight{14\p@}
-\setlength\headsep {36\p@}
-\setlength\topskip {14\p@}
-\setlength\footskip{30\p@}
-\if@compatibility \setlength\maxdepth{4\p@} \else
-\setlength\maxdepth{.5\topskip} \fi
- \setlength\@tempdima{\paperwidth}
- \addtolength\@tempdima{-2in}
- \setlength\@tempdimb{390\p@}
- \if@twocolumn
- \ifdim\@tempdima>2\@tempdimb\relax
- \setlength\textwidth{2\@tempdimb}
- \else
- \setlength\textwidth{\@tempdima}
- \fi
- \else
- \ifdim\@tempdima>\@tempdimb\relax
- \setlength\textwidth{\@tempdimb}
- \else
- \setlength\textwidth{\@tempdima}
- \fi
- \fi
- \@settopoint\textwidth
- \setlength\@tempdima{\paperheight}
- \addtolength\@tempdima{-2in}
- \addtolength\@tempdima{-1.5in}
- \divide\@tempdima\baselineskip
- \@tempcnta=\@tempdima
- \setlength\textheight{\@tempcnta\baselineskip}
-\addtolength\textheight{\topskip}
-\if@twocolumn
- \setlength\marginparsep{10\p@}
-\else
- \setlength\marginparsep{10\p@}
-\fi
-\setlength\marginparpush{7\p@}
- \if@twoside
- \setlength\@tempdima {\paperwidth}
- \addtolength\@tempdima {-\textwidth}
- \setlength\oddsidemargin {.4\@tempdima}
- \addtolength\oddsidemargin {-1in}
- \setlength\marginparwidth {.6\@tempdima}
- \addtolength\marginparwidth {-\marginparsep}
- \addtolength\marginparwidth {-0.4in}
- \else
- \setlength\@tempdima {\paperwidth}
- \addtolength\@tempdima {-\textwidth}
- \setlength\oddsidemargin {.5\@tempdima}
- \addtolength\oddsidemargin {-1in}
- \setlength\marginparwidth {.5\@tempdima}
- \addtolength\marginparwidth {-\marginparsep}
- \addtolength\marginparwidth {-0.4in}
- \addtolength\marginparwidth {-.4in}
- \fi
- \ifdim \marginparwidth >2in
- \setlength\marginparwidth{2in}
- \fi
- \@settopoint\oddsidemargin
- \@settopoint\marginparwidth
- \setlength\evensidemargin {\paperwidth}
- \addtolength\evensidemargin{-2in}
- \addtolength\evensidemargin{-\textwidth}
- \addtolength\evensidemargin{-\oddsidemargin}
- \@settopoint\evensidemargin
- \setlength\topmargin{\paperheight}
- \addtolength\topmargin{-2in}
- \addtolength\topmargin{-\headheight}
- \addtolength\topmargin{-\headsep}
- \addtolength\topmargin{-\textheight}
- \addtolength\topmargin{-\footskip}
- \addtolength\topmargin{-.5\topmargin}
- \@settopoint\topmargin
-\setlength\footnotesep{10.4\p@}
-\setlength{\skip\footins}{13\p@ \@plus 4\p@ \@minus 2\p@}
-\setlength\floatsep {14\p@ \@plus 2\p@ \@minus 4\p@}
-\setlength\textfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
-\setlength\intextsep {16\p@ \@plus 4\p@ \@minus 4\p@}
-\setlength\dblfloatsep {16\p@ \@plus 2\p@ \@minus 4\p@}
-\setlength\dbltextfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
-\setlength\@fptop{0\p@ \@plus 1fil}
-\setlength\@fpsep{10\p@ \@plus 2fil}
-\setlength\@fpbot{0\p@ \@plus 1fil}
-\setlength\@dblfptop{0\p@ \@plus 1fil}
-\setlength\@dblfpsep{10\p@ \@plus 2fil}
-\setlength\@dblfpbot{0\p@ \@plus 1fil}
-\setlength\partopsep{3\p@ \@plus 2\p@ \@minus 2\p@}
-\def\@listi{\leftmargin\leftmargini
- \parsep 5\p@ \@plus2.5\p@ \@minus\p@
- \topsep 10\p@ \@plus4\p@ \@minus6\p@
- \itemsep5\p@ \@plus2.5\p@ \@minus\p@}
-\let\@listI\@listi
-\@listi
-\def\@listii {\leftmargin\leftmarginii
- \labelwidth\leftmarginii
- \advance\labelwidth-\labelsep
- \topsep 5\p@ \@plus2.5\p@ \@minus\p@
- \parsep 2.5\p@ \@plus\p@ \@minus\p@
- \itemsep \parsep}
-\def\@listiii{\leftmargin\leftmarginiii
- \labelwidth\leftmarginiii
- \advance\labelwidth-\labelsep
- \topsep 2.5\p@\@plus\p@\@minus\p@
- \parsep \z@
- \partopsep \p@ \@plus\z@ \@minus\p@
- \itemsep \topsep}
-\def\@listiv {\leftmargin\leftmarginiv
- \labelwidth\leftmarginiv
- \advance\labelwidth-\labelsep}
-\def\@listv {\leftmargin\leftmarginv
- \labelwidth\leftmarginv
- \advance\labelwidth-\labelsep}
-\def\@listvi {\leftmargin\leftmarginvi
- \labelwidth\leftmarginvi
- \advance\labelwidth-\labelsep}
-%</top14>
-% \end{macrocode}
% \Finale
% \endinput
-%
-%@OldClaudio: se ci leggi, ricordati di correggere nel file toptesi.cfg fornito di default la riga
-%Codice:
-%\FacoltaDi{Facolt\`a di }% fatto 2010/05/09
-%
-%che è sbagliata: con l'impostazione data, tra "Facoltà di" e il nome della facoltà ci sono due spazi. Probabilmente è meglio che quelle righe siano commentate. La riga 222 di topfront.sty dovrebbe essere
-%Codice:
-%\@faculty\space\@facname
-%
-%Ci sono altri \expandafter inutili alle righe 214, 253, 257, 263, 346 e 384.
+% \ No newline at end of file