toptesi (16nov10)

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

2 files changed, 235 insertions, 248 deletions

diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
index af35263e2d9..1b1cc98ce47 100644
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
+++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
@@ -1,4 +1,64 @@
 % \iffalse meta-comment
+%<*internal>
+\begingroup
+\input docstrip.tex
+\keepsilent
+\preamble
+  ______________________________________________________
+  The TOPtesi package 
+  Copyright (C) 2010 Claudio Beccari 
+  All rights reserved
+
+  License information appended
+
+\endpreamble
+\postamble
+
+Copyright 2005-2010 Claudio Beccari
+
+Distributable under the LaTeX Project Public License,
+version 1.3c or higher (your choice). The latest version of
+this license is at: http://www.latex-project.org/lppl.txt
+
+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,
+trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+ 
+Furthermore the bundle contains the documentation source file toptesi-doc.tex  
+and the derived file toptesi-doc.pdf.
+
+The toptesi-example.tex source file is just an example that shows how
+to use the various commands; by commenting or decommenting certain
+source lines it is possible to typeset different kind of theses and their
+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
+and the English documentation file in pdf format.
+
+The documentation file toptesi-doc.pdf is in Italian; its source file is 
+another example of how to use toptesi.
+\endpostamble
+\askforoverwritefalse
+
+\generateFile{toptesi.cls}{t}{\from{toptesi.dtx}{class}}
+\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{trieste.sty}{t}{\from{toptesi.dtx}{toptrst}}
+\generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}}
+
+\def\tmpa{plain}
+\ifx\tmpa\fmtname\endgroup\expandafter\bye\fi
+\endgroup
+%</internal>
 %
 % Copyright 1989--2006 Claudio Beccari
 %
@@ -27,7 +87,7 @@
 % \iffalse
 %<*driver>
 \documentclass{ltxdoc}
-\ProvidesFile{toptesi.dtx}[2010/05/09 v.5.01 Documented TeX file for
+\ProvidesFile{toptesi.dtx}[2010/11/14 v.5.02 Documented TeX file for
 the TOPtesi bundle]
 \GetFileInfo{toptesi.dtx}
 \title{The TOPtesi bundle}
@@ -42,7 +102,7 @@ the TOPtesi bundle]
 %</driver>
 % \fi
 %
-% \CheckSum{2905}
+% \CheckSum{2917}
 %
 %% \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
@@ -63,14 +123,15 @@ the TOPtesi bundle]
 % \begin{abstract}
 % This file describes the TOPtesi bundle; it is a set of files designed to
 % typeset with \LaTeX\ a university final report that in Italian is generally
-% called ``tesi''; It was originally developed at the Technical University
+% called ``tesi''; it was originally developed at the Technical University
 % of Turin (Politecnico di Torino) but it was adapted for typesetting theses in any
 % Italian university. Well\dots\ since the Erasmus student mobility is very
 % extended and many Italian students participate in the so called \textit{double degree}
-% programs; their theses, or whatever they are called in other countries,
+% programs, their theses, or whatever they are called in other countries,
 % may be typeset so as to comply also with the host university rules; therefore this
 % set of files has the ambition to be suited for typesetting theses in any university in the
-% world\dots
+% world\dots\ This ambition can't be fulfilled, though, because of the complexity of the
+% title page (and possibly of the legal page) requirements.
 % \end{abstract}
 %
 % \section{Introduction}
@@ -93,46 +154,48 @@ the TOPtesi bundle]
 % independent extension package to be added to, say, the report class file for typesetting
 % just the title page; this file might be used as a template for setting up the
 % title page fixed information in languages different from Italian.
-% \item A third extension package \texttt{topcomand.sty} that defines a certain number
+% \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 so important
-% ones, but they may be preferred also in other faculties so that the suitable option
+% 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 both in \texttt{.eps} and in
-% \texttt{.jpg} or \texttt{.pdf} formats; such logos are included for the user sake, but
+% \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 is strongly advised to look up such regulations in each university Web
-% site.
+% each university and it is strongly advised to look up such regulations in each
+% university Web site.
 % \item A documentation file \texttt{toptesi-doc.pdf} written in Italian where every feature
