bookest update (22may07)

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

5 files changed, 47 insertions, 14 deletions

diff --git a/Master/texmf-dist/doc/latex/bookest/README b/Master/texmf-dist/doc/latex/bookest/README
index b333b2f9349..021b1a31520 100644
--- a/Master/texmf-dist/doc/latex/bookest/README
+++ b/Master/texmf-dist/doc/latex/bookest/README
@@ -22,15 +22,26 @@ The extensions provided by the class involve:
 
      %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+Version 1.0.4 - 2007/05/22
+# Added "abstract" environment
+
+Version 1.0.3 - 2007/05/13
+# Unused options are passed to the book class
+
+Version 1.0.2 - 2007/05/12
+# Added "\shipouttext" and "\shipoutimage" commands
+
+Version 1.0.1 - 2007/04/27
+# Added "logo-topc" and "logo-topc-nofooter" options
 
 Version 1.0 - 2007/04/12
 # First public release
 
-
      %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
      %%                                                                 %%
      %% Package name: bookest                                           %%
      %% Author: Riccardo Bresciani - bresciani(at)sssup.it              %%
+     %% Web: http://tex.boris-web.net/bookest                           %%
      %%                                                                 %%
      %% Description: This package provides an extension to the          %%
      %%              book class                                         %%
diff --git a/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.pdf b/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.pdf
index 84f53f30120..c9fa4012cd3 100644
--- a/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.pdf
+++ b/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.pdf
diff --git a/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.tex b/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.tex
index fe7a1df0803..bd6c2b2e2be 100644
--- a/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.tex
+++ b/Master/texmf-dist/doc/latex/bookest/bookestdoc-en.tex
@@ -16,7 +16,7 @@ pdfstartview=FitV,
 %colorlinks
 }
 
-\setoddheadtext{{\colorA The \texttt{bookest} class --- Version 1.0\hfill Riccardo Bresciani}}
+\setoddheadtext{{\colorA The \texttt{bookest} class --- Version 1.0.4\hfill Riccardo Bresciani}}
 \setoddfoot{\hfill{\colorA\thepage}\hfill}
 
 \makeatletter
