cleanup and docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>

photobook.cls

@@ -712,11 +712,8 @@
 %
 %% Sets fold marker size (vertical).
 %%
-% XXX this behaves in an odd way on bottom markers if size is smaller than 6mm...
-% XXX rename if we are using sboxes for marks...
 \newlength\photobook@foldmarklen
 \setlength\photobook@foldmarklen{\photobook@foldmarksize}
-%\setlength\foldmarksize{6mm}
 
 %% \DescribeMacro{\iffoldmarks}
 %
@@ -2887,6 +2884,14 @@
 \@ifundefined{pagefoldpanelfolds}{%
 	\def\pagefoldpanelfolds{}}{}
 
+%% \DescribeMacro{\foldoutwidth=<len>}
+%
+%% Total foldout page width, calculated when a foldout page is created.
+%%
+\newlength\foldoutwidth
+\setlength\foldoutwidth{\blockwidth}
+
+
 %% \DescribeEnv{foldout}
 %
 %% Create 2 or more pages in foldout mode.
@@ -3038,9 +3043,9 @@
 %%
 %% The size of the paper fold is set by |\flatfold|.
 %%
-% XXX move these to globals...
+
-\newlength\foldoutwidth
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-\setlength\foldoutwidth{\blockwidth}
+% Fold marks...
 
 % draw in/out fold mark...
 %
@@ -3051,17 +3056,15 @@
 % NOTE: these are centered in origin.
 %
 % XXX these can affect the items after -- need to encapsulate better + test...
-% XXX something's odd with these -- when \foldmarksize is <6mm the bottom 
-%		fold mark gets messed up...
 % XXX do we need to make centering block size dependant on \foldmarksize 
 %		or are the two independent??? (test)
-% XXX doc: \ResetFoldMarks...
+% XXX MARKOFFSET for some reason splitting the \vspace{..} into a 
-% XXX doc...
+%		arg-dependant and a foldmarklen-dependant parts below yields 
-
+%		wrong results...
-% XXX rename \foldmarksize if we stick with boxes...
+%		...not that simply splitting the original into two \vspace{..} 
+%		calls works fine...
 \newsavebox\photobook@foldinmark
 \newsavebox\photobook@foldoutmark
-
 \newcommand\ResetFoldMarks{%
 	\sbox{\photobook@foldinmark}{%
 		% XXX MARKOFFSET
@@ -3110,23 +3113,21 @@
 \ResetFoldMarks
 
 % XXX EXPERIMENTAL...
-%		...if used, make \foldmarksize private... 
+% XXX not sure if this should ever be needed...
-\newcommand\setfoldmarksize[1][6mm]{%
+%\newcommand\setfoldmarksize[1][6mm]{%
-	\setlength\photobook@foldmarklen{#1}%
+%	\setlength\photobook@foldmarklen{#1}%
-	%\edef\photobook@foldmarklen{#1}%
+%	%\edef\photobook@foldmarklen{#1}%
-	\ResetFoldMarks}
+%	\ResetFoldMarks}
 
 %	>> \foldinmark[<baseline>]
 \newcommand\foldinmark[1][0pt]{%
-	% XXX MARKOFFSET for some reason splitting this (#1 kept here while \foldmarksize 
+	% XXX MARKOFFSET
-	%		is in fold*mark) breaks alignment...
 	%\vspace{#1}%
 	\vspace{\dimexpr 0.5\photobook@foldmarklen + #1 \relax}%
 	\usebox\photobook@foldinmark}
 %	>> \foldoutmark[<baseline>]
 \newcommand\foldoutmark[1][0pt]{
-	% XXX MARKOFFSET for some reason splitting this (#1 kept here while \foldmarksize 
+	% XXX MARKOFFSET 
-	%		is in fold*mark) breaks alignment...
 	%\vspace{#1}%
 	\vspace{\dimexpr 0.5\photobook@foldmarklen + #1 \relax}%
 	\usebox\photobook@foldoutmark}
@@ -3165,6 +3166,8 @@
 			+ \bleed 
 			+ \foldmarkoffset}}
 
+% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+
 \newlength\photobook@foldout@panelwidth
 \setlength\photobook@foldout@panelwidth{0pt}
 \newlength\photobook@foldout@maxpanelwidth