-% is explained in detail; simpler information is given in this English documentation.
+% is explained in detail; essential information is given in this English documentation.
 % \end{itemize}
 %
 % The above files are complemented with a configuration file that any user may
 % personalize at will; these personalizations make it easy to configure the
 % bundle so as to make it suitable for another language; in facts the \textsf{babel}
-% package contains localizations for many languages but they refer to the standard
-% infix \LaTeX\ names and phrases and they do not cope with the thesis title page requirements.
+% package contains localizations for many languages, but such localisations deal
+% with the standard infix \LaTeX\ names and phrases and do not cope with the thesis
+% title page requirements.
 %
 % \section{User commands}
 % The \texttt{toptesi.cls} is basically an extension of the standard class
-% \texttt{report.cls}; It redefines the page typesetting grid, the headers and the footers,
+% \texttt{report.cls}; it redefines the page typesetting grid, the headers and the footers,
 % and the title page layout and commands.
 % \texttt{toptesi.cls} does not set such crazy settings as ``double spaced'' text; it is
 % intended to typeset the thesis with the quality of a \LaTeX\ well typeset document, not as
 % a typewriter written one. I suppose that typewriter documents have completely vanished
 % except perhaps in the legal professions, especially in Italy where legal documents have to
-% be written on special paper produced by the State Polygraphic Institute and carrying a
+% be written on special paper produced by the State Polygraphic Institute and carry a
 % watermark and the Republic's Seal; without a special printer it would be very difficult to
-% typeset on such a paper.
+% typeset from a computer on such a custom paper.
 %
 % Theses very often are full of specialized material: formulas, diagrams and pictures,
-% 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 should be banned.
+% 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
+% should be banned.
 %
 % Most new commands refer themselves to the information that should be typeset in the
 % title page; some class options specify special stylistic page details; the rest is simple
@@ -154,23 +217,24 @@ the TOPtesi bundle]
 %
 % \Item[cucitura]  In two sided printing it is better to move the
 % typesetting grid towards the outer edges so as to cope with the thesis binding
-% that is generally not made by sawing a number of signatures; the outer displacement
-% is fixed to~7mm.
+% that is generally not made up by sewing together a number of signatures;
+% the default outer displacement is fixed to~7mm, but it can be customized by means
+% of a proper entry in the configuration file or by an explicit command in the preamble.
 %
 % \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 e different way from what is being done with the \texttt{extsizes} bundle of
-% classes; this is why the original \texttt{size14.clo} class option file has been renamed
+% 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.
 %
-% \Item[autoretitolo] This option modifies the left handed (even numbered) pages
-% in two side typesetting; normally the even numbered headings contain
+% \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
+% 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
@@ -192,8 +256,9 @@ the TOPtesi bundle]
 % typeset, possibly with hilarious results\dots
 %
 % Since most users are supposed to be Italian, the user commands are mostly in Italian;
