toptesi (26nov16)

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

1 files changed, 73 insertions, 65 deletions

diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
index 60295868a28..c27fbef0194 100644
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
+++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
@@ -27,7 +27,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,
+toptesi.cls, toptesi.sty, topfront.sty, topcoman.sty,
 toptesi.cfg, and the English documentation toptesi.pdf.
  
 Furthermore the bundle contains the documentation source
@@ -107,7 +107,7 @@ lines of the file for how-to information.
 %<topcmn>\ProvidesPackage{topcoman}[%
 %<topfrn>\ProvidesPackage{topfront}[%
 %<*driver,class,topsty,topcmn,topfrn>
-2016/10/10 v.5.9.05 
+2016/11/25 v.5.9.06 
 %<class>Class for typesetting university theses]
 %<topsty>Extension for toptesi.cls]
 %<topcmn>Additional commands for the TOPtesi bundle]
@@ -138,7 +138,7 @@ lines of the file for how-to information.
 %</driver>
 % \fi
 %
-% \CheckSum{2842}
+% \CheckSum{2847}
 %
 % \begin{abstract}
 % This file describes the TOPtesi bundle; it is a set of files designed to
@@ -570,27 +570,29 @@ lines of the file for how-to information.
 % to the proper places.
 % \end{enumerate}
 %
-% The TOPtesi bundle adds very little to the user commands; nevertheless the package
-% \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 fulfil 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 \texttt{polyglossia} package does not
-% produce any useful additional command for writing in a ISO compliant way, therefore
-% the macros contained in the \texttt{topcoman.sty} package come very handy.
+% The TOPtesi bundle adds very little to the user commands; nevertheless the
+% package \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 fulfil 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 \texttt{polyglossia} package does not produce any useful
+% additional command for writing in a ISO compliant way, therefore the macros
+% contained in the \texttt{topcoman.sty} package come very handy.
 %
 % 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 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. This option is useful with \LaTeX,
-% while with \XeLaTeX\ it is unnecessary due to the larger set of math alphabets and math
-% font commands that are available with proper UNICODE math fonts.
+% 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. This option
+% is useful with \LaTeX, while with \XeLaTeX\ it is unnecessary due to the
+% larger set of math alphabets and math font commands that are available
+% with proper UNICODE math fonts.
 % %
 % \Item[ensuremath] should be already defined in the \LaTeX\ kernel;
 % should one still be using an obsolete version, this command gets
@@ -617,24 +619,27 @@ lines of the file for how-to information.
 % measure in upright type; this works both in math and text mode. Of
 % course it is necessary to input the |\unit| command without intervening
 % spaces in the source file; it's necessary to typeset, say,
-% |35\unit{km}| and to avoid writing \verb*+35 \unit{km}+. This command,
+% |35\unit{km}| while avoiding  \verb*+35 \unit{km}+. This command,
 % as it is defined, conflicts with the definition of the homonymous
 % command |\unit| as defined by the \texttt{unitsx} package, but since
 % this latter package is necessarily input in the preamble, while
-% \texttt{topcomand.sty} is read at the execution of |\begin{document}|,
-% the latter file ha provisions to test if |unitsx| has already been loaded,
+% \texttt{topcoman.sty} is read at the execution of |\begin{document}|,
+% the latter file has provisions to test if |unitsx| has already been loaded,
 % so as not to overwrite the latter package definition and to avoid every
-% possible conflict.
+% possible conflict. On the opposite, if the user loads package |siunitx|
+% (the most performant one in the field of units and number handling),
+% the command |\unit| remains available, because it is redefined in terms
+% of this package commands.
 % %
 % \Item[micro] sets the decimal prefix $\mu$ when typesetting units of
 % measure.
 % %
 % \Item[gradi] sets the small circle that defines the sexagesimal degrees, for
-% example $35^\circ$; it may be used also for the celsius degrees by writing in the
-% source file, say, |35\unit{\gradi C}| in order to get
+% example $35^\circ$; it may be used also for the celsius degrees by writing
+% in the source file, say, |35\unit{\gradi C}| in order to get
 % $35\,^\circ\mathrm{C}$; notice the difference with |35\gradi|, that yields
 % $35^\circ$ without any space between the measure and the ``degree'' little
-% circle; this is what the ISO regulations require; The small space inserted
+% circle; this is what the ISO regulations require; the small space inserted
 % by |\unit| is required when the unit of measure symbol contains at least
 % one letter.
 % %
@@ -648,19 +653,19 @@ lines of the file for how-to information.
 % require it is typed with an upright serifed font, just as operators are.
 % %
 % \Item[eu] inserts the Napier number symbol ``e'' in upright type; since
