From 59fe7990216c0d13eb0e9797c7dc563d2f1705b5 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 31 Aug 2016 22:47:47 +0000 Subject: jslectureplanner (31aug16) git-svn-id: svn://tug.org/texlive/trunk@41965 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/jslectureplanner/README | 12 ++++ .../latex/jslectureplanner/examples/lecturebib.pdf | Bin 85429 -> 85429 bytes .../jslectureplanner/examples/lecturehandout.pdf | Bin 59145 -> 59148 bytes .../examples/lecturepresentation.pdf | Bin 84929 -> 84910 bytes .../jslectureplanner/examples/lectureprogram.pdf | Bin 57878 -> 57884 bytes .../jslectureplanner/examples/lecturescript.pdf | Bin 34743 -> 34739 bytes .../examples/membertable-blank.pdf | Bin 28387 -> 28387 bytes .../examples/membertable-filled.pdf | Bin 28510 -> 28510 bytes .../latex/jslectureplanner/examples/metadata.tex | 2 +- .../examples/presencetable-blank.pdf | Bin 27895 -> 27892 bytes .../examples/presencetable-filled.pdf | Bin 26783 -> 26781 bytes .../examples/presentation-list.pdf | Bin 26860 -> 26863 bytes .../latex/jslectureplanner/jslectureplanner.pdf | Bin 411102 -> 423352 bytes .../latex/jslectureplanner/jslectureplanner.tex | 62 +++++++++++++++------ 14 files changed, 58 insertions(+), 18 deletions(-) (limited to 'Master/texmf-dist/doc/latex/jslectureplanner') diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/README b/Master/texmf-dist/doc/latex/jslectureplanner/README index 383dff87d67..8980f594662 100644 --- a/Master/texmf-dist/doc/latex/jslectureplanner/README +++ b/Master/texmf-dist/doc/latex/jslectureplanner/README @@ -68,6 +68,18 @@ instructions; also have a look at the example files. == CHANGES == +* V. 1.3 (2016-08-31): - BACKWARDS-INCOMPATIBLE CHANGE! Use datetime2 instead of datetime + and advdate. This changes the interface to set the lecture date + format. Please refer to the documentation for details. + + - Fix output of \SetBreaks when no span argument is given. + + - Protect content of some \Lec* macros and options to allow for + commas in titles etc. + + - Small microtypographic improvement in default definition of + the lecture date format. + * V. 1.2 (2016-05-11): - Fix line breaking with empty session titles before course breaks. diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturebib.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturebib.pdf index 881825f0ab5..26765829e96 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturebib.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturebib.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturehandout.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturehandout.pdf index 7609df557a2..ee534d78a16 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturehandout.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturehandout.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturepresentation.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturepresentation.pdf index fcb56eab53a..b2195a77512 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturepresentation.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturepresentation.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lectureprogram.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lectureprogram.pdf index 6864d09252b..2ae19d6d76f 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lectureprogram.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lectureprogram.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturescript.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturescript.pdf index 90bfce18646..f63e9d3c2ca 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturescript.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/lecturescript.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-blank.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-blank.pdf index 264b28c0682..9fb8a7e0970 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-blank.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-blank.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-filled.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-filled.pdf index b7d0d7d146f..90006339dc5 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-filled.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/membertable-filled.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/metadata.tex b/Master/texmf-dist/doc/latex/jslectureplanner/examples/metadata.tex index 8f8f5f87026..f43eb5fdd70 100644 --- a/Master/texmf-dist/doc/latex/jslectureplanner/examples/metadata.tex +++ b/Master/texmf-dist/doc/latex/jslectureplanner/examples/metadata.tex @@ -59,7 +59,7 @@ \end{SessionBlock} % a semester break of two weeks -\SetBreaks[units=2,span={10.\,--\,23.\,06.}]{Pfingstferien} +\SetBreaks[units=2,span={25.\,05.\,--\,06.\,06.}]{Pfingstferien} % start a new frame in beamer \SetBeamerFrameBreak diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-blank.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-blank.pdf index f135163bd15..83fae9336e8 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-blank.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-blank.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-filled.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-filled.pdf index 43527dd2093..dcb6f3244ee 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-filled.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/presencetable-filled.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/examples/presentation-list.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/examples/presentation-list.pdf index 258ec5a8f5d..c98132035bd 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/examples/presentation-list.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/examples/presentation-list.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.pdf b/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.pdf index 1cba14c7e62..32dee2cbab3 100644 Binary files a/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.pdf and b/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.pdf differ diff --git a/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.tex b/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.tex index c07e23a32c2..200bb441ebc 100644 --- a/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.tex +++ b/Master/texmf-dist/doc/latex/jslectureplanner/jslectureplanner.tex @@ -69,7 +69,7 @@ \author{Jürgen Spitzmüller% \thanks{Please report issues via \protect\url{https://github.com/jspitz/jslectureplanner}.}} -\date{Version 1.2, 2016/05/11} +\date{Version 1.3, 2016/08/31} \maketitle @@ -129,14 +129,13 @@ This is described later in this manual. The following packages are required and loaded by \jslp: \begin{itemize} \setlength\itemsep{2pt} - \item \textsf{advdate} \item \textsf{calc} - \item \textsf{datetime} + \item \textsf{datetime2} \item \textsf{etoolbox} \item \textsf{ifthen} \item \textsf{xkeyval} \end{itemize} - +\pagebreak \section{General idea} @@ -713,20 +712,40 @@ Thus, you could add a new term type ``spring term'' via \item \jcsmacro{DefSemType\{st\}\{ST\}\{Spring Term\}} \end{itemize} -\subsection{Customizing the date format} +\subsection{Customizing the date format}\label{sec:custdate} -If you need to change the date format, redefine the macros \jcsmacro{lecdateformat} -(for the long format) and \jcsmacro{lecdateshortformat} -(for the short format), using the syntax provided by the \textsf{datetime} +If you need to change the date format, redefine the date styles \textsf{lecdate} +(for the long format) and \textsf{lecshortdate} (for the short format), +using the syntax provided by the \textsf{datetime2} package. By default, the two formats are defined as follows: -\begin{lstlisting}[language={[LaTeX]TeX},basicstyle={\small\ttfamily},frame=single] -\newcommand*\lecdateformat{% - \THEDAY.\,\twodigit{\THEMONTH}.\,\THEYEAR} -\newcommand*\lecdateshortformat{% - \THEDAY.\,\twodigit{\THEMONTH}.} +\begin{lstlisting}[language={[LaTeX]TeX},basicstyle={\small\ttfamily},frame=single,moretexcs={[1]{DTMnewdatestyle}}] +\DTMnewdatestyle{lecdate}{% long date: DD.\,MM.~YYYY +\renewcommand*{\DTMdisplaydate}[4]{\DTMtwodigits{##3}.\,\DTMtwodigits{##2}.~##1}% +\renewcommand*{\DTMDisplaydate}{\DTMdisplaydate}% +} + +\DTMnewdatestyle{lecshortdate}{% short date: DD.\,MM. +\renewcommand*{\DTMdisplaydate}[4]{\DTMtwodigits{##3}.\,\DTMtwodigits{##2}.}% +\renewcommand*{\DTMDisplaydate}{\DTMdisplaydate}% +} +\end{lstlisting} +\jfcsmacro{DTMtwodigits\{\#\#3\}} represents the day of the month (producing always two digits, i.\,e., \emph{01} not \emph{1}), \jfcsmacro{DTMtwodigits\{\#\#2\}} represents the month (also in two-digit form) and \jfmacro{\#\#1} represents the year. Please refer to the \textsf{datetime2} manual for details. + +If you want to redefine the styles, use \jfcsmacro{DTMrenewdatestyle} and change the definition accordingly. For instance, to get the typical American English date formats \emph{MM/DD/YYYY} and \emph{Month, DD}, redefine the formats as follows: + +\begin{lstlisting}[language={[LaTeX]TeX},basicstyle={\small\ttfamily},frame=single,moretexcs={[1]{DTMrenewdatestyle}}] +\DTMrenewdatestyle{lecdate}{% long date: MM/DD/YYYY +\renewcommand*{\DTMdisplaydate}[4]{\DTMtwodigits{##2}/\DTMtwodigits{##3}/##1}% +} + +\DTMrenewdatestyle{lecshortdate}{% short date: Month, DD +\renewcommand*{\DTMdisplaydate}[4]{\DTMenglishmonthname{##2}, ##3}% +} \end{lstlisting} -Use \jfcsmacro{renewcommand*} to redefine them. +Note that it is not necessary to include the \jfcsmacro{DTMDisplaydate} redefinition in the date format redefinition (since it does never change here). Note further that the macro \jfcsmacro{DTMenglishmonthname} used in the short date redefinition requires the \textsf{datetime2-english} module to be loaded (see \textsf{datetime2} manual for details). + +Note, finally, that the date redefinition syntax used up to \jslp\ 1.2 is no longer supported, since it relied on the \textsf{datetime} package, which is deprecated (and superseded by \textsf{datetime2}). The \jslp\ package will issue a warning if you try to use the old syntax. \subsection{Misc. customizing} @@ -749,7 +768,7 @@ The indentation used in program lists can be changed by redefining \begin{lstlisting}[language={[LaTeX]TeX},basicstyle={\small\ttfamily},frame=single] \newcommand*\lecprogramlistindent{\textbf{88.\,88.}} \end{lstlisting} -Again, use \jfcsmacro{renewcommand{*}} for the redefinitions. +Use \jfcsmacro{renewcommand{*}} for the redefinitions. \subsection{Using styles}\label{sec:styles} @@ -1002,6 +1021,15 @@ the \jslp\ style files. Thanks, Dominik. \section{Release History} \begin{itemize} +\item 2016/08/31 (v. 1.3): + \begin{itemize} + \item \textbf{Backwards-incompatible change!} Use \textsf{datetime2} instead of \textsf{datetime} and \textsf{advdate}. + This changes the interface to set the lecture date format. See sec.~\ref{sec:custdate}. + \item Fix output of \jcsmacro{SetBreaks} when no \joption{span} argument is given. + \item Protect content of some \jcsmacro{Lec}* macros and options to allow for commas in + titles etc. + \item Microtypographic improvement in default definition of the lecture date format. + \end{itemize} \item 2016/05/11 (v. 1.2): \begin{itemize} \item Fix line breaking with empty session titles before course breaks. @@ -1013,7 +1041,7 @@ the \jslp\ style files. Thanks, Dominik. \item \jcsmacro{AdjSessionTitle} \item \jcsmacro{AdjSessionShortDate} \item \jcsmacro{AdjSessionRoom} - \item \jcsmacro{AdjSessionInstructor} + \item \jcsmacro{AdjSessionInstructor}\enlargethispage{\baselineskip} \item \jcsmacro{AdjSessionPresStudents} \end{itemize} \end{itemize} @@ -1025,7 +1053,7 @@ the \jslp\ style files. Thanks, Dominik. \jcsmacro{makebeamerpreslist}, \jcsmacro{setfirstpressession} and \jcsmacro{setlastpressession}. \item Major revision of the manual. - \end{itemize}\filbreak + \end{itemize} \item 2015/07/07 (v. 1.0.2): \begin{itemize} \item Permit \jcsmacro{LecType} and \jcsmacro{LecYear} in the document body again -- cgit v1.2.3