-% the following description gives their names and meanings; every command receives an argument;
-% only the command |\title| accepts an optional argument according to the usual \LaTeX\ syntax:
+% the following description gives their names and meanings; every command receives one
+% argument; only the command |\title| accepts an optional argument according to the usual
+% \LaTeX\ syntax:
 % \[
 %   \makebox[0pt]{%
 %       \texttt{\char92}\emph{command}\relax
@@ -216,54 +281,58 @@ the TOPtesi bundle]
 % \Item[coordinatore]  gets the name of the Doctoral School Coordinator
 % \Item[QualificaDirettore]  gets the phrase that describes the director or coordinator
 %                 official position; by using the command \cs{direttore} the default phrase
-%                 ``Direttore della Scuola di Dottorato'' is printed over the ``director's'' name;
+%                 ``Direttore della Scuola di Dottorato'' is printed above the 
+%                 ``director's'' name;
 %                 if \cs{coordinatore} is used the default phrase ``Coordinatore della
 %                 Scuola di Dottorato'' is printed instead. If neither one is applicable or a
 %                 description in another language is required, this macro is available for
 %                 specifying such position.
-% \Item[relatore]  gets the name of thesis first supervisor
+% \Item[relatore]  gets the name of the thesis first supervisor
 % \Item[secondorelatore]  gets the name of the second supervisor
-% \Item[terzorelatore]  gets the name of the third supervisor; it is assumed that the number of supervisors
-%                 never exceeds three.
+% \Item[terzorelatore]  gets the name of the third supervisor; it is assumed that the
+%                 number of supervisors never exceeds three.
 % \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 over this
-%                 person's name.
+%                 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[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
 %                   thesis has been supervised by more than one person.
-% \Item[CoAdvisorName] gets the string that qualifies the co-supervisor(s); the default string is
-%                 ``Correlatore:'' or ``Correlatori:'' in the plural; this command may be used to
-%                   define the string, say, ``Corapporteur:'' in a French Projet de fin
-%                   d'\'etudes.
-% \Item[candidato]  gets the name of the male student
-% \Item[candidata]  gets the name of the female student
-% \Item[secondocandidato]  gets the name of the second male student
-% \Item[secondacandidata]  gets the name of the second female student
-% \Item[terzocandidato]  gets the name of the third male student
-% \Item[terzacandidata]  gets the name of the third female student; most often the thesis
+% \Item[CoAdvisorName] gets the string that qualifies the co-supervisor(s); the default
+%                   string is ``Correlatore:'' or ``Correlatori:'' in the plural; this
+%                   command may be used to define the string, say, ``Corapporteur:'' in a
+%                   French Projet de fin d'\'etudes.
+% \Item[candidato]  gets the name of the male author
+% \Item[candidata]  gets the name of the female author
+% \Item[secondocandidato]  gets the name of the second male author
+% \Item[secondacandidata]  gets the name of the second female author
+% \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.
+%                 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 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 ``Laureato:''; in other languages
-%                 it is necessary to specify this string in the proper gender and number
-% \Item[sedutadilaurea]  gets the date of the final exam, or presentation, or defense of the
+% \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
+%                 languages it is necessary to specify this string in the proper gender and
+%                 number.
+% \Item[sedutadilaurea] gets the date of the final exam, or presentation, or defense of the
 %                 thesis; if this date is omitted the default date is the current
-%                 month and year in Italian
-% \Item[esamedidottorato]  an alias for \cs{sedutadilaurea} to be used for doctoral dissertations
-% \Item[ciclodidottorato]  gets the roman numeral that specifies the doctoral cycle
+%                 month and year in Italian.
+% \Item[esamedidottorato] an alias for \cs{sedutadilaurea} to be used for doctoral
+%                 dissertations.
+% \Item[ciclodidottorato]  gets the roman numeral that specifies the doctoral cycle.
 % \Item[CycleName]  redefines the string that expresses the name of the doctoral cycle;
 %                 by default this is ``ciclo'' but this command is useful to set the
 %                 name in a different language.
-% \Item[corsodilaurea]  gets the proper name of the degree course; the phrase that describes
+% \Item[corsodilaurea] gets the proper name of the degree course; the phrase that describes
 %                 the degree course is specified, if necessary, with the following
 %                 command; with this one you specify just, say, ``Electrical Engineering''
 % \Item[CorsoDiLaureaIn]  gets the generic name of the degree course, for example ``Bachelor
@@ -274,71 +343,97 @@ the TOPtesi bundle]
 %                 it is ``Monografia di Laurea''. In some Italian universities it might
 %                 be called ``Tesi di Laurea'', so that the master thesis should be given
 %                 another qualification, for example ``Tesi di Laurea Magistrale''.
-% \Item[NomeDissertazione]  gets the phrase that describes the doctoral thesis; by default it is
-%                 ``Tesi di Dottorato''.
+% \Item[NomeDissertazione]  gets the phrase that describes the doctoral thesis; by default
+%                 it is ``Tesi di Dottorato''.
 % \Item[InName]  infix strings often require adjusting of the prepositions; this macro gets
 %                 the preposition that stands for ``in'' (the default). In German it might
-%                 become ``auf''
+%                 become ``auf''.
 % \Item[NomeAnnoAccademico] defines the infix string that stands for ``Academic year''.
-%                 This macro is
-%                 defined only if the option \texttt{classica} is in force; 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.
+%                 This macro is defined only if the option \texttt{classica} is in force;
+%                 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.
+% \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.
 % \end{description}
 %
 % Since the infix strings are all memorized into control sequences and for each of them it
 % is possible to use a defining command, all strings can be modified at will, so that there
-% is no difficulty to localize the package in another language; this comes particularly handy for the
-% Erasmus students on double degree programs.
+% is no difficulty to localize the package in another language; this comes particularly handy
+% for the Erasmus students on double degree programs.
 %
-% As a final remark notice that the commands for typesetting the title page are contained in the package
-% \texttt{topfront.sty}, which can be used as an autonomous extension to the \texttt{report}
-% document class. One could easily typeset just the title page with a separate \TeX\ source file
-% so as to test the completeness of the commands and coherence of the configuration file or
-% for just printing the isolated title page.
+% As a final remark notice that the commands for typesetting the title page are contained
+% in the package \texttt{topfront.sty}, which can be used as an autonomous extension to the
+% \texttt{report} document class. One could easily typeset just the title page with a separate
+% \TeX\ source file so as to test the completeness of the commands and coherence of the
+% configuration file or for just printing the isolated title page.
 %
 % \subsection{Typesetting commands}
 % The bundle and the TOPtesi document class accept all \LaTeX\ commands provided by
 % the \LaTeX\ \texttt{kernel}, the \texttt{report} document class, and the \texttt{graphics}
 % extension package, besides those provided by the \texttt{babel} package.
 %
-% With this respect it must be underlined that the Italian and English languages are specified by
-% default, the Italian one being the default language. An initial specification of
-% |\selectlanguage{english}| sets the English language as default. Should a student typeset the thesis
-% in French, it would be necessary to specify the option \texttt{french} among the class options,
-% and so start the document by specifying |\selectlanguage{french}|. Nevertheless these
-% \texttt{babel} macros select the English or the French typesetting rules, but hyphenation
-% is activated only if the program format file has been generated with the pertinent languages.
+% With this respect it must be underlined that the Italian and English languages are specified
+% by default, the Italian one being the default language. An initial specification of
+% |\selectlanguage{english}| sets the English language as default. Should a student typeset
+% the thesis in French, it would be necessary to specify the option \texttt{french} among the
+% \emph{class} options, and so start the document by specifying |\selectlanguage{french}|.
+% But the user should pay attention to use \texttt{babel} in the proper way:
+% \begin{itemize}
+% \item Due to the way \LaTeX\ classes load the requested files, and to the fact that the
+% \texttt{babel} package has already been loaded by the \texttt{toptesi} class, the user
+% cannot reload it with a different list of language options; therefore the latter language
+% options \emph{must be specified} as global class options; therefore, if the thesis has
+% to be typeset, fore example, in French, is is necessary to do the following:
+%\begin{verbatim}
+%\documentclass[...,french,...]{toptesi}
+%...
+%\begin{document}
+%\selectlanguage{french}
+%\end{verbatim}
+% \item With the 2010 \TeX\ system distributions, both \TeX Live and MiKTeX, all known
+% (to \LaTeX) language hyphenation rules are preloaded; with other less up to date
+% \TeX\ system distributions this might not be true.
+% Remember that \texttt{babel} macros select the language typesetting rules, but hyphenation
+% is activated only if the program format file has been generated with the pertinent
+% language hyphenation rules. You can check this detail by reading the first dozen of lines
+% of your thesis \texttt{.log} file; there is the list of all language hyphenation rules that
+% are available in the format file.
 % While (American) English is the default and almost any distribution of the \TeX\ system
 % has many language defaults, it is more likely that French is preloaded while Italian is not.
-% The user should verify which are the default languages preloaded into the format file; this
-% information is written in the very first lines of any \texttt{.log} file generated by any
-% run of \LaTeX, \texttt{pdflatex} or even plain \TeX.
-%
-% Should the required languages be missing, the user is forced to read the 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!
+%
+% 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.
+% \end{itemize}
 %
 % The TOPtesi bundle adds very little to the user commands; nevertheless the package
-% \texttt{topcomand.sty},
-% that is part of this bundle and is automatically loaded, defines some useful commands for
-% typesetting technical matters in such a way as to fulfill the ISO regulations.
-% Some of these commands are already defined in the \texttt{babel} Italian option, but if your thesis
-% is written in different languages it may happen that such commands are not available any more when
-% another language is selected.
+% \texttt{topcoman.sty}, that is part of this bundle and is automatically loaded, defines
+% some useful commands for typesetting technical matters in such a way as to fulfill the ISO
+% regulations.
+% Some of these commands are already defined with the \texttt{babel} Italian option, but if
+% your thesis is written in different languages it may happen that such commands are not
+% available any more when you select another language; with the presence of the definitions
+% contained in \texttt{topcoman.sty} such useful commands remain available with every
+% language.
 %
 % The following description specifies these particular commands.
 % \begin{description}
 % \def\Item[#1]{\item[\normalfont\texttt{\char92#1}]}
 % \Item[DeclareSlantedCapitalGreekLetters] does exactly what its name
-% means: it changes the definitions of the mathematical capital Geek
+% means: it changes the definitions of the mathematical capital Greek
 % letters so that they are typeset in ``italics''; they are in effects taken from the math
 % italic alphabet, instead of the default roman one.
 % %
@@ -347,7 +442,7 @@ the TOPtesi bundle]
 % available anyhow.
 % %
 % \Item[ohm] typesets an upright capital omega even if the capital Greek
-% letters are in italics; the good point is that |\ohm| can be used also
+% letters are in italics; another good point is that |\ohm| can be used also
 % in text mode.
 % %
 % \Item[ped] inserts a subscript in upright type; the ISO regulations
@@ -394,21 +489,24 @@ the TOPtesi bundle]
 % %
 % \Item[eu] inserts the Euler number symbol ``e'' in upright type; since
 % this entity is not a variable, but it is a mathematical constant, the