-% this entity is not a variable, but it is a mathematical constant, the ISO
+% this entity is not a variable, but is a mathematical constant, the ISO
 % regulations require it to be written in upright type. The ISO regulations
 % require the upright type for ``e'' and any other mathematical constant, but
-% the electron charge $e$ is typeset in math italics because this is physical
+% the electron charge $e$ is typeset in math italics because this is a physical
 % ``constant'', not a mathematical one. \XeTeX\ allows to typeset upright
 % math Greek letters,  so there is the facility to typeset an upright ``pi''
-% (the number) to be distinguished  from an slanted ''pi'' (the angle).
+% (the number) to be distinguished  from a slanted ''pi'' (the angle).
 % %
-% \Item[goodpagebreak] inserts a conditional page break in after the line
+% \Item[goodpagebreak] inserts a conditional page break  after the line
 % where this command appears; it is not equivalent to the |\raggedbottom|
 % declaration that does not vertically justify any page, but tests the
 % amount of space remaining on the page, and if less than a given number of
-% lines are available inserts a page break; the result is a ragged bottom
+% lines are available, it inserts a page break; the result is a ragged bottom
 % single page, that sometimes is better than loose spacing between paragraphs,
 % or within items of a list, or before or after displayed material. It is
 % handy also to use before starting a new section, because at least four
@@ -680,15 +685,15 @@ lines of the file for how-to information.
 % that might be used as an independent extension package with any document class.
 %
 % \section{PDF/A archivable format}
-% This section in general applies also if the thesis is typeset by means
-% of \XeLaTeX, but in this case  special attention should be given to the
-% details of the procedure as described in the documentation of the
+% This section in general applies also if the thesis is typeset by means of
+% \XeLaTeX\ or \LuaLaTeX, but in this case  special attention should be given
+% to the details of the procedure as described in the documentation of the
 % \pack{pdfx} package. Even better, \LuaLaTeX, whose source file is
 % practically the same as that of \XeLaTeX, may produce in a simpler way
 % a PDF/A compliant output file if the users follow attentively the
 % instructions contained in the documentation of the \pack{pdfx} package.
 %
-% More details are given in the Italian documentation contained in files
+% More details are given in the Italian documentation contained in file
 % \texttt{toptesi\discretionary{-}{}{-}it-pdftex}.
 %
 % Politecnico di Torino as well as many other Italian and foreign universities
@@ -738,22 +743,15 @@ lines of the file for how-to information.
 %   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 transform it by means of
-%   |ghostscript|; read the |ghostscript| (version 9.16 or later) documentation
-%   file |ps2pdf.html| in order to find out how to produce the correct
-%   PS-to-PDF/A transformation. The documentation in
-%   Italian describes several more or less effective methods to transform
+%   the procedures described in the Italian documentation; such documenttion
+%   describes several more or less effective methods to transform
 %   a non compliant PDF/A file into a compliant one, and how to correct the
-% ``imperfections'' that forbid any valid transformation.
-%
-% \item As said before, \prog{lualatex} used to be partially compatible
-%   with package \pack{pdfx}, because in spite of having a typesetting
-%   engine that has a strong resemblance with \prog{pdftex} it did not
-%   contain all its primitives; therefore it was necessary to load other
-%   packages e create some little patches. Since 2016 the TeXLive
-%   distribution contains a new version of \pack{pdfx} and now PDF documents
-%   produced with \prog{lualatex} may be fully compatible with the standard
-%   PDF/A. With some special care, even \prog{xelatex} can now produce PDF/A
-%   compliant output files.
+%   ``imperfections'' that forbid any valid transformation.
+%
+% \item Since 2016 the TeXLive distribution contains a new version of
+%   \pack{pdfx} and now PDF documents produced with \prog{lualatex} may be
+%   fully compatible with the standard PDF/A. With some special care, even
+%   \prog{xelatex} can now produce PDF/A compliant output files.
 %
 % \item Your up-to-date complete \TeX\ distribution should contain the package
 %   \textsf{pdfx}; if it does not, upgrade your \TeX\ system complete
@@ -804,6 +802,11 @@ lines of the file for how-to information.
 %   Pro~XI, but this, although the most authoritative, is a commercial program;
 %   probably your university has special facilities for this task.
 %
+% \item There exist an experimental freeware program \prog{veraPDF} that
+%   can be downloaded from the Web, that performs quite well in checking
+%   the PDF/A conformity of a PDF file; read more in the \pack{TOPtesi}
+%   Italian documentation.
+%
 %\end{enumerate}
 %
 % Warning: if you are using Adobe Reader X (or later), this program will open
