texlive[73399] Master/texmf-dist: fillpages (11jan25)
commits+karl at tug.org
commits+karl at tug.org
Sat Jan 11 00:03:51 CET 2025
Revision: 73399
https://tug.org/svn/texlive?view=revision&revision=73399
Author: karl
Date: 2025-01-11 00:03:51 +0100 (Sat, 11 Jan 2025)
Log Message:
-----------
fillpages (11jan25)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/fillpages/README.md
trunk/Master/texmf-dist/doc/latex/fillpages/fillpages-documentation.pdf
trunk/Master/texmf-dist/doc/latex/fillpages/fillpages-documentation.tex
trunk/Master/texmf-dist/tex/latex/fillpages/fillpages.sty
Modified: trunk/Master/texmf-dist/doc/latex/fillpages/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fillpages/README.md 2025-01-10 23:03:42 UTC (rev 73398)
+++ trunk/Master/texmf-dist/doc/latex/fillpages/README.md 2025-01-10 23:03:51 UTC (rev 73399)
@@ -11,6 +11,6 @@
# license, version, author
This work is published under the LaTeX project public license 1.3.
-2025-01-07: version 1.0.0
+2025-01-10: version 1.0.1
-Created by Gabriel Ruprecht.
\ No newline at end of file
+Created by Gabriel Ruprecht.
Modified: trunk/Master/texmf-dist/doc/latex/fillpages/fillpages-documentation.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/fillpages/fillpages-documentation.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fillpages/fillpages-documentation.tex 2025-01-10 23:03:42 UTC (rev 73398)
+++ trunk/Master/texmf-dist/doc/latex/fillpages/fillpages-documentation.tex 2025-01-10 23:03:51 UTC (rev 73399)
@@ -5,8 +5,8 @@
% This work is published under the %
% LaTeX project public license 1.3 %
% %
-% Package version 1.0.0 %
-% 2025-01-07 %
+% Package version 1.0.1 %
+% 2025-01-10 %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass[11pt,a4paper]{scrartcl}
@@ -36,7 +36,7 @@
\def\FillPagesS{\hspace*{3pt}\includegraphics[height=\f at size pt]{./GFM-FP-LogoS}\hspace*{3pt}}
\makeatother
\title{Fill\FillPagesS Pages\FillPagesS Package\vskip 9pt\relax}
-\subtitle{Version 1.0.0}
+\subtitle{Version 1.0.1}
\author{Gabriel Ruprecht}
@@ -44,7 +44,7 @@
\maketitle
\section{Introduction}
\subsection{About}
-The \textsf{Fill\FillPagesS Pages\FillPagesS Package} can be used, if you create a book, booklet or similar. In these cases you often print something, where your page count must be dividable by 4, 8 or 16. This package fills your document with the needed pages. By default, they are blank, but they may also have a pre-defined content. If you use this package, you have to compile at least two times. The first run counts the pages and inserting positions. This information is then used in the second run, to calculate the number of pages to be inserted.
+The \textsf{Fill\FillPagesS Pages\FillPagesS Package} can be used, if you create a book, booklet or similar. In these cases you often print something, where your page count must be divisible by 4, 8 or 16. This package fills your document with the needed pages. By default, they are blank, but they may also have a pre-defined content. If you use this package, you have to compile at least two times. The first run counts the pages and inserting positions. This information is then used in the second run, to calculate the number of pages to be inserted.
\subsection{License}
This package is subject to the LaTeX Project Public License 1.3. You may do whatever you want with. If you change the package and redistribute it, please keep the credits.
@@ -60,8 +60,8 @@
\usepackage{fillpages}
-\pagesDividableBy{4}
-%\pagesDividableBy{4}[2] % with optional offset
+\pagesDivisibleBy{4}
+%\pagesDivisibleBy{4}[2] % with optional offset
\setFillPage{2}{
ABC
@@ -103,7 +103,7 @@
\noindent\verb&\insertFillPages&\\ This command must be placed at the points, where insertion is allowed (insertion points). This can be done at multiple points. The total number of pages to be inserted is divided by the number of insertion points. If there are three insertion points and five pages will be inserted, the insertion will be \verb#1 1 2#. Previous to every \verb+\inserFillPages+ there should be a \verb+\clearpage+. Otherwise the page count will be miscalculated and might toggle.
-\noindent\verb&\pagesDividableBy{number}[offset]&\\ This defines the number the page number must be dividable by (default~=~4). If \verb+number+ is 4 and page count is 13, 3 pages will be inserted~(4*4=16; 13+3=16). If \verb+number+ is~4 and \verb+offset+ is 2, the same example will lead to 1 inserted page (3*4=12; 12+2=14; 13+1=14). You can make the page numbers also dividable by 5 with an offset of 3. There is no limitation. The result will always be the minimal number of inserted pages. Dividable by 4, offset 1 has the same result as dividable by 4, offset 5.
+\noindent\verb&\pagesDivisibleBy{number}[offset]&\\ This defines the number the page number must be divisible by (default~=~4). If \verb+number+ is 4 and page count is 13, 3 pages will be inserted~(4*4=16; 13+3=16). If \verb+number+ is~4 and \verb+offset+ is 2, the same example will lead to 1 inserted page (3*4=12; 12+2=14; 13+1=14). You can make the page numbers also divisible by 5 with an offset of 3. There is no limitation. The result will always be the minimal number of inserted pages. Divisible by 4, offset 1 has the same result as divisible by 4, offset 5.
\noindent\verb&\setFillPage{pagenumber}{content}&\\
This creates a custom page, which will be used, if needed. By default all inserted pages are white, but if they shouldn't be white, you can define a content. I.e.
@@ -126,7 +126,7 @@
\item Second run:
\begin{enumerate}
\item Calculate the number of total pages without the fill pages, that were inserted.
-\item Do a modulo division on this page count by target divisor (offset must be considered). It is actually not a modulo operation, but this is the principle behind it. Page count is 15, must be dividable by 4 (offset 0), 15\%4=3 $\rightarrow$ 1 page too less.
+\item Do a modulo division on this page count by target divisor (offset must be considered). It is actually not a modulo operation, but this is the principle behind it. Page count is 15, must be divisible by 4 (offset 0), 15\%4=3 $\rightarrow$ 1 page too less.
\item This number of pages to be inserted is distributed across all insertion points.\\Example 1: 3 insertion points and 3 pages, each gets one page.\\Example 2: 3 insertion points and 4 pages, first two get one page, third one gets two pages. This is done by the total limit. At the first point total limit is 1.33 $\rightarrow$ 1 inserted. At the second point, limit is 2.66, 1 already inserted $\rightarrow$ insert 1. At the third insertion point the total limit is 4, 2 already inserted $\rightarrow$ insert 2.
\end{enumerate}
\end{enumerate}
@@ -146,7 +146,7 @@
\section{Known problems}
\subsection{Page number toggles}
-If you have i.e. 10 pages and define dividable by 4, it should be 12 pages, which makes 2 fill pages. If the page number toggles between 11 and 13 every two runs, there are two possible reasons:
+If you have i.e. 10 pages and define divisible by 4, it should be 12 pages, which makes 2 fill pages. If the page number toggles between 11 and 13 every two runs, there are two possible reasons:
\begin{enumerate}
\item You didn't put a clearpage before the \verb+\insertFillPages+
\item You defined a custom fill page which is bigger than one page and will result in two fill pages, though one should be inserted
@@ -164,7 +164,8 @@
\noindent
\begin{tabular}{l l}
2017/11/01:& version 0.1.0\\
-2025/01/07:& version 1.0.0
+2025/01/07:& version 1.0.0\\
+2025/01/10:& version 1.0.1
\end{tabular}
Modified: trunk/Master/texmf-dist/tex/latex/fillpages/fillpages.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/fillpages/fillpages.sty 2025-01-10 23:03:42 UTC (rev 73398)
+++ trunk/Master/texmf-dist/tex/latex/fillpages/fillpages.sty 2025-01-10 23:03:51 UTC (rev 73399)
@@ -5,11 +5,11 @@
% This work is published under the %
% LaTeX project public license 1.3 %
% %
-% Package version 1.0.0 %
-% 2025-01-07 %
+% Package version 1.0.1 %
+% 2025-01-10 %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\ProvidesPackage{fillpages}[version 1.0.0]
+\ProvidesPackage{fillpages}[version 1.0.1]
%%%%%%%%%%%%%%%%%%%%%%%%%%
%%% Number definitions %%%
@@ -47,23 +47,23 @@
\GFM at FiPa@currentLimit=0pt\relax
% The number, by which the page number must be
-% dividable.
+% divisible.
\newcount\GFM at FiPa@Divisor\relax
\GFM at FiPa@Divisor=4\relax
-% An offset, if the numbers must be i.e. dividable
+% An offset, if the numbers must be i.e. divisible
% by 4 and have 2 extra pages.
-\newcount\GFM at FiPa@DivideableOffset\relax
-\GFM at FiPa@DivideableOffset=0\relax
+\newcount\GFM at FiPa@DivisibleOffset\relax
+\GFM at FiPa@DivisibleOffset=0\relax
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%% Set the number by which the %%%
-%%% page count must be dividable %%%
+%%% page count must be divisible %%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\NewDocumentCommand\pagesDividableBy{m O{0}}{%
+\NewDocumentCommand\pagesDivisibleBy{m O{0}}{%
\GFM at FiPa@Divisor=#1\relax%
\ifnum\GFM at FiPa@Divisor<1\relax%
\PackageError{fillpages.sty}{line 31: Illegal number}{You can't divide a page count by zero. Replaced with 1.}%
@@ -70,9 +70,9 @@
\GFM at FiPa@Divisor=1\relax%
\fi%
\ifnum\GFM at FiPa@Divisor>50\relax%
- \PackageWarning{fillpages.sty}{Strange number. You want your pages dividable by a number greater than 50}%
+ \PackageWarning{fillpages.sty}{Strange number. You want your pages divisible by a number greater than 50}%
\fi%
-\GFM at FiPa@DivideableOffset=#2\relax%
+\GFM at FiPa@DivisibleOffset=#2\relax%
}
@@ -109,7 +109,7 @@
\GFM at FiPa@numberOfInsertedPages=0\relax
\GFM at FiPa@pagesPerFillPosition=\the\GFM at FiPa@pageCountWithoutFillPages pt\relax
-\advance\GFM at FiPa@pagesPerFillPosition by -\GFM at FiPa@DivideableOffset pt\relax
+\advance\GFM at FiPa@pagesPerFillPosition by -\GFM at FiPa@DivisibleOffset pt\relax
\ifdim\GFM at FiPa@pagesPerFillPosition>0 pt%
\loop%
More information about the tex-live-commits
mailing list.