@@ -27,8 +27,8 @@ pdfstartview=FitV,
 \newcommand{\tA}[1]{\texttt{\colorA #1}}
 
 \begin{document}
- \chapter*{The \texttt{bookest} class\\{\Large Version 1.0 --- \today}\\{\Large Riccardo Bresciani}}
-The \texttt{bookest} class in an extension of the standard \texttt{book} class, which it relies on and that is loaded with the default options.
+ \chapter*{The \texttt{bookest} class\\{\Large Version 1.0.4 --- \today}\\{\Large Riccardo Bresciani}}
+The \texttt{bookest} class in an extension of the standard \texttt{book} class, on which it relies and that is loaded with the default options.
 
 \ppar
 The extensions provided by the class involve:
@@ -40,6 +40,8 @@ The extensions provided by the class involve:
  \item \dots
 \end{enumerate}
 
+The \texttt{bookest} web page is \url{http://tex.boris-web.net/bookest}.
+
 \section{Colors}
 \texttt{bookest} requires the \texttt{color} and the \texttt{pdfcolmk}\footnote{This package, reported by Massimiliano Dominici (\GuIT), allows to bypass some of the limitations that pdf\TeX\ has up to version 1.30, mainly the unsupported \emph{colorstack}. Currently the package is loaded by default, but as soon as the main ditributions (MiK\TeX, te\TeX, \dots) will have pdf\TeX\ versione 1.40 this package will be removed from the class.} packages to provide color support to the document.
 
@@ -47,10 +49,10 @@ The extensions provided by the class involve:
 Specifically, colors \texttt{A} and \texttt{B} are defined: they will be used in the definition of the sectioning commands and in coloring of some text elements --- e.g. the \texttt{footnote} rules or the list labels in \texttt{itemize}, \texttt{enumerate} e \texttt{description}.
 
 \ppar
-The default document is black and white, the user can anyway define the colors accordingly to his taste by using the commands listed in \ref{coloricomandi}.
+The default document is black and white, the user can anyway define the colors according to his taste by using the commands listed in \ref{coloricomandi}.
 
 \ppar
-\texttt{bookest} provides some preset color combinations, that can be activated with the corresponding class options listed in \ref{coloriopzioni}. Using these options requires the \texttt{hyperref} package, as link and anchor colors (color \texttt{A}) and citation color (color \texttt{B}) are set.
+\texttt{bookest} provides some preset color combinations that can be activated with the corresponding class options listed in \ref{coloriopzioni}. For these options to be used the \texttt{hyperref} package is required, as link and anchor colors (color \texttt{A}) and citation color (color \texttt{B}) are set.
 
 \subsection{Commands}\label{coloricomandi}
 \begin{description}
@@ -80,6 +82,8 @@ The default document is black and white, the user can anyway define the colors a
  \item paragraph indentation and spacing.
 \end{itemize}
 
+Moreover, \texttt{bookest} provides two commands to insert an image or a text as shipout picture.
+
 \subsection{Options}
 \begin{description}
  \item[\texttt{oneside}, \texttt{twoside}] toggles duplex options (default: \texttt{twoside});
@@ -101,6 +105,12 @@ The default document is black and white, the user can anyway define the colors a
  \item[\texttt{noparskip}] sets paragraph spacing to 0.
 \end{description}
 
+\subsection{Commands}
+\begin{description}
+ \item [\texttt{\textbackslash shipouttext\{\textit{<rot>}\}\{\textit{<sc>}\}\{\textit{<text>}\}}] puts in every page the text \texttt{\textit{<text>}} as shipout picture, rotating it counterclockwise by \texttt{\textit{<rot>}} degrees and applying a scale factor \texttt{\textit{<sc>}}. The default color is gray 5\% --- requires the \texttt{setspace} package --- requires the \texttt{everyshi} and \texttt{color} packages;
+ \item [\texttt{\textbackslash shipoutimage\{\textit{<options>}\}\{\textit{<file>}\}}] puts in everypage the image \texttt{\textit{<file>}} as shipout picture, using \texttt{\textit{<options>}} as \texttt{\textbackslash includegraphics} options --- requires the \texttt{everyshi} and \texttt{graphicx} packages.
+\end{description}
+
 \section{Headings and footers}
 \texttt{bookest} provides commands to allow the user to set easily headings and footers. Moreover it provides a default setting that is different from \texttt{book}\footnote{To use the default \texttt{book} styles one has to simply use the command \texttt{\textbackslash pagestyle\{\textit{<style>}\}}.}.
 
@@ -127,13 +137,13 @@ It also redefines chapter headings and the \texttt{plain} style to include color
 \ppar
 The default layout has author and title centered at top of the page and to the bottom of the page is a footer made by the content of \texttt{\textbackslash titlingpageprefooter} and of \texttt{\textbackslash titlingpagefooter} divided by a horizontal line. Between title and footer is the content of \texttt{\textbackslash titlingpagemiddle}.
 
-The different options allow to vary the logo position; for each option \texttt{\textit{<optlogo>}} in \ref{copertinaopzioni} exists a variant \texttt{\textit{<optlogo>}-nofooter} where no footer is present.
+The different options allow to vary the logo position; for each option \texttt{\textit{<optlogo>}} in \ref{copertinaopzioni} there exists a variant \texttt{\textit{<optlogo>}-nofooter} where no footer is present.
 
 \subsection{Commands}
 \begin{description}
  \item[\texttt{\textbackslash inslogo\{\textit{<file>}\}}] inserts the image \texttt{\textit{<file>}} with \texttt{\textbackslash includegraphics} options previously defined and used for the logo (default: \texttt{width=0.6\textbackslash paperwidth});
  \item[\texttt{\textbackslash setlogooptions\{\textit{<options>}\}}] defines \texttt{\textit{<options>}} as the \texttt{\textbackslash includegraphics} options to be used by \texttt{\textbackslash inslogo};
- \item[\texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo}] are the path (relative or absolute) of the image to be used as logo depending on the chosen options (default for all three is the relative path \texttt{logo});
+ \item[\texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo}] are the path (relative or absolute) of the image to be used as logo depending on the chosen options (default for \texttt{\textbackslash logo} is the relative path \texttt{logo}, default for the others is \texttt{\textbackslash logo});
  \item[\texttt{\textbackslash setlogo\{\textit{<path>}\}}, \texttt{\textbackslash setleftlogo\{\textit{<path>}\}}, \texttt{\textbackslash setrightlogo\{\textit{<path>}\}}] set to \texttt{\textit{<path>}} the content of \texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo};
  \item[\texttt{\textbackslash titlingpagemiddle}] is the text to be put in the middle of the \emph{titling page};
  \item[\texttt{\textbackslash settitlingpagemiddle}] sets the text in \texttt{\textbackslash titlingpagemiddle};