-% ISO regulations require it to be written in upright type. The electron
-% charge $e$ is not upright because this physical ``constant'' is not
-% that constant\dots
+% ISO regulations require it to be written in upright type. The ISO regulations require
+% the upright type for ``e'' and any mathematical constant, but
+% the electron charge $e$ is typeset in math italics because this physical
+% ``constant'', not a mathematical one.
 % %
-% \Item[listing] requires for its argument the name of a file and typesets it in verbatim mode;
-% this command is very useful for typesetting the listings of the programs that were written
-% for the thesis; for best results it is recommended that the source program has lines not
-% longer than 80 characters.
+% \Item[listing] requires for its argument the name of a file and typesets it in verbatim
+% mode; this command is very useful for typesetting the listings of the programs that were
+% 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.
 % \end{description}
 %
 % All these commands are defined into the separate package \texttt{topcoman.sty}
-% that can be used as an independent extension package for any document class.
+% that can be used as an independent extension package with (possibly) any document class.
 %
 % \section{Format PDF suitable for archiving}
-% Politecnico di Torino as well as many other Italian and non Italian universities are
+% 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
 % years from now?''
@@ -440,13 +538,13 @@ the TOPtesi bundle]
 % summarized as follows:
 % \begin{itemize}
 % \item The preliminary essential requirement is that the \texttt{pdflatex} used to
