summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-06-24 23:34:59 +0000
committerKarl Berry <karl@freefriends.org>2010-06-24 23:34:59 +0000
commitf794e99605085b9f6cef922ba918d6f87cbb76f3 (patch)
tree1b9688a8fd5774f56f4c9377f6455bacfe6fd46a
parenta239d22e4544943d4b7122d89a80e3ec80b97291 (diff)
frontespizio 1.2 (24jun10)
git-svn-id: svn://tug.org/texlive/trunk@19139 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/README47
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex17
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/examplea.tex3
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex20
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/exampleb.tex5
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex23
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/examplec.tex12
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex21
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/exampled.tex43
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdfbin272944 -> 397940 bytes
-rw-r--r--Master/texmf-dist/doc/latex/frontespizio/makedoc.sh3
-rw-r--r--Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx704
-rw-r--r--Master/texmf-dist/source/latex/frontespizio/frontespizio.ins18
-rw-r--r--Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty142
-rwxr-xr-xMaster/tlpkg/libexec/ctan2tds1
15 files changed, 728 insertions, 331 deletions
diff --git a/Master/texmf-dist/doc/latex/frontespizio/README b/Master/texmf-dist/doc/latex/frontespizio/README
index d3120e65029..c241e4441b6 100644
--- a/Master/texmf-dist/doc/latex/frontespizio/README
+++ b/Master/texmf-dist/doc/latex/frontespizio/README
@@ -2,16 +2,32 @@ The frontespizio package lets you typeset a frontispiece (suitable for
Italian university style) independently of the page layout of the main
document.
-This is version 1.1 of the package; the only change from version 1.0 is
-the addition of the option `swapnames', to exchange the position of
-candidate and advisor names. A bug with option `onlyinclude' has been
-corrected.
-
- Copyright 2008, 2009 Enrico Gregorio
-
- This program is provided under the terms of the
- LaTeX Project Public License distributed from CTAN
- archives in directory macros/latex/base/lppl.txt.
+This is version 1.2 of the package.
+
+Changes from version 1.1:
+o A "Preambolo*" environment to collect things that had to be argument
+ of several \Preambolo commands
+o Option "nouppercase" to avoid uppercasing the second line
+o The package honors the inputenc option in the main document also
+ in the "frn" file
+o Implementation modifications (use atbegshi instead of eso-pic and
+ others)
+o Documentation update
+
+Changes from version 1.0:
+o Added the option `swapnames', to exchange the position of
+ candidate and advisor names
+o Correction of a bug with option `onlyinclude'
+
+ Copyright 2008-2010 Enrico Gregorio
+
+ This work may be distributed and/or modified under the
+ conditions of the LaTeX Project Public License, either version 1.3
+ of this license or (at your option) any later version.
+ The latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+ and version 1.3 or later is part of all distributions of LaTeX
+ version 2005/12/01 or later.
Author: Enrico Gregorio
Enrico dot Gregorio at univr dot it
@@ -31,14 +47,15 @@ frontespizio.sty
examplea.tex
exampleb.tex
examplec.tex
+exampled.tex
makedoc.sh
To install the distribution:
o run "latex frontespizio.ins"
-o run "{|pdf|xe}latex example{a,b,c}.tex" for a test
-o run "{|pdf|xe}latex example{a,b,c}-frn.tex" for a test
-o run "{|pdf|xe}latex example{a,b,c}.tex" for a test
+o run "{|pdf|xe}latex example{a,b,c,d}.tex" for a test
+o run "{|pdf|xe}latex example{a,b,c,d}-frn.tex" for a test
+o run "{|pdf|xe}latex example{a,b,c,d}.tex" for a test
o after the tests, you should have correct dvi or pdf
example files (choose either latex, pdflatex or xelatex
and compile each of the three examples)
@@ -53,6 +70,8 @@ $ pdflatex examplea-frn.tex
$ pdflatex exampleb.tex
$ pdflatex exampleb-frn.tex
$ pdflatex examplec.tex
+$ pdflatex exampled-frn.tex
+$ pdflatex exampled.tex
$ pdflatex examplec-frn.tex
$ pdflatex frontespizio.dtx
$ pdflatex frontespizio-frn.dtx
@@ -68,5 +87,5 @@ the automated script makedoc.sh by
sh makedoc.sh
-2009/04/03
+2010/06/25
Enrico Gregorio
diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex
new file mode 100644
index 00000000000..80b788db61d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex
@@ -0,0 +1,17 @@
+\documentclass [titlepage]{article}
+\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}
+\usepackage {graphicx}
+\usepackage[nowrite,infront]{frontespizio}
+\nofiles
+\fontoptionnormal
+\Universita {Padova}
+\Facolta {Scienze Matematiche, Fisiche e Naturali}
+\Corso [Laurea]{Matematica}
+\Titoletto {Tesi di laurea}
+\Titolo {Equivalenze fra categorie di moduli\\ e applicazioni}
+\Candidato [145822]{Enrico Gregorio}
+\Relatore {Ch.mo Prof.~Adalberto Orsatti}
+\Annoaccademico {19??-19??}
+\begin {document}
+\preparefrontpage
+\end {document}
diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplea.tex b/Master/texmf-dist/doc/latex/frontespizio/examplea.tex
index f918909683e..d5e8b310867 100644
--- a/Master/texmf-dist/doc/latex/frontespizio/examplea.tex
+++ b/Master/texmf-dist/doc/latex/frontespizio/examplea.tex
@@ -6,7 +6,7 @@
%%
%% frontespizio.dtx (with options: `examplea')
%%
-%% Copyright 2008 Enrico Gregorio
+%% Copyright 2008-2010 Enrico Gregorio
%%
%% This program is provided under the terms of the
%% LaTeX Project Public License distributed from CTAN
@@ -17,6 +17,7 @@
%%
%% This work has the LPPL maintenance status "author-maintained".
%%
+
\documentclass[a4paper,titlepage]{book}
\usepackage{frontespizio}
diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex
new file mode 100644
index 00000000000..895c52239e7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex
@@ -0,0 +1,20 @@
+\documentclass [titlepage]{article}
+\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}
+\usepackage {graphicx}
+\usepackage[nowrite,infront,nouppercase]{frontespizio}
+\nofiles
+\fontoptionsans
+\Universita {Padova}
+\Facolta {Scienze Matematiche, Fisiche e Naturali}
+\Corso [Laurea]{Matematica}
+\Titoletto {Tesi di laurea}
+\Titolo {Equivalenze fra categorie di moduli\\ e applicazioni}
+\Candidato {Enrico Gregorio}
+\Relatore {Ch.mo Prof.~Adalberto Orsatti}
+\Annoaccademico {19??-19??}
+\Rientro {1.5cm}
+\NCandidato {Laureando}
+\Punteggiatura {}
+\begin {document}
+\preparefrontpage
+\end {document}
diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex b/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex
index 0be7d09c3fb..19c53a70966 100644
--- a/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex
+++ b/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex
@@ -6,7 +6,7 @@
%%
%% frontespizio.dtx (with options: `exampleb')
%%
-%% Copyright 2008 Enrico Gregorio
+%% Copyright 2008-2010 Enrico Gregorio
%%
%% This program is provided under the terms of the
%% LaTeX Project Public License distributed from CTAN
@@ -17,8 +17,9 @@
%%
%% This work has the LPPL maintenance status "author-maintained".
%%
+
\documentclass[a4paper,titlepage]{book}
-\usepackage[sans]{frontespizio}
+\usepackage[sans,nouppercase]{frontespizio}
\begin{document}
\begin{frontespizio}
diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex
new file mode 100644
index 00000000000..195c78f8586
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex
@@ -0,0 +1,23 @@
+\documentclass [titlepage]{article}
+\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}
+\usepackage {graphicx}
+\usepackage[nowrite,infront,swapnames]{frontespizio}
+\nofiles
+\fontoptionnormal
+
+\usepackage {fourier}
+\newcommand {\compring }{anelli compatti}
+
+\Universita {Bologna}
+\Dipartimento {Matematica}
+\Corso [Dottorato di Ricerca]{Matematica}
+\Titolo {Equivalenza di Morita generalizzata\\ e applicazioni alla teoria degli\\ \compring }
+\Candidato {Enrico Gregorio}
+\Relatore {Ch.mo Prof.~Ermanno Lanconelli}
+\NRelatore {Coordinatore}{}
+\Correlatore {Ch.mo Prof.~Adalberto Orsatti}
+\NCorrelatore {Supervisore della ricerca}{}
+\Annoaccademico {19??-19??}
+\begin {document}
+\preparefrontpage
+\end {document}
diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplec.tex b/Master/texmf-dist/doc/latex/frontespizio/examplec.tex
index 81bdb5b4a1e..ca35d1a9893 100644
--- a/Master/texmf-dist/doc/latex/frontespizio/examplec.tex
+++ b/Master/texmf-dist/doc/latex/frontespizio/examplec.tex
@@ -6,7 +6,7 @@
%%
%% frontespizio.dtx (with options: `examplec')
%%
-%% Copyright 2008 Enrico Gregorio
+%% Copyright 2008-2010 Enrico Gregorio
%%
%% This program is provided under the terms of the
%% LaTeX Project Public License distributed from CTAN
@@ -17,18 +17,22 @@
%%
%% This work has the LPPL maintenance status "author-maintained".
%%
+
\documentclass[a4paper,titlepage]{book}
\usepackage[swapnames]{frontespizio}
\begin{document}
\begin{frontespizio}
-\Preambolo{\usepackage{fourier}}
+\begin{Preambolo*}
+ \usepackage{fourier}
+ \newcommand{\compring}{anelli compatti}
+\end{Preambolo*}
\Universita{Bologna}
\Dipartimento{Matematica}
\Corso[Dottorato di Ricerca]{Matematica}
\Titolo{Equivalenza di Morita generalizzata\\
-e applicazioni alla teoria degli\\
-anelli compatti}
+ e applicazioni alla teoria degli\\
+ \compring}
\Candidato{Enrico Gregorio}
\Relatore{Ch.mo Prof.~Ermanno Lanconelli}
\NRelatore{Coordinatore}{}
diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex
new file mode 100644
index 00000000000..9550d1c044c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex
@@ -0,0 +1,21 @@
+\documentclass [titlepage]{article}
+\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}
+\usepackage {graphicx}
+\usepackage[nowrite,infront,nouppercase]{frontespizio}
+\nofiles
+\fontoptionnormal
+\Istituzione {University of St.\ Anford}
+\Divisione {Department of typography}
+\Scuola {Ph.D. degree in \TeX {} and \LaTeX {}}
+\Titolo {How to prepare a\\ formal frontispiece}
+\Sottotitolo {Theory and practice}
+\NCandidato {Candidate}
+\Candidato {Enrico Gregorio}
+\NRelatore {Thesis advisor}{}
+\Relatore {Prof. R. J. Drofnats}
+\NCorrelatore {Research supervisor}{}
+\Correlatore {X. Treemunch}
+\Piede {Thesis submitted in 2010}
+\begin {document}
+\preparefrontpage
+\end {document}
diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampled.tex b/Master/texmf-dist/doc/latex/frontespizio/exampled.tex
new file mode 100644
index 00000000000..b53fdb87dba
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/frontespizio/exampled.tex
@@ -0,0 +1,43 @@
+%%
+%% This is file `exampled.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% frontespizio.dtx (with options: `exampled')
+%%
+%% Copyright 2008-2010 Enrico Gregorio
+%%
+%% This program is provided under the terms of the
+%% LaTeX Project Public License distributed from CTAN
+%% archives in directory macros/latex/base/lppl.txt.
+%%
+%% Author: Enrico Gregorio
+%% Enrico dot Gregorio at univr dot it
+%%
+%% This work has the LPPL maintenance status "author-maintained".
+%%
+
+\documentclass[a4paper,titlepage]{book}
+\usepackage[nouppercase]{frontespizio}
+
+\begin{document}
+\begin{frontespizio}
+\Istituzione{University of St.\ Anford}
+\Divisione{Department of typography}
+\Scuola{Ph.D. degree in \TeX{} and \LaTeX{}}
+\Titolo{How to prepare a\\
+ formal frontispiece}
+\Sottotitolo{Theory and practice}
+\NCandidato{Candidate}
+\Candidato{Enrico Gregorio}
+\NRelatore{Thesis advisor}{}
+\Relatore{Prof. R. J. Drofnats}
+\NCorrelatore{Research supervisor}{}
+\Correlatore{X. Treemunch}
+\Piede{Thesis submitted in 2010}
+\end{frontespizio}
+\end{document}
+\endinput
+%%
+%% End of file `exampled.tex'.
diff --git a/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf b/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf
index b4d977e4a38..14cf8055b70 100644
--- a/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf
+++ b/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh b/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh
index 0c59680731f..6a4a613435c 100644
--- a/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh
+++ b/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh
@@ -1,3 +1,4 @@
+
#!/bin/sh
pdflatex examplea.tex
pdflatex examplea-frn.tex
@@ -5,6 +6,8 @@ pdflatex exampleb.tex
pdflatex exampleb-frn.tex
pdflatex examplec.tex
pdflatex examplec-frn.tex
+pdflatex exampled.tex
+pdflatex exampled-frn.tex
pdflatex frontespizio.dtx
pdflatex frontespizio-frn.tex
makeindex -s gind frontespizio
diff --git a/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx b/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx
index 617f19c097a..cd02a96ad66 100644
--- a/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx
+++ b/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx
@@ -4,15 +4,15 @@
% <Enrico dot Gregorio at univr dot it>
% -------------------------------------------------------
%
-% This file may be distributed and/or modified under the conditions of
-% the LaTeX Project Public License, either version 1.2 of this license
-% or (at your option) any later version. The latest version of this
-% license is in:
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
%
-% http://www.latex-project.org/lppl.txt
-%
-% and version 1.2 or later is part of all distributions of LaTeX
-% version 1999/12/01 or later.
+% This work consists of all files listed in README
%
% \fi
%
@@ -20,10 +20,10 @@
%<*driver>
\ProvidesFile{frontespizio.dtx}
%</driver>
-%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
+%<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01]
%<package>\ProvidesPackage{frontespizio}
%<*package>
- [2009/04/03 1.1 (Enrico Gregorio)]
+ [2010/06/25 1.2 (Enrico Gregorio)]
%</package>
%<*driver>
\PassOptionsToClass{a4paper}{article} % we need a4paper
@@ -32,13 +32,12 @@
\usepackage{graphicx,array,booktabs}
\usepackage{frontespizio}
-\newcommand{\pack}{\textsf}
+\newcommand{\pack}[1]{\mbox{\sffamily#1}}
\newcommand{\env}{\texttt}
\newcommand{\file}{\texttt}
-\newcommand{\cmdname}[1]{\texttt{\char`\\#1}}
\newcommand{\opt}[1]{``\texttt{#1}''}
\newcommand{\frontcommand}[3][f]{%
- \subsection*{\cmdname{#2}#3%
+ \subsection*{\cs{#2}#3%
\ifx#1o%
~(*)%
\else
@@ -46,14 +45,18 @@
~(\textdagger)%
\fi\fi}%
}
-\newcommand{\0}[1]{\ttchar[\meta{#1}\ttchar]}
-\newcommand{\1}[1]{\ttchar\{\meta{#1}\ttchar\}}
-\renewcommand{\meta}[1]{$\langle$\textit{\mdseries #1}$\rangle$}
-\newcommand{\ttchar}[1]{{\ttfamily\char`#1}}
+\newcommand{\frontenvironment}[2]{%
+ \subsection*{\cs{begin}\ttchar\{\texttt{#1}\ttchar\}\\
+ #2\\
+ \cs{end}\ttchar\{\texttt{#1}\ttchar\}}}
+\makeatletter
+\def\meta@font@select{\normalfont\itshape} % I dislike tt italic
+\makeatother
+\newcommand{\ttchar}[1]{{\normalfont\ttfamily\char`#1}}
\newcommand{\frontoption}[1]{\subsection*{\texttt{#1}}}
\newcommand{\includeex}[1]{\par\vfill\begin{center}
\setlength{\fboxsep}{0pt}\fbox{\includegraphics[scale=.3]{#1}}
-\end{center}}
+ \end{center}}
\DeclareRobustCommand\Xe{%
\leavevmode X\lower0.5ex
@@ -68,7 +71,7 @@
%</driver>
% \fi
%
-% \CheckSum{972}
+% \CheckSum{1051}
%
% \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
@@ -108,14 +111,16 @@
% \DoNotIndex{\the,\thispagestyle,\unexpanded,\unless,\unskip,\upshape}
% \DoNotIndex{\usepackage,\vbox,\vfill,\vspace,\write,\z@}
% \DoNotIndex{\CurrentOption,\AtEndDocument,\@ne,\c@page,\m@ne}
+% \DoNotIndex{\@firstofone,\@gobble,\@makeother,\begingroup,\endgroup}
+% \DoNotIndex{\eTeXversion,\hbox,\hsize,\includegraphics,\newlinechar}
+% \DoNotIndex{\titlepage,\vss,\vtop,\xdef}
%
% \begin{frontespizio}
% \Universita{Pietrascambio}
% \Facolta{Scienze Matematiche, Fisiche e Naturali}
% \Corso[Laurea]{Tipografia elettronica}
% \Titoletto{Tesi di perfezionamento}
-% \Titolo{Come comporre un frontespizio\\
-% e vivere felici}
+% \Titolo{Come comporre un frontespizio\\e vivere felici}
% \Rientro{2cm}
% \NCandidato{Autore}
% \Candidato{Enrico Gregorio}
@@ -126,8 +131,8 @@
%
%
% \title{Il pacchetto \textsf{frontespizio}\thanks{Questa
-% documentazione corrisponde alla versione~\fileversion{}
-% del~\filedate}}
+% documentazione corrisponde alla versione~\fileversion{}
+% del~\filedate}}
% \author{Enrico Gregorio \\
% \texttt{Enrico dot Gregorio at univr dot it}}
% \date{\filedate}
@@ -138,7 +143,9 @@
%
% This package is meant for Italian users who want to print a
% frontispiece to their thesis, be it for graduation or for their
-% Ph.D\@.
+% Ph.D\@.; actually the package can be tweaked also for other
+% purposes, provided the overall structure of the desired frontispiece
+% is compatible with the standard one.
%
% It's usually difficult to get a first page which has very different
% layout than the internal pages; use of the \pack{chngpage} package
@@ -168,13 +175,13 @@
% dalla classe o modificato dall'utente con \pack{geometry}.
%
% Come si vede, il frontespizio di questo documento \`e del tutto
-% indipendente dai parametri di impaginazione successivi. Ovviamente il
-% nome dell'universit\`a e quello del relatore sono di fantasia. O no?
+% indipendente dai parametri di impaginazione successivi. Ovviamente
+% il nome dell'universit\`a e quello del relatore sono di fantasia. O
+% no?
%
% Una prima soluzione che impiegava il pacchetto \pack{chngpage} aveva
-% vari difetti, pur se funzionava con le classi standard.
-%
-% Questo nuovo pacchetto cerca di risolvere la questione producendo un
+% vari difetti, pur se funzionava con le classi standard. Questo
+% nuovo pacchetto cerca di risolvere la questione producendo un
% documento separato che va compilato a parte e che verr\`a poi
% incluso direttamente nel documento principale senza altri
% interventi. Il vantaggio di usare questo pacchetto \`e che i
@@ -219,7 +226,12 @@ latex tesi
%
% \`E possibile usare il pacchetto anche per includere un frontespizio
% creato con altri sistemi, si veda pi\`u avanti la descrizione
-% dell'opzione \opt{onlyinclude}
+% dell'opzione \opt{onlyinclude}.
+%
+% Sono a conoscenza del fatto che il pacchetto è stato usato per
+% comporre frontespizi anche di documenti diversi da tesi e
+% simili. Naturalmente qui si tratta di frontespizi `formali', senza
+% alcuna pretesa di essere artistici.
%
% \section{Uso}
%
@@ -243,9 +255,9 @@ latex tesi
% prima compone il frontespizio in caratteri senza grazie, la seconda
% serve a evitare la scrittura o riscrittura del documento \file{frn},
% ovviamente solo quando esso \`e definitivo o quando non ci interessa
-% produrlo.
+% riscriverlo ogni volta che compiliamo.
%
-% Vediamo un tipico frontespizio. Dopo \verb|\begin{document}| vanno
+% Vediamo un tipico frontespizio. Dopo |\begin{document}| vanno
% dati i comandi seguenti:
% \iffalse
%<*verb>
@@ -261,7 +273,7 @@ latex tesi
\Titolo{La mia tesi:\\ una lunga serie di risultati\\
difficilissimi e complicatissimi}
\Sottotitolo{Alcune considerazioni mutevoli}
-\Candidato[PP999999]{Paperino Paolino}
+\Candidato[PP999999]{Paperon de' Paperoni}
\Relatore{Giovanni Episcopo}
\Relatore{Pippo Cluvio}
\Correlatore{Ugo Frogio}
@@ -273,8 +285,8 @@ latex tesi
% \fi
%
% Si possono dare quanti relatori e correlatori si vuole; basta
-% scriverli uno dopo l'altro come argomenti di comandi \verb|\Relatore|
-% o \verb|\Correlatore|.\footnote{Aggiungere i titoli onorifici o
+% scriverli uno dopo l'altro come argomenti di comandi \cs{Relatore}
+% o \cs{Correlatore}.\footnote{Aggiungere i titoli onorifici o
% professionali, mi raccomando! Altrimenti i chiarissimi professori
% potrebbero offendersi.~\texttt{:-)}} Il correlatore \`e colui che
% collabora alla direzione del lavoro di tesi, non quello che fa le
@@ -286,11 +298,12 @@ latex tesi
% \opt{noadvisor} al pacchetto.
%
% Descriveremo pi\`u avanti, in dettaglio, i vari comandi disponibili.
-% Notiamo subito che l'ordine in cui sono dati \`e irrilevante.
+% Notiamo subito che l'ordine in cui sono dati all'interno dell'ambiente
+% |frontespizio| \`e irrilevante.
%
% Con l'opzione \opt{onlyinclude}, nessuno dei comandi descritti pi\`u
% avanti \`e disponibile. Si pu\`o usare solo il comando
-% \cmdname{includefront} che prende come argomento il nome del documento
+% \cs{includefront} che prende come argomento il nome del documento
% che contiene il frontespizio. Questo deve essere in formato
% \textsc{iso}~A4. Il comando ha anche un argomento opzionale per
% rimettere in ordine i numeri di pagina, che deve essere un numero
@@ -306,17 +319,23 @@ latex tesi
% che normalmente vengono disegnati fra il nome dell'ateneo e quello
% della facolt\`a e sopra l'indicazione dell'anno accademico.
%
-% Ultima opzione, in ordine di tempo (novit\`a della versione 1.1), \`e
-% \opt{swapnames} con la quale viene scambiata la posizione dei nomi
-% di relatori e candidato; la posizione normale è con il nome del
+% Con l'opzione \opt{swapnames} viene scambiata la posizione dei nomi
+% di relatori e candidato; la posizione normale \`e con il nome del
% candidato a sinistra e quello del relatore a destra.
+%
+% Novit\`a della versione 1.2 sono le opzioni \opt{nouppercase} e
+% \opt{noinputenc}; la prima serve per non trasformare in maiuscolo il
+% nome della facolt\`a, la seconda per uno scopo un po' recondito che
+% vedremo pi\`u avanti, legato al fatto che ora il pacchetto rispetta
+% la codifica di input del documento principale anche nel
+% documento~\file{frn}.
%
%
% \section{Le opzioni}
%
-% Raccolgo qui le opzioni gi\`a descritte, per un pi\`u facile riferimento.
-% Quando due opzioni sono separate da~`$\mid$', la prima \`e quella
-% valida normalmente.
+% Raccolgo qui le opzioni gi\`a descritte, per un pi\`u facile
+% riferimento. Quando due opzioni sono separate da~`$\mid$', la prima
+% \`e quella valida normalmente.
%
% \frontoption{write${}\mid{}$nowrite}%
% Mutuamente esclusive. Con la seconda si inibisce la scrittura del
@@ -352,18 +371,30 @@ latex tesi
% Non vengono inseriti filetti nel frontespizio; senza questa opzione
% un filetto separa il nome dell'ateneo da quello della facolt\`a e un
% altro viene disegnato sopra l'indicazione dell'anno accademico.
+%
+% \frontoption{nouppercase}%
+% Senza questa opzione il nome della facolt\`a di riferimento \`e in
+% tutto maiuscolo; specificandola, verr\`a rispettato il maiuscolo e
+% il minuscolo come indicato nel documento.
+%
+% \frontoption{noinputenc}%
+% Il pacchetto ora trascrive automaticamente la chiamata al pacchetto
+% \pack{inputenc} del documento principale, se c'\`e, con la stessa
+% opzione. In casi estremi pu\`o essere necessario evitarlo per
+% specificare direttamente, con il comando \cs{Preambolo} o
+% l'ambiente \env{Preambolo*}, la chiamata a \pack{inputenc}
%
% \frontoption{onlyinclude}%
-% Definisce il comando \cmdname{includefront} e disabilita l'ambiente
+% Definisce il comando \cs{includefront} e disabilita l'ambiente
% \env{frontespizio}. Serve per includere un frontespizio preparato con
% altri metodi; deve essere un file grafico che sia fra quelli
-% gestibili con \cmdname{includegraphics} e deve avere formato
+% gestibili con \cs{includegraphics} e deve avere formato
% \textsc{iso}~A4.
%
% \frontoption{driver=$\langle\mathit{driver}\rangle$}%
% Imposta la chiamata di \pack{graphicx} nel documento~\file{frn} per
% l'uso di un driver diverso da \texttt{dvips} o \texttt{pdftex}, per
-% esempio \verb|driver=dvipdfm| oppure \verb|driver=textures|.
+% esempio |driver=dvipdfm| oppure |driver=textures|.
%
% \bigskip
%
@@ -373,7 +404,7 @@ latex tesi
%<*verb>
% \fi
\begin{verbatim}
-! Use of \front@temp doesn't match its definition.
+! Package frontespizio Error: Key <?> undefined.
\end{verbatim}
% \iffalse
%</verb>
@@ -392,7 +423,7 @@ latex tesi
% spada~(\textdagger) quelli sostitutivi, cio\`e le varianti di cui si
% diceva, senza niente quelli facoltativi.
%
-% \frontcommand[o]{Universita}{\1{nome breve}}
+% \frontcommand[o]{Universita}{\marg{nome breve}}
% L'istituzione in cui si discute la tesi, cio\`e quella che rilascia il
% titolo di studio; va dato il nome abbreviato:
% \iffalse
@@ -400,14 +431,14 @@ latex tesi
% \fi
\begin{verbatim}
\Universita{Verona}
-\Universita{Roma `La Sapienza'}
+\Universita{Napoli `Federico II'}
\end{verbatim}
% \iffalse
%</verb>
% \fi
% Il comando aggiunge da s\'e ``Universit\`a degli Studi di''.
%
-% \frontcommand[s]{Istituzione}{\1{nome completo}}
+% \frontcommand[s]{Istituzione}{\marg{nome completo}}
% Quando l'istituzione ha un nome particolare, occorre specificarlo per
% intero con questo comando:
% \iffalse
@@ -416,12 +447,13 @@ latex tesi
\begin{verbatim}
\Istituzione{Politecnico di Torino}
\Istituzione{Universit\`a `Bocconi' di Milano}
+\Istituzione{Sapienza -- Universit\`a di Roma}
\end{verbatim}
% \iffalse
%</verb>
% \fi
%
-% \frontcommand{Logo}{\0{dimen}\1{file}}
+% \frontcommand{Logo}{\oarg{dimen}\marg{file}}
% L'argomento di questo comando \`e il nome (senza estensione) di un
% documento grafico che contenga il simbolo dell'istituzione. Ha un
% argomento opzionale, la dimensione in altezza del logo (normalmente
@@ -436,7 +468,7 @@ latex tesi
%</verb>
% \fi
%
-% \frontcommand{Filigrana}{\0{parametri}\1{file}}
+% \frontcommand{Filigrana}{\oarg{parametri}\marg{file}}
% L'argomento \`e il nome (senza estensione) di un documento che contenga
% il simbolo dell'istituzione, con opportuna retinatura in modo che
% appaia come in filigrana. Ha un argomento opzionale, che permette di
@@ -453,17 +485,19 @@ latex tesi
% Con la chiave \texttt{height} si imposta l'altezza del simbolo, con le
% chiavi \texttt{before} e \texttt{after} si imposta la proporzione in
% cui \`e diviso lo spazio rimanente; i valori usuali sono quelli mostrati
-% nell'esempio.
+% nell'esempio. Si pu\`o usare questo comando, dando opportuni valori,
+% per inserire il logo in un posto diverso da quello che si ottiene
+% con \cs{Logo}.
%
-% \frontcommand[o]{Facolta}{\1{nome breve}}
+% \frontcommand[o]{Facolta}{\marg{nome breve}}
% La facolt\`a in cui si sono svolti gli studi. Per le tesi di laurea
% triennale o magistrale, sono le facolt\`a gli enti responsabili
% dell'esame finale.
%
-% \frontcommand[s]{Dipartimento}{\1{nome breve}}
+% \frontcommand[s]{Dipartimento}{\marg{nome breve}}
% Per le tesi di dottorato, la responsabilit\`a \`e di un dipartimento.
%
-% \frontcommand[s]{Divisione}{\1{nome completo}}
+% \frontcommand[s]{Divisione}{\marg{nome completo}}
% Se la facolt\`a o dipartimento ha un nome non usuale, si pu\`o inserirlo
% con questo comando:
% \iffalse
@@ -476,10 +510,10 @@ latex tesi
%</verb>
% \fi
%
-% \frontcommand[s]{Interfacolta}{\1{nomi completi}}
+% \frontcommand[s]{Interfacolta}{\marg{nomi completi}}
% Se il corso di laurea \`e diviso fra pi\`u facolt\`a, si usi questo
-% comando; si noti che, a differenza di \cmdname{Facolta} e
-% \cmdname{Divisione}, il risultato non \`e messo automaticamente in
+% comando; si noti che, a differenza di \cs{Facolta} e
+% \cs{Divisione}, il risultato non \`e messo automaticamente in
% maiuscolo. Quindi si scriva, per esempio,
% \iffalse
%<*verb>
@@ -494,7 +528,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% Si pu\`o usare la doppia barra rovescia per indicare dove spezzare le
% righe.
%
-% \frontcommand[o]{Corso}{\0{tipo}\1{nome}}
+% \frontcommand[o]{Corso}{\oarg{tipo}\marg{nome}}
% Il corso di studi seguito, di cui la tesi \`e il compimento. Ha un
% argomento opzionale che, non espresso, equivale a `Laurea Magistrale':
% \iffalse
@@ -508,7 +542,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%</verb>
% \fi
%
-% \frontcommand[s]{Scuola}{\1{nome completo}}
+% \frontcommand[s]{Scuola}{\marg{nome completo}}
% Se il corso di studi ha un nome speciale, si usi questo comando che
% produce esattamente il suo argomento:
% \iffalse
@@ -521,7 +555,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%</verb>
% \fi
%
-% \frontcommand{Titoletto}{\1{tipo}}
+% \frontcommand{Titoletto}{\marg{tipo}}
% \`E possibile, con questo comando, specificare il tipo di tesi:
% \iffalse
%<*verb>
@@ -535,38 +569,53 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%</verb>
% \fi
%
-% \frontcommand[o]{Titolo}{\1{titolo}}
+% \frontcommand[o]{Titolo}{\marg{titolo}}
% Il titolo della tesi, con eventuali punti dove andare a capo espressi
-% con \verb|\\|.
+% con |\\|.
%
-% \frontcommand{Sottotitolo}{\1{sottotitolo}}
+% \frontcommand{Sottotitolo}{\marg{sottotitolo}}
% Un sottotitolo. Accade talvolta che due studenti preparino la loro
% tesi in collaborazione e che ciascuno ne presenti una parte: il
% sottotitolo \`e per questi casi, o altri che si possano pensare.
%
-% \frontcommand[o]{Candidato}{\0{matricola}\1{nome}}
-% Il nome e cognome del candidato. Notare che, in italiano, il nome va
-% \emph{prima} del cognome, qualsiasi cosa affermino i burocrati. Il
-% comando prende come argomento opzionale il numero di matricola, che
-% potrebbe essere richiesto dalle regole locali. \`E possibile ripetere
-% il comando, nel caso ci siano pi\`u candidati che presentano insieme il
-% lavoro.
+% \frontcommand[o]{Candidato}{\oarg{matricola}\marg{nome}}
+
+% Il nome e cognome del candidato. Notare che, in italiano, il nome
+% va \emph{prima} del cognome, qualsiasi cosa affermino i burocrati.
+% Il comando prende come argomento opzionale il numero di matricola,
+% che potrebbe essere richiesto dalle regole locali. \`E possibile
+% ripetere il comando, nel caso ci siano pi\`u candidati che
+% presentano insieme il lavoro. Non c'\`e un comando per eliminare o
+% modificare la scritta `Matricola'; nel caso lo si desiderasse si pu\`o
+% usare uno fra i seguenti biechi trucchi:
+% \iffalse
+%<*verb>
+% \fi
+\begin{verbatim}
+\Preambolo{\renewcommand{\frontsmallfont}[1]{\small}}
+\Preambolo{\renewcommand{\frontsmallfont}[1]{\small Matr.}}
+\end{verbatim}
+% \iffalse
+%</verb>
+% \fi
+% Con il primo non viene stampato niente, con il secondo si avr\`a
+% l'abbreviazione.
%
-% \frontcommand[o]{Relatore}{\1{nome}}
+% \frontcommand[o]{Relatore}{\marg{nome}}
% Il nome e cognome (se si preferisce preceduto dall'appellativo
% accademico) del relatore. Pu\`o capitare che i relatori siano pi\`u
% d'uno: basta specificarli successivamente, si veda l'esempio di prima.
% Il comando \`e obbligatorio se non si \`e data l'opzione \opt{noadvisor}.
%
-% \frontcommand{Correlatore}{\1{nome}}
+% \frontcommand{Correlatore}{\marg{nome}}
% Il nome e cognome del correlatore, di solito un esterno
% all'istituzione che ha collaborato alla guida del lavoro che ha
% portato alla tesi. Anche qui se ne pu\`o specificare pi\`u d'uno.
%
-% \frontcommand[o]{Annoaccademico}{\1{anno}}
+% \frontcommand[o]{Annoaccademico}{\marg{anno}}
% L'anno accademico nel quale si discute la tesi.
%
-% \frontcommand[s]{Piede}{\1{testo}}
+% \frontcommand[s]{Piede}{\marg{testo}}
% Se al piede non si vuole la scritta ``Anno Accademico'' ma
% qualcos'altro, lo si specifichi nell'argomento a questo comando.
%
@@ -576,7 +625,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% \`e possibile caricare gli stessi caratteri usati nel corpo della tesi o
% cambiare i margini.
%
-% \frontcommand{NCandidato}{\1{nome}}
+% \frontcommand{NCandidato}{\marg{nome}}
% Il nome del candidato \`e preceduto dalla parola ``Candidato''. Se si
% preferisce ``Laureando'', si usi
% \iffalse
@@ -589,7 +638,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%</verb>
% \fi
%
-% \frontcommand{NCandidati}{\1{nome}}
+% \frontcommand{NCandidati}{\marg{nome}}
% Se ci sono pi\`u candidati, i nomi sono preceduti dalla parola
% ``Candidati''. Se si preferisce ``Laureandi'', si usi
% \iffalse
@@ -602,7 +651,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%</verb>
% \fi
%
-% \frontcommand{NRelatore}{\1{singolare}\1{plurale}}
+% \frontcommand{NRelatore}{\marg{singolare}\marg{plurale}}
% Analogamente, il nome del relatore \`e preceduto da ``Relatore''. Se si
% fosse esterofili, si potrebbe modificarlo con
% \iffalse
@@ -617,10 +666,10 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% \`E necessario scrivere sia la forma singolare che quella plurale, anche
% se ci sar\`a un solo relatore (ma si pu\`o lasciare l'argomento vuoto).
%
-% \frontcommand{NCorrelatore}{\1{singolare}\1{plurale}}
+% \frontcommand{NCorrelatore}{\marg{singolare}\marg{plurale}}
% Stesso discorso fatto per l'appellativo del relatore.
%
-% \frontcommand{Punteggiatura}{\1{carattere}}
+% \frontcommand{Punteggiatura}{\marg{carattere}}
% Gli appellativi ``Candidato'' e ``Relatore'' sono seguiti da due
% punti; se non lo si desidera, si scriva
% \iffalse
@@ -633,7 +682,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%</verb>
% \fi
%
-% \frontcommand{Preambolo}{\1{comandi}}
+% \frontcommand{Preambolo}{\marg{comandi}}
% Supponiamo che la tesi sia stata scritta con il carattere Utopia,
% fornito dal pacchetto \pack{fourier}. Occorre specificarlo anche per
% il frontespizio con
@@ -651,13 +700,34 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% effetto cumulativo, si possono risolvere altri problemi particolari.
% Infatti l'argomento del comando viene trascritto cos\`i com'\`e nel
% preambolo del documento~\file{frn}.\footnote{In una versione
-% precedente il comando era chiamato \cmdname{Package}; questo \`e ancora
-% definito come equivalente di \cmdname{Preambolo}, ma il suo uso \`e
+% precedente il comando era chiamato \cs{Package}; questo \`e ancora
+% definito come equivalente di \cs{Preambolo}, ma il suo uso \`e
% deprecato.} Vedremo in seguito altri usi del comando; si consiglia di
-% usarne uno per ciascuna riga da aggiungere al preambolo: l'effetto \`e
-% cumulativo.
+% usarne uno per ciascuna riga da aggiungere al preambolo.
%
-% \frontcommand{Rientro}{\1{dimen}}
+% \frontenvironment{Preambolo*}{\meta{comandi}}
+% Usare molti comandi \cs{Preambolo} pu\`o essere fastidioso.
+% Perci\`o \`e stato introdotto questo ambiente dove possono essere
+% dati vari comandi tutti insieme. Per esempio,
+% \iffalse
+%<*verb>
+% \fi
+\begin{verbatim}
+\begin{Preambolo*}
+\usepackage{kpfonts}
+\renewcommand{\fronttitlefont}{\fontsize{17}{21}\scshape}
+\renewcommand{\frontfootfont}{\fontsize{12}{14}\itshape}
+\end{Preambolo*}
+\end{verbatim}
+% \iffalse
+%</verb>
+% \fi
+% evita di dover specificare lunghi argomenti a \cs{Preambolo} o
+% di usare questo comando pi\`u volte. In uno degli esempi della
+% documentazione si vede come in questo ambiente possa andare
+% qualsiasi cosa sia sensata nel preambolo di un documento \LaTeX.
+%
+% \frontcommand{Rientro}{\marg{dimen}}
% Il nome del candidato e quello del relatore sono a filo dei margini
% sinistro e destro (che si possono ricavare dalle dimensioni dei due
% filetti). Se si desidera averli pi\`u rientrati si pu\`o usare questo
@@ -672,7 +742,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%</verb>
% \fi
%
-% \frontcommand{Margini}{\1{dimen}\1{dimen}\1{dimen}\1{dimen}}
+% \frontcommand{Margini}{\marg{dimen}\marg{dimen}\marg{dimen}\marg{dimen}}
% Se i margini scelti dal pacchetto non sono di gradimento, si possono
% specificarne di diversi con questo comando:
% \iffalse
@@ -687,19 +757,19 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% \`e l'equivalente della scelta del pacchetto. Le dimensioni si
% riferiscono, nell'ordine, al margine sinistro, in basso, destro e in
% alto.\footnote{In versioni precedenti, questo comando e il
-% precedente si chiamavano, rispettivamente, \cmdname{Margins} e
-% \cmdname{MoreMargin}.}
+% precedente si chiamavano, rispettivamente, \cs{Margins} e
+% \cs{MoreMargin}.}
%
%
% \section{Scelta dei caratteri: forma e misura}
%
% Se non si fosse soddisfatti della scelta dei caratteri proposta
-% dall'autore, si pu\`o usare il comando \cmdname{Preambolo} per
-% modificarla. I comandi disponibili compaiono nella
-% tabella~\ref{fonts}, con il loro valore usuale e la posizione in cui
-% vengono usati. Per esempio, per avere il titolo in maiuscoletto~16/20
-% (cio\`e corpo~16 con distanza fra le linee di base di 20 punti), si
-% scriver\`a
+% dall'autore, si pu\`o usare il comando \cs{Preambolo} (o
+% l'ambiente \env{Preambolo*}) per modificarla. I comandi disponibili
+% compaiono nella tabella~\ref{fonts}, con il loro valore usuale e la
+% posizione in cui vengono usati. Per esempio, per avere il titolo in
+% maiuscoletto~16/20 (cio\`e corpo~16 con distanza fra le linee di
+% base di 20 punti), si scriver\`a
% \iffalse
%<*verb>
% \fi
@@ -710,16 +780,18 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% \iffalse
%</verb>
% \fi
-% La sintassi non \`e comoda, per scelta precisa. Si ricordi che con
-% l'opzione \texttt{sans} non \`e disponibile il maiuscoletto. Un'altra
-% cosa da ricordare \`e che per scegliere un carattere, occorre
-% specificare non solo le sue dimensioni (e questo va fatto per prima
-% cosa), ma anche le sue altre caratteristiche. Il comando
-% \cmdname{fontsize} prende due argomenti: il corpo e l'avanzamento di
-% riga; se non si specifica l'unit\`a di misura, viene assunta quella di
-% punti tipografici~(pt). Se si cambia uno dei caratteri predefiniti,
-% occorre specificare ogni aspetto del nuovo, se non si vogliono avere
-% sorprese.
+% La sintassi non \`e comoda, per scelta precisa. Si ricordi che
+% con l'opzione \texttt{sans} non \`e disponibile il maiuscoletto.
+% Un'altra cosa da ricordare \`e che per scegliere un carattere,
+% occorre specificare non solo le sue dimensioni (e questo va fatto
+% per prima cosa), ma anche le sue altre caratteristiche. Il comando
+% \cs{fontsize} prende due argomenti: il corpo e l'avanzamento di
+% riga; se non si specifica l'unit\`a di misura, viene assunta quella
+% di punti tipografici~(pt). Se si cambia uno dei caratteri
+% predefiniti, occorre specificare ogni aspetto del nuovo, se non si
+% vogliono avere sorprese. Una dichiarazione finale come
+% \cs{scshape} o \cs{bfseries} rende disponibile il font; se
+% manca occorre dare \cs{selectfont}.
%
% \begin{table}[ht]
% \centering
@@ -729,32 +801,33 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% \toprule
% Comando & Valore usuale & Impiego\\
% \midrule
-% \cmdname{frontinstitutionfont} &
+% \cs{frontinstitutionfont} &
% Neretto, 14/17 &
% Nome dell'universit\`a o istituzione\\[3pt]
-% \cmdname{frontdivisionfont} &
+% \cs{frontdivisionfont} &
% Tondo, 12/16 &
% Nome della facolt\`a o divisione\\[3pt]
-% \cmdname{frontpretitlefont} &
+% \cs{frontpretitlefont} &
% Maiuscoletto, 10/12 &
% Per il titoletto\\[3pt]
-% \cmdname{fronttitlefont} &
+% \cs{fronttitlefont} &
% Neretto, 17/21 &
% Per il titolo della tesi\\[3pt]
-% \cmdname{frontsubtitlefont} &
+% \cs{frontsubtitlefont} &
% Tondo, 12/14 &
% Per il sottotitolo\\[3pt]
-% \cmdname{frontnamesfont} &
-% Neretto, 12/14 &
-% Per i nomi di candidato e relatore\\[3pt]
-% \cmdname{frontfixednamesfont} &
+% \cs{frontfixednamesfont} &
% Tondo, 12/14 &
% Per scrivere le parole chiave\\
% && `Candidato', `Relatore' e `Correlatore'\\[3pt]
-% \cmdname{frontsmallfont} &
-% Tondo, 9/11 &
-% Per il numero di matricola\\[3pt]
-% \cmdname{frontfootfont} &
+% \cs{frontnamesfont} &
+% Neretto, 12/14 &
+% Per i nomi di candidato e relatore\\[3pt]
+% \cs{frontsmallfont} &
+% Neretto, 9/11 &
+% Per il numero di matricola\\
+% && (eredita attributi dal precedente)\\[3pt]
+% \cs{frontfootfont} &
% Neretto, 12/14 &
% Per scrivere l'anno accademico\\
% \bottomrule
@@ -778,7 +851,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%
% Analogamente si pu\`o aggiustare la composizione nel caso si usi
% l'opzione \opt{signatures} modificando il comando
-% \cmdname{frontadjustforsignatures} per esempio con
+% \cs{frontadjustforsignatures} per esempio con
% \iffalse
%<*verb>
% \fi
@@ -793,7 +866,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% filetto in basso. Il comando non ha effetto se non dando l'opzione
% \opt{signatures}.
%
-% Un terzo parametro dimensionale \`e \cmdname{frontlogosep}, il cui
+% Un terzo parametro dimensionale \`e \cs{frontlogosep}, il cui
% valore normale \`e 6\unit{pt}; se il logo dovesse essere troppo vicino o
% lontano dal nome dell'universit\`a, si pu\`o modificare con un comando
% come
@@ -809,7 +882,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% dove la dimensione pu\`o anche essere negativa.
%
% Nel caso di pi\`u candidati, la spaziatura fra i nomi \`e regolata
-% dal parametro \cmdname{frontcandidatesep}, il cui valore usuale \`e
+% dal parametro \cs{frontcandidatesep}, il cui valore usuale \`e
% 3\unit{ex}; la si pu\`o modificare con un comando come
% \iffalse
%<*verb>
@@ -825,15 +898,17 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
%
% \`E possibile usare \Xe\TeX{}, ovviamente nella forma \Xe\LaTeX, per
% produrre il frontespizio. Ovviamente dovr\`a essere usato il comando
-% \cmdname{Preambolo} per impostare anche il documento~\file{frn} per
+% \cs{Preambolo} per impostare anche il documento~\file{frn} per
% l'uso di questo motore \TeX. Per esempio, se il documento principale
-% \`e composto in ``Adobe Caslon~Pro'', si dovr\`a scrivere
+% \`e composto in ``Adobe Caslon~Pro'', si potr\`a scrivere
% \iffalse
%<*verb>
% \fi
\begin{verbatim}
-\Preambolo{\usepackage{fontspec}}
-\Preambolo{\setmainfont{Adobe Caslon Pro}}
+\begin{Preambolo*}
+\usepackage{fontspec}
+\setmainfont{Adobe Caslon Pro}
+\end{Preambolo*}
\end{verbatim}
% \iffalse
%</verb>
@@ -844,41 +919,45 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE
% nel frontespizio, se non ci sono disposizioni particolari che
% richiedano diversamente.
%
-% Si ricordi che \Xe\TeX{} legge correttamente solo documenti scritti
-% nelle codifiche \textsc{utf}-8 oppure \textsc{utf}-16.
+% Si ricordi che \Xe\TeX{} legge correttamente solo documenti scritti
+% nelle codifiche \textsc{utf}-8 (oppure \textsc{utf}-16). Quindi se
+% il documento principale \`e da compilare con \textsc{pdf}\LaTeX{} si
+% dovr\`a caricare \pack{inputenc} con l'opzione \opt{utf8}, e questo
+% \`e proprio il caso in cui al pacchetto \pack{frontespizio} deve
+% essere passata l'opzione \pack{noinputenc}.
+%
%
%
% \section{Limitazioni e incompatibilit\`a}
%
-% Il pacchetto \`e in versione preliminare, \`e possibile che in futuro
-% cambi anche la sintassi dei comandi da usare. Si spera in maniera
-% compatibile.
-%
-% Gli altri pacchetti caricati sono \pack{ifpdf}, \pack{graphicx} e
-% \pack{afterpage} che non hanno gravi incompatibilit\`a note. Se
-% disponibile sul sistema, viene caricato anche \pack{ifxetex}. Se si
-% dovesse usare \pack{graphicx} con un \emph{driver} diverso da
-% \texttt{dvips} o \texttt{pdftex}, va caricato \emph{prima} di
-% \pack{frontespizio}; ricordiamo che i due \emph{driver} menzionati non
-% vanno dichiarati come opzione a \pack{graphicx}, perch\'e in mancanza di
-% altre opzioni vengono scelti automaticamente dal compilatore.
-% Attenzione: usando \emph{Textures}, per esempio, va inserita anche
-% l'opzione \opt{driver=textures} a \pack{frontespizio}. Cambiare il
-% nome del driver, se necessario; la sintassi \`e questa, niente spazi
-% attorno al segno di uguaglianza. Ovviamente si dovr\`a consultare il
-% manuale della propria distribuzione per sapere come produrre il file
-% eps in modo corretto.
+% Gli altri pacchetti caricati sono \pack{ifpdf}, \pack{graphicx},
+% \pack{afterpage}, \pack{atbegshi} e \pack{ifxetex} che non hanno
+% incompatibilit\`a note. Se si dovesse usare \pack{graphicx} con
+% opzioni, per esempio con un \emph{driver} diverso da \texttt{dvips}
+% o \texttt{pdftex}, va caricato \emph{prima} di \pack{frontespizio};
+% ricordiamo che i due \emph{driver} menzionati non vanno dichiarati
+% come opzione a \pack{graphicx}, perch\'e in mancanza di altre
+% opzioni vengono scelti automaticamente dal compilatore. Attenzione:
+% usando \emph{Textures}, per esempio, va inserita anche l'opzione
+% \opt{driver=textures} a \pack{frontespizio}. Cambiare il nome del
+% driver, se necessario. Ovviamente si dovr\`a consultare il manuale
+% della propria distribuzione per sapere come produrre il file eps in
+% modo corretto.
+%
+% Si noti che il pacchetto non \`e compatibile con \pack{vmargin}; se
+% si desidera modificare l'impostazione tipografica del documento, si
+% usi \pack{geometry}, pi\`u potente e facile.
%
%
% \section{Soluzione del giochino}
%
-% L'etimologia di `Stanford' \`e `stan$+$ford'; l'antico inglese `stan' \`e
-% ora `stone', cio\`e `pietra', mentre il toponimo `ford' indica un luogo
-% di mercato. Il cognome `Knuth' \`e di origine norvegese, affine a
-% `Knudsen', e significa `nodo'. Il nome `Donald' \`e di origine gaelica
-% e vuol dire `reggitore del mondo', mentre `Basilio' viene dalla parola
-% greca che significa~`re'. Il signor Revinu Jitis Drofnats non ha
-% bisogno di presentazioni nel mondo~\TeX.
+% L'etimologia di `Stanford' \`e `stan$+$ford'; l'antico inglese
+% `stan' \`e ora `stone', cio\`e `pietra', mentre il toponimo `ford'
+% indica un luogo di mercato. Il cognome `Knuth' \`e di origine
+% norvegese, affine a `Knudsen', e significa `nodo'. Il nome `Donald'
+% \`e di origine gaelica e vuol dire `reggitore del mondo', mentre
+% `Basilio' viene dalla parola greca che significa~`re'. Revinu Jitis
+% Drofnats non ha bisogno di presentazioni nel mondo~\TeX.
%
%
% \section{Esempi}
@@ -926,7 +1005,7 @@ e applicazioni}
% \fi
% \begin{verbatim}
\documentclass[a4paper,titlepage]{book}
-\usepackage[sans]{frontespizio}
+\usepackage[sans,nouppercase]{frontespizio}
\begin{document}
\begin{frontespizio}
@@ -964,13 +1043,16 @@ e applicazioni}
\begin{document}
\begin{frontespizio}
-\Preambolo{\usepackage{fourier}}
+\begin{Preambolo*}
+ \usepackage{fourier}
+ \newcommand{\compring}{anelli compatti}
+\end{Preambolo*}
\Universita{Bologna}
\Dipartimento{Matematica}
\Corso[Dottorato di Ricerca]{Matematica}
\Titolo{Equivalenza di Morita generalizzata\\
-e applicazioni alla teoria degli\\
-anelli compatti}
+ e applicazioni alla teoria degli\\
+ \compring}
\Candidato{Enrico Gregorio}
\Relatore{Ch.mo Prof.~Ermanno Lanconelli}
\NRelatore{Coordinatore}{}
@@ -989,6 +1071,40 @@ anelli compatti}
% \includeex{examplec-frn}
% \newpage
%
+% \iffalse
+%<*exampled>
+% \fi
+% \begin{verbatim}
+\documentclass[a4paper,titlepage]{book}
+\usepackage[nouppercase]{frontespizio}
+
+\begin{document}
+\begin{frontespizio}
+\Istituzione{University of St.\ Anford}
+\Divisione{Department of typography}
+\Scuola{Ph.D. degree in \TeX{} and \LaTeX{}}
+\Titolo{How to prepare a\\
+ formal frontispiece}
+\Sottotitolo{Theory and practice}
+\NCandidato{Candidate}
+\Candidato{Enrico Gregorio}
+\NRelatore{Thesis advisor}{}
+\Relatore{Prof. R. J. Drofnats}
+\NCorrelatore{Research supervisor}{}
+\Correlatore{X. Treemunch}
+\Piede{Thesis submitted in 2010}
+\end{frontespizio}
+\end{document}
+% \end{verbatim}
+% \iffalse
+%</exampled>
+% \fi
+%
+% \vspace{4ex}
+%
+% \includeex{exampled-frn}
+% \newpage
+%
% \section{A shell script to compile the documentation}
% Running \texttt{latex} on \file{frontespizio.ins} produces also
% \file{makedoc.sh} which can be run, on Unix systems, by one of the
@@ -1009,6 +1125,8 @@ pdflatex exampleb.tex
pdflatex exampleb-frn.tex
pdflatex examplec.tex
pdflatex examplec-frn.tex
+pdflatex exampled.tex
+pdflatex exampled-frn.tex
pdflatex frontespizio.dtx
pdflatex frontespizio-frn.tex
makeindex -s gind frontespizio
@@ -1023,7 +1141,10 @@ exit
%
% \StopEventually{\PrintChanges\PrintIndex}
% \changes{v1.1}{2009/04/03}{Added swapnames option}
-%
+% \changes{v1.2}{2010/06/25}{Added noinputenc option}
+% \changes{v1.2}{2010/06/25}{Added nouppercase option}
+% \changes{v1.2}{2010/06/25}{Added `Preambolo*' environment}
+% \changes{v1.2}{2010/06/25}{Various implementation changes}
% \selectlanguage{english}
% \section{The implementation}
% After the usual stuff of package presentation, here are the actual
@@ -1054,32 +1175,32 @@ exit
% later in order to produce the pdf page that will be included as the
% frontispiece. The option `infront' is a private one, which is set
% only in the \file{frn} file where the nowrite option is set, so we
-% need a correction. It's easier to use \verb|\ifdefined| than to
+% need a correction. It's easier to use \cs{ifdefined} than to
% define many new conditionals. Actually, the package doesn't use
-% $\varepsilon$-\TeX{} features other than \verb|\ifdefined| and
-% \verb|\unless|, but I wanted to try and encourage to upgrade from
+% $\varepsilon$-\TeX{} features other than \cs{ifdefined} and
+% \cs{unless}, but I wanted to try and encourage to upgrade from
% old \TeX{} systems.
%
% \begin{macro}{\iffront@write}
-% The conditional \verb|\iffront@write| is false when we don't want
+% The conditional \cs{iffront@write} is false when we don't want
% to write the \file{frn} file.
% \end{macro}
% \begin{macro}{\front@infront}
-% \verb|\front@infront| is defined only if we are typesetting the
+% \cs{front@infront} is defined only if we are typesetting the
% \file{frn} file.
% \end{macro}
% \begin{macro}{\front@signatures}
-% \verb|\front@signatures| is defined if we need to leave space for
+% \cs{front@signatures} is defined if we need to leave space for
% the advisor's signature.
% \end{macro}
% \begin{macro}{\front@noadvisor}
-% \verb|\front@noadvisor| is defined if we don't want an advisor's
+% \cs{front@noadvisor} is defined if we don't want an advisor's
% name.
% \end{macro}
% \begin{macro}{\front@swapnames}
% \changes{v1.1}{2009/04/03}{Added macro \cs{front@swapnames} and
% option \texttt{swapnames}}
-% \verb|\front@swapnames| is defined if we want to swap the advisor's
+% \cs{front@swapnames} is defined if we want to swap the advisor's
% and candidate's fields.
% \end{macro}
% \begin{macro}{\front@thefont}
@@ -1091,16 +1212,30 @@ exit
% \end{macro}
% \end{macro}
% \begin{macro}{\front@norules}
-% \verb|\front@norules| is defined if we don't want rules in the
+% \cs{front@norules} is defined if we don't want rules in the
% frontispiece.
% \end{macro}
+% \begin{macro}{\front@nouppercase}
+% \changes{v1.2}{2010/06/25}{Added macro \cs{front@nouppercase} and
+% option \texttt{nouppercase}}
+% \cs{front@nouppercase} is defined if we don't want to capitalize
+% the faculty line.
+% \end{macro}
+% \begin{macro}{\front@noinputenc}
+% \changes{v1.2}{2010/06/25}{Added macro \cs{front@noinputenc} and
+% option \texttt{noinputenc}}
+% \cs{front@nouppercase} is defined if we don't want to export the
+% option to \pack{inputenc} to the \file{frn}~file.
+% \end{macro}
% \begin{macro}{\iffront@include}
-% \verb|\iffront@include| controls whether we use the package only in
+% \cs{iffront@include} controls whether we use the package only in
% order to include an external file (similarly to pdfpages).
% \end{macro}
-% \begin{macro}{\front@grfdriver}
-% In \verb|\front@grfdriver| we load the driver's choice; it's a very
-% primitive trick, but not many people use strange drivers, nowadays.
+% \begin{macro}{\front@otheroptions}
+% \changes{v1.2}{2010/06/25}{Added macro \cs{front@otheroptions}}
+% \changes{v1.2}{2010/06/25}{Deleted macro \cs{front@grfdriver}}
+% In \cs{front@otheroptions} we load the all other options, to be
+% processed by \pack{keyval}.
% \end{macro}
% \begin{macrocode}
\newif\iffront@write
@@ -1113,9 +1248,13 @@ exit
\DeclareOption{normal}{\def\front@thefont{\fontoptionnormal}}
\DeclareOption{sans}{\def\front@thefont{\fontoptionsans}}
\DeclareOption{norules}{\let\front@norules=T}
+\DeclareOption{nouppercase}{\let\front@nouppercase=T}
+\DeclareOption{noinputenc}{\let\front@noinputenc=T}
\newif\iffront@include
\DeclareOption{onlyinclude}{\front@includetrue\ExecuteOptions{nowrite}}
-\DeclareOption*{\edef\front@grfdriver{\CurrentOption}}
+\let\front@otheroptions\@empty
+\DeclareOption*{\expandafter\g@addto@macro\expandafter\front@otheroptions
+ \expandafter{\CurrentOption,}}
% \end{macrocode}
% Now we choose the default options; we want to write the \file{frn} file
% and roman fonts.
@@ -1125,41 +1264,43 @@ exit
% \end{macrocode}
% \subsection{Required packages and service macros}
% We load the needed packages. Of course \pack{graphicx} and
-% \pack{eso-pic} for graphic inclusion; we need also \pack{afterpage}
+% \pack{atbegshi} for graphic inclusion; we need also \pack{afterpage}
% for adjustments when using some classes.
+% \changes{v1.2}{2010/06/25}{Changed from \pack{eso-pic} to \pack{atbegshi}}
+% \changes{v1.2}{2010/06/25}{We load also \pack{environ}}
% \begin{macrocode}
\RequirePackage{afterpage}
\RequirePackage{graphicx}
-\RequirePackage{eso-pic}
+\RequirePackage{atbegshi}
+\RequirePackage{environ}
% \end{macrocode}
% \begin{macro}{\includefront}
% We manage first the onlyinclude option. If we are only including an
% external file, we load it and prepare for an empty verso page; the
% optional argument is there in order to correct the page number, if
-% necessary; after that we stop reading the package.
+% necessary; after that we stop reading the package. If a
+% \env{frontespizio} environment is present, it's ignored after
+% raising a warning, via \pack{environ}'s \cs{Collect@Body}.
+% \changes{v1.2}{2010/06/25}{\cs{includefront} now depends on \pack{atbegshi}}
% \begin{macrocode}
\iffront@include
\newcommand{\includefront}[2][0]{%
\titlepage\null
- \AddToShipoutPicture*{\includegraphics{#2}}%
+ \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{%
+ \vbox to\z@{\hbox{\includegraphics{#2}}\vss}}}
\afterpage{\thispagestyle{empty}}%
\endtitlepage
\ifx0#1\else
\null\thispagestyle{empty}\newpage\addtocounter{page}{-#1}%
\fi}
\newenvironment{frontespizio}{%
- \PackageError{frontespizio}
- {Using the `frontespizio' environment along with the%
- \MessageBreak
- `onlyinclude' option is not allowed}
- {You have called `frontespizio' with the `onlyinclude' option%
- \MessageBreak
- which disallows the `frontespizio' environment, thus be%
+ \PackageWarningNoLine{frontespizio}
+ {Using the `frontespizio' environment along with%
\MessageBreak
- prepared for a long string of errors.%
+ the `onlyinclude' option is meaningless. The%
\MessageBreak
- The best is to hit `x' now and correct your input.}%
- }{}
+ environment's content will be ignored}
+ \Collect@Body\@gobble}{}
\expandafter\endinput
\else
% \end{macrocode}
@@ -1171,33 +1312,29 @@ exit
% \begin{macrocode}
\RequirePackage{ifpdf}
% \end{macrocode}
-% We want to support also \Xe\LaTeX{}, but not all distributions have
-% it; so if the package \pack{ifxetex} is not in the system we assume
-% that \Xe\LaTeX{} is not used; we have to bury a \verb|\let| inside a
-% macro, which can be safely undefined later; all \verb|\ifxetex|
-% conditionals will be treated as false, of course. Since we are in a
-% conditional, the definition of \cs{front@ifxetex} must be done in an
-% indirect way.\changes{v1.1}{2009/04/03}{Recoded \cs{front@ifxetex}}
+% We want to support also \Xe\LaTeX{}.
+% \changes{v1.2}{2010/06/25}{Package \pack{ifxetex} is required}
% \begin{macrocode}
-\def\front@ifxetex{%
- \expandafter\let
- \csname ifxetex\expandafter\endcsname
- \csname iffalse\endcsname}
-\IfFileExists{ifxetex.sty}{\RequirePackage{ifxetex}}{\front@ifxetex}
-\let\front@ifxetex\@undefined
+\RequirePackage{ifxetex}
\fi
% \end{macrocode}
% \begin{macro}{\front@write}
% \begin{macro}{\front@expwrite}
% If we are writing the \file{frn} file, we allocate an output stream,
-% otherwise we let \verb|\front@write| and \verb|\front@expwrite| to
-% gobble their argument; \verb|\front@write| is used to write things
-% without expansion while \verb|\front@expwrite| expands tokens in the
-% argument.
+% otherwise we let \cs{front@write} and \cs{front@expwrite} to
+% gobble their argument; \cs{front@write} is used to write things
+% without expansion while \cs{front@expwrite} expands tokens in the
+% argument. We now use, if available, the \cs{pdfmdfivesum} facility
+% of \textsc{pdf}\TeX, in order to tell the user if the \file{frn}
+% file has changed.
% \end{macro}
% \end{macro}
% \begin{macrocode}
\iffront@write
+ \ifdefined\pdfmdfivesum
+ \IfFileExists{\jobname-frn.tex}{%
+ \xdef\front@mdfiveold{\pdfmdfivesum file{\jobname-frn.tex}}}{}%
+ \fi
\newwrite\front@out
\immediate\openout\front@out=\jobname-frn.tex
\long\def\front@write#1{\immediate\write\front@out{\unexpanded{#1}}}
@@ -1212,17 +1349,42 @@ exit
% margins. If a driver option has been given we want to load
% \pack{graphicx} in the frn file with the right driver; we have to do
% this before loading the present package, which always requires
-% \pack{graphicx}.
+% \pack{graphicx}. Meanwhile, we load also the \pack{inputenc}
+% package with the same options given in the main document; this can
+% be overrided with the \opt{noinputenc} package option. Nothing is
+% done if \pack{inputenc} is not loaded in the document.
% \begin{macrocode}
\front@write{\documentclass[titlepage]{article}}
+\ifdefined\front@noinputenc\else
+ \ifdefined\inputencodingname
+ \front@expwrite{\string\usepackage[\inputencodingname]{inputenc}}
+ \fi
+\fi
\front@write{\usepackage[a4paper,%
left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}}
-\ifdefined\front@grfdriver
- \def\front@temp driver=#1\@nil{\def\front@grfdriver{#1}}
- \expandafter\front@temp\front@grfdriver\@nil
- \front@expwrite{\string\usepackage[\front@grfdriver]{graphicx}}
+% \end{macrocode}
+% \begin{macro}{\front@processkeys}
+% If the user has specified an unusual driver for \pack{graphicx}, we
+% manage it with \pack{keyval}; otherwise we load the package without
+% options, in a group because we redefine locally \cs{KV@errx} to be more
+% informative; also the key(s) will be defined only locally, as well
+% as \cs{front@processkeys}.
+% \begin{macrocode}
+\ifx\front@otheroptions\@empty
+ \front@write{\usepackage{graphicx}}
+\else
+ \begingroup
+ \def\KV@errx#1{%
+ \PackageError{frontespizio}{Key #1}
+ {The only allowed key is `driver'; the given key will be ignored.%
+ \MessageBreak Type \space<return> \space to proceed.}}
+ \define@key{front}{driver}{\front@write{\usepackage[#1]{graphicx}}}
+ \edef\front@processkeys{\noexpand\setkeys{front}{\front@otheroptions}}
+ \front@processkeys
+ \endgroup
\fi
% \end{macrocode}
+% \end{macro}
% Set the options in the \file{frn} file: there we don't want to be
% writing the \file{frn} file, of course, nor we need aux files, but
% we add the private option.
@@ -1240,6 +1402,9 @@ exit
\ifdefined\front@norules
\g@addto@macro\front@theoptions{,norules}
\fi
+\ifdefined\front@nouppercase
+ \g@addto@macro\front@theoptions{,nouppercase}
+\fi
\front@expwrite{\string\usepackage[\front@theoptions]{frontespizio}}
\front@write{\nofiles}
% \end{macrocode}
@@ -1250,7 +1415,7 @@ exit
% \end{macrocode}
% \subsection{Commands, conditionals and registers}
% The following commands are necessary only when we are compiling
-% the frontispiece, when the \verb|\front@infront| command is defined.
+% the frontispiece, when the \cs{front@infront} command is defined.
% \begin{macrocode}
\ifdefined\front@infront
\def\fontoptionnormal{%
@@ -1286,9 +1451,9 @@ exit
\fi
% \end{macrocode}
% We need a macro to hide the conditionals, which we load and define
-% only when making the front page; the \verb|\if| conditional will
+% only when making the front page; the \cs{if} conditional will
% always expand to nothing or be skipped altogether up to the matching
-% \verb|\fi| when writing the \file{frn} file; if expanded, however,
+% \cs{fi} when writing the \file{frn} file; if expanded, however,
% it will put in the correct conditional when making the front page.
% \begin{macrocode}
\def\@front@#1{TT\fi\@nameuse{iffront@#1}}
@@ -1298,13 +1463,19 @@ exit
% \begin{macrocode}
\iffront@write
% \end{macrocode}
+% \changes{v1.2}{2010/06/25}{Added the \texttt{Preambolo*} environment}
% If we are writing the \file{frn} file, then we simply copy the
-% commands to it. An exception is \verb|\Preambolo|: in this case we
-% copy only its argument. Since there can be several candidate names,
-% the \verb|\Candidato| macro is treated differently, because it can
-% have an optional argument.
+% commands to it. An exception is \cs{Preambolo}: in this case we
+% copy only its argument. The same is with the |Preambolo*|
+% environment, using \cs{Collect@Body}; the category code changes are
+% made because we want to preserve newlines in the input. Since there
+% can be several candidate names, the \cs{Candidato} macro is treated
+% differently, because it can have an optional argument.
% \begin{macrocode}
\newcommand{\Preambolo}[1]{\front@write{#1}}
+\newenvironment{Preambolo*}
+ {\@makeother\%\@makeother\^^M\newlinechar=`\^^M
+ \Collect@Body\front@write}{}
\newcommand{\Rientro}[1]{\front@write{\Rientro{#1}}}
\newcommand{\Margini}[4]{\front@write{\Margini{#1}{#2}{#3}{#4}}}
\newcommand{\Logo}[2][1.5cm]{\front@write{\Logo[#1]{#2}}}
@@ -1340,7 +1511,7 @@ exit
% \end{macrocode}
% Now some equivalent commands for backwards compatibility with the
% preproduction version called front-th. Unfortunately, the old
-% command \verb|\Matricola| cannot be made compatible.
+% command \cs{Matricola} cannot be made compatible.
% \begin{macrocode}
\def\front@oldcommand#1#2{\def#1{\PackageWarning{frontespizio}
{Old command \string#1 found; use \string#2}#2}}
@@ -1358,7 +1529,7 @@ exit
% \end{macrocode}
% If we are typesetting the front page, then we give the commands
% their real meaning, i.e., we define macros which will be used in
-% \verb|\preparefrontpage|.
+% \cs{preparefrontpage}.
% \begin{macrocode}
\newcommand{\Rientro}[1]{\def\front@push{\hspace{#1}}}
\newcommand{\Margini}[4]{\geometry{left=#1,bottom=#2,right=#3,top=#4}}
@@ -1366,6 +1537,7 @@ exit
\def\front@logosize{#1}\front@logotrue}
% \end{macrocode}
% We support a centered logo in the background, using xkeyval.
+% \changes{v1.2}{2010/06/25}{Changed \cs{Filigrana} definition}
% \begin{macrocode}
\def\front@logobefore{1}\def\front@logoafter{1} % default values
\define@key{filigrana}{height}[10cm]{\def\front@logoheight{#1}}
@@ -1373,13 +1545,12 @@ exit
\define@key{filigrana}{after}[1]{\def\front@logoafter{#1}}
\newcommand{\Filigrana}[2][height=10cm]{%
\setkeys{filigrana}{#1}%
- \AddToShipoutPicture*{%
- \put(0,0){
- \parbox[b][\paperheight]{\paperwidth}{
- \vspace*{\stretch{\front@logobefore}}
- \centering
- \includegraphics[height=\front@logoheight]{#2}
- \vspace{\stretch{\front@logoafter}}
+ \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{%
+ \vtop to\paperheight{\hsize=\paperwidth
+ \vspace*{\stretch{\front@logobefore}}
+ \centering
+ \includegraphics[height=\front@logoheight]{#2}
+ \vspace{\stretch{\front@logoafter}}
}}}}
% \end{macrocode}
% Now we continue the definition of the markup commands, mostly
@@ -1480,9 +1651,21 @@ exit
#2\\% the candidate's name
\def\next{#1}%
\unless\ifx\next\@empty
- \frontsmallfont Matricola #1\\[\frontcandidatesep]
+ \frontsmallfont {Matricola }#1\\[\frontcandidatesep]
\fi}
% \end{macrocode}
+% \begin{macro}{\front@MakeUppercase}
+% \changes{v1.2}{2010/06/25}{Added option \opt{nouppercase}}
+% We define \cs{front@MakeUppercase} to be \cs{MakeUppercase} unless
+% \opt{nouppercase} has been specified, otherwise it does nothing.
+% \begin{macrocode}
+\ifdefined\front@nouppercase
+ \let\front@MakeUppercase\@firstofone
+\else
+ \let\front@MakeUppercase\MakeUppercase
+ \fi
+% \end{macrocode}
+% \end{macro}
%
% \subsection{The typesetting}
% \begin{macro}{\preparefrontpage}
@@ -1517,17 +1700,16 @@ exit
% Third block: the department's name; in Italy graduation theses are
% responsibility of Faculties, only Ph.D. theses are responsibility of
% Departments.
+% \changes{v1.2}{2010/06/25}{Use \cs{front@MakeUppercase}}
% \begin{macrocode}
{\frontdivisionfont
\if\@front@{multiple}
\front@multiple
\else
\if\@front@{division}
- \MakeUppercase{\front@division}
+ \front@MakeUppercase{\front@division}
\else
- \MakeUppercase{\front@thefacoldip}
- DI
- \MakeUppercase{\front@facoldip}
+ \front@MakeUppercase{\front@thefacoldip\space di \front@facoldip}
\fi
\fi\\
\if\@front@{school}
@@ -1563,9 +1745,9 @@ exit
% the left we put the candidate's name, on the right the advisor's
% name (possibly more than one) and, if present, the coadvisor's name.
% It the option `swapnames' has been given, the two columns are exchanged.
-% \begin{macrocode}
% \changes{v1.1}{2009/04/03}{Added \cs{front@makecandidates}}
% \changes{v1.1}{2009/04/03}{Added \cs{front@@makeadvisors}}
+% \begin{macrocode}
\def\front@makecandidates{%
\begin{tabular}[t]{@{}l@{}}
\relax\ifnum\front@candcount<1
@@ -1635,8 +1817,8 @@ exit
\par}
\endtitlepage}
% \end{macrocode}
-% The following \verb|\else| matches the
-% \verb|\ifdefined\front@infront| several lines ahead
+% The following \cs{else} matches the |\ifdefined\front@infront|
+% several lines ahead
% \begin{macrocode}
\else
% \end{macrocode}
@@ -1671,8 +1853,8 @@ exit
\newcommand{\NCorrelatore}[2]{}
\newcommand{\Punteggiatura}[1]{}
% \end{macrocode}
-% The following two \verb|\fi| match \verb|\ifdefined\front@infront|
-% and \verb|\iffront@write| several lines ahead
+% The following two \cs{fi} match |\ifdefined\front@infront|
+% and \cs{iffront@write} several lines ahead
% \begin{macrocode}
\fi
\fi
@@ -1698,7 +1880,32 @@ exit
\advance\c@page\m@ne}}
{\let\front@cp\relax}
% \end{macrocode}
+% \begin{macro}{\front@message}
+% \changes{v1.2}{2010/06/25}{Added infrastructure for the final message}
+% Here we define the infrastructure for the final message.
+% \begin{macrocode}
+\newif\if@front@message
+\def\front@message{%
+ \PackageWarningNoLine{frontespizio}
+ {Remember to compile \jobname-frn with\MessageBreak
+ \ifpdf
+ pdflatex \jobname-frn%
+ \else
+ \ifxetex
+ xelatex \jobname-frn
+ \else
+ latex \jobname-frn\MessageBreak
+ dvips -o \jobname-frn.eps \jobname-frn%
+ \fi
+ \fi\MessageBreak
+ and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}}
+% \end{macrocode}
+% \end{macro}
% \begin{environment}{frontespizio}
+% \changes{v1.2}{2010/06/25}{Changed the definition to use \pack{atbegshi}}
+% \changes{v1.2}{2010/06/25}{Excised the final message stuff}
+% \changes{v1.2}{2010/06/25}{Modified \cs{endfrontespizio} for the
+% final message}
% The environment \env{frontespizio} goes in the main file and is
% responsible for ending the writing of the \file{frn} file (in its final
% part; in the initial part it typesets the front page by including
@@ -1713,22 +1920,10 @@ exit
% \begin{macrocode}
\def\frontespizio{%
\titlepage\null
- \IfFileExists{\jobname-frn.\front@ext}
- {\AddToShipoutPicture*{\includegraphics{\jobname-frn}}}
- {\AtEndDocument{%
- \PackageWarningNoLine{frontespizio}
- {Remember to compile \jobname-frn with\MessageBreak
- \ifpdf
- pdflatex \jobname-frn%
- \else
- \ifxetex
- xelatex \jobname-frn
- \else
- latex \jobname-frn\MessageBreak
- dvips -o \jobname-frn.eps \jobname-frn%
- \fi
- \fi\MessageBreak
- and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}}}
+ \IfFileExists{\jobname-frn.\front@ext}
+ {\AtBeginShipoutNext{\AtBeginShipoutUpperLeft{%
+ \vbox to\z@{\hbox{\includegraphics{\jobname-frn}}\vss}}}}
+ {\@front@messagetrue}%
\afterpage{\thispagestyle{empty}}%
\endtitlepage
\if@twoside\front@cp\fi
@@ -1738,6 +1933,15 @@ exit
\front@write{\preparefrontpage}
\front@write{\end{document}}
\iffront@write\immediate\closeout\front@out\fi
+ \ifdefined\front@mdfiveold
+ \xdef\front@mdfivenew{\pdfmdfivesum file{\jobname-frn.tex}}%
+ \ifx\front@mdfiveold\front@mdfivenew\else
+ \@front@messagetrue
+ \fi
+ \fi
+ \if@front@message
+ \AtEndDocument{\front@message}
+ \fi
}
% \end{macrocode}
% \iffalse
diff --git a/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins b/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins
index cc7220e6078..8d9a7e50ebb 100644
--- a/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins
+++ b/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins
@@ -1,10 +1,13 @@
-%%
%% frontespizio.ins
-%% Copyright 2008 Enrico Gregorio
+%% Copyright 2008-2010 Enrico Gregorio
%%
-%% This program is provided under the terms of the
-%% LaTeX Project Public License distributed from CTAN
-%% archives in directory macros/latex/base/lppl.txt.
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
%%
%% Author: Enrico Gregorio
%% Enrico dot Gregorio at univr dot it
@@ -15,12 +18,14 @@
%% driver files from the doc files in this package when run through
%% LaTeX or TeX.
%%
+%% This work consists of all files listed in README
+%%
%% --------------- start of docstrip commands ------------------
%%
\input docstrip
\preamble
- Copyright 2008 Enrico Gregorio
+ Copyright 2008-2010 Enrico Gregorio
This program is provided under the terms of the
LaTeX Project Public License distributed from CTAN
@@ -41,6 +46,7 @@
\file{examplea.tex}{\from{frontespizio.dtx}{examplea}}%
\file{exampleb.tex}{\from{frontespizio.dtx}{exampleb}}%
\file{examplec.tex}{\from{frontespizio.dtx}{examplec}}%
+ \file{exampled.tex}{\from{frontespizio.dtx}{exampled}}%
\nopreamble\nopostamble
\file{makedoc.sh}{\from{frontespizio.dtx}{thedoc}}%
}
diff --git a/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty b/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty
index bb81afd9411..72b4172ad4d 100644
--- a/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty
+++ b/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty
@@ -6,7 +6,7 @@
%%
%% frontespizio.dtx (with options: `package')
%%
-%% Copyright 2008 Enrico Gregorio
+%% Copyright 2008-2010 Enrico Gregorio
%%
%% This program is provided under the terms of the
%% LaTeX Project Public License distributed from CTAN
@@ -17,9 +17,10 @@
%%
%% This work has the LPPL maintenance status "author-maintained".
%%
-\NeedsTeXFormat{LaTeX2e}[1999/12/01]
+\NeedsTeXFormat{LaTeX2e}[2005/12/01]
\ProvidesPackage{frontespizio}
- [2009/04/03 1.1 (Enrico Gregorio)]
+ [2010/06/25 1.2 (Enrico Gregorio)]
+
\def\@not@eTeX{%
\PackageError{frontespizio}
{This package requires e-TeX, I'll stop right now}
@@ -44,47 +45,47 @@
\DeclareOption{normal}{\def\front@thefont{\fontoptionnormal}}
\DeclareOption{sans}{\def\front@thefont{\fontoptionsans}}
\DeclareOption{norules}{\let\front@norules=T}
+\DeclareOption{nouppercase}{\let\front@nouppercase=T}
+\DeclareOption{noinputenc}{\let\front@noinputenc=T}
\newif\iffront@include
\DeclareOption{onlyinclude}{\front@includetrue\ExecuteOptions{nowrite}}
-\DeclareOption*{\edef\front@grfdriver{\CurrentOption}}
+\let\front@otheroptions\@empty
+\DeclareOption*{\expandafter\g@addto@macro\expandafter\front@otheroptions
+ \expandafter{\CurrentOption,}}
\ExecuteOptions{write,normal}
\ProcessOptions\relax
\RequirePackage{afterpage}
\RequirePackage{graphicx}
-\RequirePackage{eso-pic}
+\RequirePackage{atbegshi}
+\RequirePackage{environ}
\iffront@include
\newcommand{\includefront}[2][0]{%
\titlepage\null
- \AddToShipoutPicture*{\includegraphics{#2}}%
+ \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{%
+ \vbox to\z@{\hbox{\includegraphics{#2}}\vss}}}
\afterpage{\thispagestyle{empty}}%
\endtitlepage
\ifx0#1\else
\null\thispagestyle{empty}\newpage\addtocounter{page}{-#1}%
\fi}
\newenvironment{frontespizio}{%
- \PackageError{frontespizio}
- {Using the `frontespizio' environment along with the%
- \MessageBreak
- `onlyinclude' option is not allowed}
- {You have called `frontespizio' with the `onlyinclude' option%
+ \PackageWarningNoLine{frontespizio}
+ {Using the `frontespizio' environment along with%
\MessageBreak
- which disallows the `frontespizio' environment, thus be%
+ the `onlyinclude' option is meaningless. The%
\MessageBreak
- prepared for a long string of errors.%
- \MessageBreak
- The best is to hit `x' now and correct your input.}%
- }{}
+ environment's content will be ignored}
+ \Collect@Body\@gobble}{}
\expandafter\endinput
\else
\RequirePackage{ifpdf}
-\def\front@ifxetex{%
- \expandafter\let
- \csname ifxetex\expandafter\endcsname
- \csname iffalse\endcsname}
-\IfFileExists{ifxetex.sty}{\RequirePackage{ifxetex}}{\front@ifxetex}
-\let\front@ifxetex\@undefined
+\RequirePackage{ifxetex}
\fi
\iffront@write
+ \ifdefined\pdfmdfivesum
+ \IfFileExists{\jobname-frn.tex}{%
+ \xdef\front@mdfiveold{\pdfmdfivesum file{\jobname-frn.tex}}}{}%
+ \fi
\newwrite\front@out
\immediate\openout\front@out=\jobname-frn.tex
\long\def\front@write#1{\immediate\write\front@out{\unexpanded{#1}}}
@@ -94,12 +95,25 @@
\let\front@expwrite\front@write
\fi
\front@write{\documentclass[titlepage]{article}}
+\ifdefined\front@noinputenc\else
+ \ifdefined\inputencodingname
+ \front@expwrite{\string\usepackage[\inputencodingname]{inputenc}}
+ \fi
+\fi
\front@write{\usepackage[a4paper,%
left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}}
-\ifdefined\front@grfdriver
- \def\front@temp driver=#1\@nil{\def\front@grfdriver{#1}}
- \expandafter\front@temp\front@grfdriver\@nil
- \front@expwrite{\string\usepackage[\front@grfdriver]{graphicx}}
+\ifx\front@otheroptions\@empty
+ \front@write{\usepackage{graphicx}}
+\else
+ \begingroup
+ \def\KV@errx#1{%
+ \PackageError{frontespizio}{Key #1}
+ {The only allowed key is `driver'; the given key will be ignored.%
+ \MessageBreak Type \space<return> \space to proceed.}}
+ \define@key{front}{driver}{\front@write{\usepackage[#1]{graphicx}}}
+ \edef\front@processkeys{\noexpand\setkeys{front}{\front@otheroptions}}
+ \front@processkeys
+ \endgroup
\fi
\def\front@theoptions{nowrite,infront}
\ifdefined\front@signatures
@@ -114,6 +128,9 @@
\ifdefined\front@norules
\g@addto@macro\front@theoptions{,norules}
\fi
+\ifdefined\front@nouppercase
+ \g@addto@macro\front@theoptions{,nouppercase}
+\fi
\front@expwrite{\string\usepackage[\front@theoptions]{frontespizio}}
\front@write{\nofiles}
\expandafter\front@write\expandafter{\front@thefont}
@@ -152,6 +169,9 @@
\def\@front@#1{TT\fi\@nameuse{iffront@#1}}
\iffront@write
\newcommand{\Preambolo}[1]{\front@write{#1}}
+\newenvironment{Preambolo*}
+ {\@makeother\%\@makeother\^^M\newlinechar=`\^^M
+ \Collect@Body\front@write}{}
\newcommand{\Rientro}[1]{\front@write{\Rientro{#1}}}
\newcommand{\Margini}[4]{\front@write{\Margini{#1}{#2}{#3}{#4}}}
\newcommand{\Logo}[2][1.5cm]{\front@write{\Logo[#1]{#2}}}
@@ -205,13 +225,12 @@
\define@key{filigrana}{after}[1]{\def\front@logoafter{#1}}
\newcommand{\Filigrana}[2][height=10cm]{%
\setkeys{filigrana}{#1}%
- \AddToShipoutPicture*{%
- \put(0,0){
- \parbox[b][\paperheight]{\paperwidth}{
- \vspace*{\stretch{\front@logobefore}}
- \centering
- \includegraphics[height=\front@logoheight]{#2}
- \vspace{\stretch{\front@logoafter}}
+ \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{%
+ \vtop to\paperheight{\hsize=\paperwidth
+ \vspace*{\stretch{\front@logobefore}}
+ \centering
+ \includegraphics[height=\front@logoheight]{#2}
+ \vspace{\stretch{\front@logoafter}}
}}}}
\newcommand{\Universita}[1]{\def\front@univ{#1}}
\newcommand{\Istituzione}[1]{\def\front@instit{#1}\front@insttrue}
@@ -267,8 +286,13 @@
#2\\% the candidate's name
\def\next{#1}%
\unless\ifx\next\@empty
- \frontsmallfont Matricola #1\\[\frontcandidatesep]
+ \frontsmallfont {Matricola }#1\\[\frontcandidatesep]
\fi}
+\ifdefined\front@nouppercase
+ \let\front@MakeUppercase\@firstofone
+\else
+ \let\front@MakeUppercase\MakeUppercase
+ \fi
\def\preparefrontpage{%
\titlepage\front@font
\centering
@@ -292,11 +316,9 @@
\front@multiple
\else
\if\@front@{division}
- \MakeUppercase{\front@division}
+ \front@MakeUppercase{\front@division}
\else
- \MakeUppercase{\front@thefacoldip}
- DI
- \MakeUppercase{\front@facoldip}
+ \front@MakeUppercase{\front@thefacoldip\space di \front@facoldip}
\fi
\fi\\
\if\@front@{school}
@@ -423,24 +445,27 @@
{\def\front@cp{\null\thispagestyle{empty}\newpage
\advance\c@page\m@ne}}
{\let\front@cp\relax}
+\newif\if@front@message
+\def\front@message{%
+ \PackageWarningNoLine{frontespizio}
+ {Remember to compile \jobname-frn with\MessageBreak
+ \ifpdf
+ pdflatex \jobname-frn%
+ \else
+ \ifxetex
+ xelatex \jobname-frn
+ \else
+ latex \jobname-frn\MessageBreak
+ dvips -o \jobname-frn.eps \jobname-frn%
+ \fi
+ \fi\MessageBreak
+ and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}}
\def\frontespizio{%
\titlepage\null
- \IfFileExists{\jobname-frn.\front@ext}
- {\AddToShipoutPicture*{\includegraphics{\jobname-frn}}}
- {\AtEndDocument{%
- \PackageWarningNoLine{frontespizio}
- {Remember to compile \jobname-frn with\MessageBreak
- \ifpdf
- pdflatex \jobname-frn%
- \else
- \ifxetex
- xelatex \jobname-frn
- \else
- latex \jobname-frn\MessageBreak
- dvips -o \jobname-frn.eps \jobname-frn%
- \fi
- \fi\MessageBreak
- and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}}}
+ \IfFileExists{\jobname-frn.\front@ext}
+ {\AtBeginShipoutNext{\AtBeginShipoutUpperLeft{%
+ \vbox to\z@{\hbox{\includegraphics{\jobname-frn}}\vss}}}}
+ {\@front@messagetrue}%
\afterpage{\thispagestyle{empty}}%
\endtitlepage
\if@twoside\front@cp\fi
@@ -450,6 +475,15 @@
\front@write{\preparefrontpage}
\front@write{\end{document}}
\iffront@write\immediate\closeout\front@out\fi
+ \ifdefined\front@mdfiveold
+ \xdef\front@mdfivenew{\pdfmdfivesum file{\jobname-frn.tex}}%
+ \ifx\front@mdfiveold\front@mdfivenew\else
+ \@front@messagetrue
+ \fi
+ \fi
+ \if@front@message
+ \AtEndDocument{\front@message}
+ \fi
}
\endinput
%%
diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds
index 03ed7d288bd..1c1255497f6 100755
--- a/Master/tlpkg/libexec/ctan2tds
+++ b/Master/tlpkg/libexec/ctan2tds
@@ -144,6 +144,7 @@ $Master = "$mydir/../..";
'changebar', "&MAKEchangebar",
'chapterbib', "die 'skipping, update cite instead'",
'chemarrow', "&MAKEflatten", # check about Arrow.vfb
+ 'chemstruct', "die 'skipping, old latex 2.09, never in tl'",
'chemsym', "die 'skipping, nonfree'",
'cheq', "die 'skipping, nosell license'",
'china2e', "die 'skipping, nosell license'",