@@ -149,7 +159,7 @@ The different options allow to vary the logo position; for each option \texttt{\
 \begin{description}
  \item[\texttt{nofooter}] variant without footer of the default layout;
  \item[\texttt{logo}, \texttt{logo-nofooter}] adds to the default layout the logo in \texttt{\textbackslash logo} under the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
- \item[\texttt{logo-bg}, \texttt{logo-bg-nofooter}] adds to the default layout the logo in \texttt{\textbackslash logo} in the background (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
+ \item[\texttt{logo-bg}, \texttt{logo-bg-nofooter}] adds to the default layout the logo in \texttt{\textbackslash logo} in the background (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} and the \texttt{eso-pic} packages;
  \item[\texttt{logo-topl}, \texttt{logo-topl-nofooter}] adds to the default layout the logo in \texttt{\textbackslash leftlogo} at top left of the page before the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
  \item[\texttt{logo-topc}, \texttt{logo-topc-nofooter}] adds to the default layout the logo in \texttt{\textbackslash logo} at top center of the page before the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
  \item[\texttt{logo-topr}, \texttt{logo-topr-nofooter}]  adds to the default layout the logo in \texttt{\textbackslash rightlogo} at top left of the page before the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
@@ -171,10 +181,11 @@ The different options allow to vary the logo position; for each option \texttt{\
 
 \subsection{Environments}
 \begin{description}
+ \item[\texttt{abstract}] is an environment of width \texttt{0.9\textbackslash textwidth}, with a parameter \texttt{\textit{<title>}} to be written in bold series before the text contained in the environment;
  \item[\texttt{dimst}] is an environment where the text is in \texttt{slshape} and with 1 cm extra for the left margin.
 \end{description}
 
 \section{Contacts}
-For comments, suggestions or bug reports, you can reach me at the address \href{mailto:bresciani@sssup.it}{\textit{bresciani@sssup.it}}.
+For comments, suggestions or bug reports, you can contact me at the address \href{mailto:bresciani@sssup.it}{\textit{bresciani@sssup.it}}.
 
 \end{document}
diff --git a/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.pdf b/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.pdf
index 7827eddba36..e301d7f3181 100644
--- a/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.pdf
+++ b/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.pdf
diff --git a/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.tex b/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.tex
index 5a9fbe3a33c..4e7b76177b5 100644
--- a/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.tex
+++ b/Master/texmf-dist/doc/latex/bookest/bookestdoc-it.tex
@@ -14,7 +14,7 @@ pdfstartview=FitV,
 %colorlinks
 }
 
-\setoddheadtext{{\colorA The \texttt{bookest} class --- Versione 1.0\hfill Riccardo Bresciani}}
+\setoddheadtext{{\colorA The \texttt{bookest} class --- Versione 1.0.4\hfill Riccardo Bresciani}}
 \setoddfoot{\hfill{\colorA\thepage}\hfill}
 
 \makeatletter
@@ -25,7 +25,7 @@ pdfstartview=FitV,
 \newcommand{\tA}[1]{\texttt{\colorA #1}}
 
 \begin{document}
- \chapter*{The \texttt{bookest} class\\{\Large Versione 1.0 --- \today}\\{\Large Riccardo Bresciani}}
+ \chapter*{The \texttt{bookest} class\\{\Large Versione 1.0.4 --- \today}\\{\Large Riccardo Bresciani}}
 La classe \texttt{bookest} è un'estensione della classe standard \texttt{book}, classe alla quale si appoggia e che viene caricata con le opzioni di default.
 
 \ppar
@@ -38,6 +38,8 @@ Le estensioni fornite dalla classe riguardano:
  \item \dots
 \end{enumerate}
 
+La pagina web di \texttt{bookest} è \url{http://tex.boris-web.net/bookest}.
+
 \section{Colori}
 \texttt{bookest} richiede i pacchetti \texttt{color} e \texttt{pdfcolmk}\footnote{Questo pacchetto, segnalato da Massimiliano Dominici (\GuIT), permette di ovviare ad alcune limitazioni che pdf\TeX\ ha fino alla versione 1.30, in particolare al fatto che non sia supportato il \emph{colorstack}. Attualmente il pacchetto viene caricato di default, ma non appena le principali distribuzioni (MiK\TeX, te\TeX, \dots) avranno pdf\TeX\ versione 1.40 questo pacchetto verrà eliminato dalla classe.} per fornire il supporto del colore al documento.
 
@@ -78,6 +80,8 @@ Di default il documento è in bianco e nero, l'utente può però definire i colo
  \item l'indentazione nei paragrafi e la loro spaziatura reciproca.
 \end{itemize}
 
+\texttt{bookest} fornisce inoltre due comandi per inserire un'immagine o una scritta nel documento come filigrana.
+
 \subsection{Opzioni}
 \begin{description}
  \item[\texttt{oneside}, \texttt{twoside}] abilita o disabilita il fronte-retro (default: \texttt{twoside});
@@ -99,6 +103,12 @@ Di default il documento è in bianco e nero, l'utente può però definire i colo
  \item[\texttt{noparskip}] annulla lo spazio verticale tra i paragrafi.
 \end{description}
 
+\subsection{Comandi}
+\begin{description}
+ \item [\texttt{\textbackslash shipouttext\{\textit{<rot>}\}\{\textit{<sc>}\}\{\textit{<testo>}\}}] inserisce in ogni pagina il testo \texttt{\textit{<testo>}} come filigrana, ruotandolo di \texttt{\textit{<rot>}} gradi in senso antiorario e applicando un fattore di scala \texttt{\textit{<sc>}}. Il colore di default è grigio al 5\% --- richiede i pacchetti \texttt{everyshi} e \texttt{color};
+ \item [\texttt{\textbackslash shipoutimage\{\textit{<opzioni>}\}\{\textit{<file>}\}}] inserisce in ogni pagina l'immagine \texttt{\textit{<file>}} come filigrana, utilizzando \texttt{\textit{<opzioni>}} come opzioni \texttt{\textbackslash includegraphics} --- richiede i pacchetti \texttt{everyshi} e \texttt{color}.
+\end{description}
+
 \section{Testatine e pie' di pagina}
 \texttt{bookest} fornisce dei comandi per permettere all'utente di impostare agevolmente testatine e pie' di pagina, nonché un'impostazione predefinita diversa da quella di \texttt{book}\footnote{Per utilizzare gli stili predefiniti di \texttt{book} è sufficiente utilizzare il comando \texttt{\textbackslash pagestyle\{\textit{<stile>}\}}.}.
 
@@ -131,7 +141,7 @@ Le varie opzioni permettono di variare il posizionamento del logo; per ciascuna
 \begin{description}
  \item[\texttt{\textbackslash inslogo\{\textit{<file>}\}}] inserisce l'immagine \texttt{\textit{<file>}} con opzioni \texttt{\textbackslash includegraphics} definite in precedenza e usate per il logo (default: \texttt{width=0.6\textbackslash paperwidth});
  \item[\texttt{\textbackslash setlogooptions\{\textit{<opzioni>}\}}] definisce \texttt{\textit{<opzioni>}} come le opzioni di \texttt{\textbackslash includegraphics} che verranno usate da \texttt{\textbackslash inslogo};
- \item[\texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo}] sono il percorso (relativo o assoluto) dell'immagine che verrà utilizzata come logo a seconda delle opzioni scelte (default per tutti e tre è il percorso relativo \texttt{logo});
+ \item[\texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo}] sono il percorso (relativo o assoluto) dell'immagine che verrà utilizzata come logo a seconda delle opzioni scelte (default per \texttt{\textbackslash logo} è il percorso relativo \texttt{logo}, default per gli altri è \texttt{\textbackslash logo});
  \item[\texttt{\textbackslash setlogo\{\textit{<percorso>}\}}, \texttt{\textbackslash setleftlogo\{\textit{<percorso>}\}}, \texttt{\textbackslash setrightlogo\{\textit{<percorso>}\}}] settano a \texttt{\textit{<percorso>}} il contenuto di \texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo};
  \item[\texttt{\textbackslash titlingpagemiddle}] è il testo che verrà posizionato a metà della \emph{titling page};
  \item[\texttt{\textbackslash settitlingpagemiddle}] setta il testo in \texttt{\textbackslash titlingpagemiddle};
@@ -169,7 +179,8 @@ Le varie opzioni permettono di variare il posizionamento del logo; per ciascuna
 
 \subsection{Ambienti}
 \begin{description}
- \item[\texttt{dimst}] è un ambiente in cui il testo è in \texttt{slshape} e con il margine sinistro maggiorato di 1 cm.
+ \item[\texttt{abstract}] è un ambiente di larghezza \texttt{0.9\textbackslash textwidth}, con un parametro \texttt{\textit{<titolo>}} che verrà scritto in grassetto prima del testo contenuto nell'ambiente;
+\item[\texttt{dimst}] è un ambiente in cui il testo è in \texttt{slshape} e con il margine sinistro maggiorato di 1 cm.
 \end{description}
 
 \section{Contatti}