@@ -817,7 +820,7 @@ lines of the file for how-to information.
 % problems that are of great concern for the large Institutions that have
 % thousands of documents a year to archive; it is not a question implied
 % in the free nature of the \prog{pdflatex}, \prog{xelatex}, and \prog{lualatex}
-% programs, that, on the opposite, according to my experience have a very high
+% programs, that, on the opposite, according to my experience, have a very high
 % rate of success in producing PDF/A compliant documents.  If you stick to the
 % default \TeX\ system Type~1, 256-glyph fonts, or to the UNICODE encoded otf
 % or ttf fonts and use this version of \texttt{TOPtesi} you should be able
@@ -1650,7 +1653,7 @@ Skipping any redefinition\MessageBreak}%
 % has shown that loading these packages does not need to be deferred al the
 % ``begin document'' level with pdf\/\LaTeX, it does not hurt to delay their
 % loading operation with both engines. This delayed loading implies that the
-% commands defined in |topfront| and in |topcomand| cannot be used in the
+% commands defined in |topfront| and in |topcoman| cannot be used in the
 % preamble.
 %    \begin{macrocode}
 \AtBeginDocument{%
@@ -3079,12 +3082,14 @@ Skipping any redefinition\MessageBreak}%
 %<*topcmn>
 % \fi
 %
-% The new command |\DeclareSlantedCapitalGreekLetters| optionally sets the capital
-% Greek letters in math mode with the glyphs taken from the math italic fonts, not from
-% the math roman fonts, as it is by default; some authors prefer to use both symbols
-% with different meanings, so this command lets them do so. This may be useful unless
-% the XeTeX typesetting engine is used; in facts the Unicode math defines specific
-% commands for setting any Latin or Greek mathematical letter in any possible font shape and series.
+% The new command |\DeclareSlantedCapitalGreekLetters| optionally sets the
+% capital Greek letters in math mode with the glyphs taken from the math
+% italic fonts, not from the math roman fonts, as it is by default; some
+% authors prefer to use both symbols with different meanings, so this
+% command lets them do so. This may be useful unless the XeTeX or LuaTeX
+% typesetting% engine is used; in facts the Unicode math defines specific
+% commands for setting any Latin or Greek mathematical letter in any possible
+% font shape and series.
 %    \begin{macrocode}
 \RequirePackage{iftex}
 \ifPDFTeX
@@ -3102,12 +3107,14 @@ Skipping any redefinition\MessageBreak}%
    \mathchardef\Omega="710A
 }\fi
 %    \end{macrocode}
-% The |\ensuremath| command is defined in the \LaTeXe\ kernel from a certain version on;
-% should the user employ a really old \LaTeXe\ implementation, this definition
-% supplies the missing one. Should the |babel| package not be loaded, then we provide the
-% useful command |\textormath| provided by |babel|. We define the text version of the
-% subscript and  ensure also that the |textcomp| package is loaded; of course if it is
-% already loaded the |\RequirePackage| command performs the necessary tests and possibly
+%
+% The |\ensuremath| command is defined in the \LaTeXe\ kernel from a certain
+% version on; should the user employ a really old \LaTeXe\ implementation,
+% this definition supplies the missing one. Should the |babel| package not
+% be loaded, then we provide the useful command |\textormath| provided by
+% |babel|. We define the text version of the subscript and  ensure also
+% that the |textcomp| package is loaded; of course if it is already loaded
+% the |\RequirePackage| command performs the necessary tests and possibly
 % does not load anything. 
 %    \begin{macrocode}
 \providecommand*\ensuremath[1]{\ifmmode#1\else$#1$\fi}%
@@ -3132,7 +3139,8 @@ Skipping any redefinition\MessageBreak}%
 \providecommand{\ohm}{\textormath{\textohm}{\mathrm{\Omega}}}
 \providecommand{\ped}[1]{\textormath{\textsubscript{#1}}{_{\mathrm{#1}}}}
 \providecommand{\ap}[1]{\textormath{\textsuperscript{#1}}{^{\mathrm{#1}}}}
-\providecommand{\unit}[1]{\ensuremath{{\mathrm{\,#1}}}}
+\@ifpackageloaded{siunitx}{\def\unit#1{\si{\,#1}}}{%
+\providecommand\unit[1]{\ensuremath{{\mathrm{\,#1}}}}}
 \providecommand{\gei}{\ensuremath{{\mathop{\mathrm{j}}\nolimits}}}
 \providecommand{\eu}{\ensuremath{{\mathop{\mathrm{e}}\nolimits}}}
 \providecommand{\micro}{\textormath{\textmu}{%