-% typeset the thesis be sufficiently recent to support the PDF/A requirements. Have 
-% a 2008, or even better, a 2009 version of the \TeX\ system installed on your PC.
+% typeset the thesis be sufficiently recent to support the PDF/A requirements. It's
+% better to have the most recent distribution of the \TeX\ system installed on your PC.
 % Do not try to typeset the thesis
-% with the `old' \LaTeX; you must process the input thesis file(s) with
+% with the `old' \LaTeX; you \emph{must} process the input thesis file(s) with
 % \texttt{pdflatex}; in the following, no specific check will be made in order
-% to verify if you are actually
-% using \texttt{pdflatex}. If you really need to use the `old' \LaTeX, you get a DVI
+% to verify if you are actually using \texttt{pdflatex}.
+% If you really need to use the `old' \LaTeX, you get a DVI
 % file and you need to transform it with |dvips| into a PS file; at this point you
 % have lost the possibility of exploiting the internal commands of |pdflatex| version
 % 1.40.9 or later. You can still produce a PDF/A final document, but you have to
@@ -455,11 +553,11 @@ the TOPtesi bundle]
 % to PDF/A transformation.
 
 % \item Download from \textsc{ctan} and install the package \textsf{pdfx}, if it is
-% not already part of your \TeX\ system installation. % \item Install in the main
-% \texttt{pdfx} directory a good version of a color model
+% 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}).
-%\item If your thesis main file, the one you run your \texttt{pdflatex} on, is named,
+% \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
@@ -471,19 +569,19 @@ the TOPtesi bundle]
 % \end{verbatim}
 % Keywords require a specific XML style format that can be examined in the package
 % documentation.
