texlive[68313] Master/texmf-dist: photobook (18sep23)

[commits+karl at tug.org]

Revision: 68313
          https://tug.org/svn/texlive?view=revision&revision=68313
Author:   karl
Date:     2023-09-18 22:06:44 +0200 (Mon, 18 Sep 2023)
Log Message:
-----------
photobook (18sep23)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/photobook/README.md
    trunk/Master/texmf-dist/doc/latex/photobook/photobook.pdf
    trunk/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh
    trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls

Modified: trunk/Master/texmf-dist/doc/latex/photobook/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/photobook/README.md	2023-09-18 20:06:32 UTC (rev 68312)
+++ trunk/Master/texmf-dist/doc/latex/photobook/README.md	2023-09-18 20:06:44 UTC (rev 68313)
@@ -12,7 +12,7 @@
 ## Install / Build
 
 The simplest way to install is to use either 
-[TeX Live](https://www.tug.org/texlive/)'s or [MiLTeX](https://miktex.org/)'s 
+[TeX Live](https://www.tug.org/texlive/)'s or [MiKTeX](https://miktex.org/)'s 
 standard way to install modules.
 
 
@@ -40,8 +40,17 @@
 # Documentation
 
 Pre-built documentation can be found on 
-[CTAN](http://mirrors.ctan.org/macros/latex/contrib/photobook/photobook.pdf)
-or it can be built from source by:
+[CTAN](http://mirrors.ctan.org/macros/latex/contrib/photobook/photobook.pdf).
+
+
+A full book (dummy) example is included in [./examples/book/](./examples/book/) 
+and can be used as a reference / starting point.
+
+
+
+## Building documentation
+
+Building the reference from source is done by:
 ```shell
 $ make pdf 
 ```

Modified: trunk/Master/texmf-dist/doc/latex/photobook/photobook.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh
===================================================================
--- trunk/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh	2023-09-18 20:06:32 UTC (rev 68312)
+++ trunk/Master/texmf-dist/doc/latex/photobook/scripts/make-spreads.sh	2023-09-18 20:06:44 UTC (rev 68313)
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 shopt -s nullglob extglob
 
 #----------------------------------------------------------------------

Modified: trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls
===================================================================
--- trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls	2023-09-18 20:06:32 UTC (rev 68312)
+++ trunk/Master/texmf-dist/tex/latex/photobook/photobook.cls	2023-09-18 20:06:44 UTC (rev 68313)
@@ -38,7 +38,7 @@
 %
 % - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 %
-% XXX ASAP: imagecell: photobook at imagecell@left and photobook at imagecell@left
+% XXX ASAP: imagecell: photobook at imagecell@left and photobook at imagecell@top
 %		should explicitly account for clearence at left and clearence at top resp.
 % XXX ASAP: imagecell: clearance should have the same semantics as cliptocell 
 %		offsts... 
@@ -45,7 +45,6 @@
 %		(CLEARANCE)
 % XXX ASAP should cover/jacket/endpaper/spread cells set default cliptocell 
 %		bleeds???
-%		...needs testing and experimenting...
 % XXX ASAP: should \blockwidth include \bindingoffset (current) or not???
 %		...currently I think that no, as \blockwidth indicates the outer 
 %		width of the block, and this poses the question:
@@ -93,7 +92,7 @@
 
 %%% NOTE: \def\<module-name>@[A-Z]+ macros will be visible to both the 
 %%%		code and the generated docs...
-\edef\photobook at FILEVERSION{v0.1.28}
+\edef\photobook at FILEVERSION{v0.1.29}
 \edef\photobook at FILEDATE{2023-08-24}
 
 
@@ -2108,7 +2107,6 @@
 		{-\the\photobook at cliptocell@right} %
 		{-\the\photobook at cliptocell@top}}}
 
-% XXX use \cliptocellclearances as default...
 \newenvironment{cliptocell}[1][0mm]{%
 	\begingroup%
 		\setcliptocellbleeds{#1}
@@ -2220,7 +2218,9 @@
 %% Image |clearance|. This sets the amount of clearance around an image 
 %% (default: |0pt|).
 %%
-%%	>> \imagecell[clearance=-4mm]{}{<image>}
+%%	>> \imagecell[clearance=<size>]{}{<image>}
+%%	>> \imagecell[clearance=<horizontal> <vertical>]{}{<image>}
+%%	>> \imagecell[clearance=<left> <bottom> <top> <right>]{}{<image>}
 %%
 %% \begin{minipage}{\textwidth}
 %% \begin{verbatim}
@@ -4033,9 +4033,9 @@
 %%%%% Endpaper cells
 %
 %% \DescribeEnv{leftside}
-%%% \DescribeEnv{leftside*}
+%% \DescribeEnv{leftside*}
 %% \DescribeEnv{rightside}
-%%% \DescribeEnv{rightside*}
+%% \DescribeEnv{rightside*}
 %
 %% \begin{minipage}{\textwidth}
 %% \begin{verbatim}
@@ -4051,41 +4051,42 @@
 %% \end{verbatim}
 %% \end{minipage}
 %%
-%%% The star versions set the appropriate bleeds for cliptocell.
-%%%
+%% The non-star versions will clip to bleeds except for the gutter side 
+%% that has no bleeds.
+%%
+%% The star versions will not clip.
+%%
 
 % XXX for some reason naming these anything starting with endpaper will
 %		make LaTeX complain that that is already defined...
 %		...collision with bools???
-\newenvironment{leftside}{%
+\newenvironment{leftside*}{%
 	\begin{cell*}%
 			{\bleed, \bleed}%
 			{\pageblockwidth}{\pageblockheight}%
 }{%
 	\end{cell*}}
-% XXX EXPERIMENTAL
-\newenvironment{leftside*}{%
-	\begin{leftside}%
+\newenvironment{leftside}{%
+	\begin{leftside*}%
 	\begin{cliptocell}[{\bleed} {\bleed} 0mm {\bleed}]%
-	\setcliptocellbleeds{{\bleed} {\bleed} 0mm {\bleed}}%
+		\setcliptocellbleeds{{\bleed} {\bleed} 0mm {\bleed}}%
 }{%
 	\end{cliptocell}
-	\end{leftside}}
+	\end{leftside*}}
 
-\newenvironment{rightside}{%
+\newenvironment{rightside*}{%
 	\begin{cell*}%
 			{\bleed + \pageblockwidth, \bleed}%
 			{\pageblockwidth}{\pageblockheight}%
 }{%
 	\end{cell*}}
-% XXX EXPERIMENTAL
-\newenvironment{rightside*}{%
-	\begin{rightside}%
+\newenvironment{rightside}{%
+	\begin{rightside*}%
 	\begin{cliptocell}[0mm {\bleed} {\bleed} {\bleed}]%
-	\setcliptocellbleeds{0mm {\bleed} {\bleed} {\bleed}}%
+		\setcliptocellbleeds{0mm {\bleed} {\bleed} {\bleed}}%
 }{%
 	\end{cliptocell}
-	\end{rightside}}
+	\end{rightside*}}