summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/toptesi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-11-17 00:34:16 +0000
committerKarl Berry <karl@freefriends.org>2010-11-17 00:34:16 +0000
commit73cd5c082800b6704a33df225536f0d8f761c42f (patch)
treed1395b96a064e4632ba8cf2b42d0ed95f70da46f /Master/texmf-dist/source/latex/toptesi
parented6a4bf7b100677d2f500185436d7f3981a7598d (diff)
toptesi (16nov10)
git-svn-id: svn://tug.org/texlive/trunk@20458 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/toptesi')
-rw-r--r--Master/texmf-dist/source/latex/toptesi/toptesi.dtx370
-rw-r--r--Master/texmf-dist/source/latex/toptesi/toptesi.ins113
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