-%\item Some mathematical symbol commands obtained from the standard \LaTeX\ set-up
+% \item Some mathematical symbol commands obtained from the standard \LaTeX\ set-up
 % 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 If you include PDF images that contain some text, be sure that the font for
+% \item Use only PNG and JPEG 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
 % all the fonts used in the image. If you don't succeed, open the PDF file with
 % the free program \texttt{inkscape} and save it back in PDF format; the missing fonts
 % will be replaced with their traced outlines and this will not disturb the PDF/A
 % conformity.
-%\item Verify your final PDF file with a suitable program and do not give up doing the
+% \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
 % is the Preflight plug-in of Adobe Acrobat Professional version 8 or later, but this,
@@ -495,10 +593,9 @@ the TOPtesi bundle]
 % 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
-% 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.
+% 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.
 %
 % \StopEventually{} ^^A qui si puo' mettere una bibliografia
 %
@@ -512,7 +609,7 @@ the TOPtesi bundle]
 %<*class>
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesClass{toptesi}%
-[2008/12/15 v.5.00 Class for typesetting university theses]
+[2010/11/14 v.5.01 Class for typesetting university theses]
 %    \end{macrocode}
 %
 % The class itself is very simple since it requires just the \texttt{report}
@@ -550,7 +647,7 @@ the TOPtesi bundle]
 %<*topsty>
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{toptesi}%
-[2008/12/15 v.5.00 Extension for toptesi.cls]%
+[2010/11/14 v.5.01 Extension for toptesi.cls]%
 %    \end{macrocode}
 %
 % We start with defining the debugging macros; these trace commands and macros
@@ -568,6 +665,7 @@ the TOPtesi bundle]
 % 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.
 %    \begin{macrocode}
+\newlength\T@Pbinding\setlength\T@Pbinding{7mm}\def\setbindingcorrection#1{\T@Pbinding=#1}
 \newif\if@binding \@bindingfalse
 \newif\ifT@Ppdfa  \T@Ppdfafalse
 \newif\ifchapterbibliography \chapterbibliographyfalse
@@ -616,7 +714,8 @@ the TOPtesi bundle]
 % text grid is centered; only if the class option \texttt{cucitura} is specified
 % (|\if@binding| in this case is true) the text grids are moved to the outside
 % in order to leave a wider inner margin. At the same time if the text grid is moved to
-% the outside, the marginal note width must be reduced accordingly.
+% the outside, the marginal note width must be reduced accordingly. These changes are
+% executed at the |\begin{document}| stage.
 %    \begin{macrocode}
 \oddsidemargin=\paperwidth
 \advance\oddsidemargin -\textwidth
@@ -627,13 +726,14 @@ the TOPtesi bundle]
 \advance\marginparwidth 1in
 \advance\marginparwidth-2.5\marginparsep
 %
+\AtBeginDocument{%
 \if@binding
  \typeout{Messaggio Toptesi: Ricalcolo i margini}
- \advance\oddsidemargin 7mm
- \advance\evensidemargin -7mm
- \advance\marginparwidth -7mm
- \advance\marginparwidth -7mm
-\fi
+ \advance\oddsidemargin \T@Pbinding
+ \advance\evensidemargin -\T@Pbinding
+ \advance\marginparwidth -\T@Pbinding
+ \advance\marginparwidth -\T@Pbinding
+\fi}
 %    \end{macrocode}
 %
 % We now establish the page style. We start by setting to ``empy'' the tokens that
diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.ins b/Master/texmf-dist/source/latex/toptesi/toptesi.ins
deleted file mode 100644
index da3e4a1a532..00000000000
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.ins
+++ /dev/null
@@ -1,113 +0,0 @@
-%%

-%% This file is necessary to extract from file toptesi.dtx the following files:

-%%      toptesi.cls,

-%%      toptesi.sty,

-%%      topcoman.sty,

-%%      topfront.sty,

-%%      topsiz14.clo,

-%%      trieste.sty,

-%%      toptesi.cfg

-%% that are strictly speaking the components of the TOPtesi bundle and form

-%% the Work. The extraction is performed by means of the doctrip utility

-%% that extracts practically only the uncommented lines so that their loading

-%% becomes very quick. The bundle documentations in Italian is contained

-%% in the document toptesi-doc.pdf (part of the bundle), and further

-%% documentation in English may be obtained by LaTeX processing the

-%% documented TeX source file toptesi.dtx.

-%%

-%% ----------------------------------------

-%%

-%%  This system is distributed in the hope that it will be useful,

-%%  but WITHOUT ANY WARRANTY; without even the implied warranty of

-%%  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

-%%

-%% IMPORTANT NOTICE:

-%%

-%% Copyright 1989--2006 Claudio Beccari

-%% All rights reserved.

-%%

-%% Permission is granted to distribute verbatim copies of this file

-%% together with toptesi.dtx.

-%%

-%% No other permissions to copy or distribute this file in any form

-%% are granted and in particular no permission to modify its contents.

-%%

-%% --------------- start of docstrip commands ------------------

-%%

-\def\batchfile{toptesi.ins}

-\input docstrip.tex

-\preamble

-

-Copyright 1989--2005 Claudio Beccari All rights reserved.

-

- This system is distributed in the hope that it will be useful,

- but WITHOUT ANY WARRANTY; without even the implied warranty of

- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

-

-

-IMPORTANT NOTICE:

-

-This file is subject to the LPPL licence, version 1.3 or any subsequent

-version. Copy of the LaTeX Project Public Licence is downloadable from

-any CTAN archive.

-

-

-\endpreamble

-

-\keepsilent

-

-\Msg{*** Generazione dei file del pacchetto TOPtesi ***}

-

-\generateFile{toptesi.cls}{t}{\from{toptesi.dtx}{class}}

-\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{trieste.sty}{t}{\from{toptesi.dtx}{toptrst}}

-\generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}}

-

-

-

-

-\ifToplevel{%

-\Msg{***********************************************************}

-\Msg{*\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-               \space\space\space\space\space\space\space\space*}

-\Msg{* Now move all files to a folder that is on   \space\space

-    \space\space\space\space\space\space\space\space\space\space

-                                                   \space\space*}

-\Msg{* the LaTeX search path      \space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-         \space\space\space\space\space\space\space\space\space*}

-\Msg{*\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-               \space\space\space\space\space\space\space\space*}

-\Msg{* In order to produce the English documentation run LaTeX *}

-\Msg{* on toptesi.dtx.      \space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-                                       \space\space\space\space*}

-\Msg{*\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-               \space\space\space\space\space\space\space\space*}

-\Msg{*    \space\space\space\space\space\space\space\space\space

-                                        \space\space\space\space

-    Buon lavoro! Happy TeXing!    \space\space\space\space\space

-    \space\space\space\space\space\space\space\space\space\space

-                                                         \space*}

-\Msg{***********************************************************}

-}

-

-\endinput