summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/hvfloat
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/hvfloat
Initial commit
Diffstat (limited to 'macros/latex/contrib/hvfloat')
-rw-r--r--macros/latex/contrib/hvfloat/Changes30
-rw-r--r--macros/latex/contrib/hvfloat/README18
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/README.exa25
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/after1s1c.pdfbin0 -> 87302 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/after1s1c.tex76
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/after2s2c.pdfbin0 -> 93142 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/after2s2c.tex80
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default1s1c.pdfbin0 -> 88012 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default1s1c.tex78
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default1s2c.pdfbin0 -> 88328 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default1s2c.tex68
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default2s1c.pdfbin0 -> 88184 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default2s1c.tex73
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default2s2c.pdfbin0 -> 91542 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/default2s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even1s1c.pdfbin0 -> 83762 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even1s1c.tex72
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even1s2c.pdfbin0 -> 91719 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even1s2c.tex79
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even2s1c.pdfbin0 -> 91681 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even2s1c.tex80
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even2s2c.pdfbin0 -> 91234 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/even2s2c.tex80
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.pdfbin0 -> 91736 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.tex64
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/inner1s2c.pdfbin0 -> 90740 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/inner1s2c.tex77
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/inner2s1c.pdfbin0 -> 90738 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/inner2s1c.tex76
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/inner2s2c.pdfbin0 -> 90034 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/inner2s2c.tex77
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/left2s2c.pdfbin0 -> 91294 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/left2s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.pdfbin0 -> 151473 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.tex147
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.pdfbin0 -> 151360 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.tex148
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.pdfbin0 -> 99838 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.tex138
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.pdfbin0 -> 152818 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.tex147
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.pdfbin0 -> 98240 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.tex138
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.pdfbin0 -> 99167 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.tex148
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.pdfbin0 -> 101578 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.tex146
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.pdfbin0 -> 150853 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.tex147
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd1s1c.pdfbin0 -> 85682 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd1s1c.tex74
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd1s2c.pdfbin0 -> 92599 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd1s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd2s1c.pdfbin0 -> 91057 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd2s1c.tex80
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd2s2c.pdfbin0 -> 92727 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/odd2s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/outer1s2c.pdfbin0 -> 91491 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/outer1s2c.tex76
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/outer2s1c.pdfbin0 -> 91066 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/outer2s1c.tex76
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/outer2s2c.pdfbin0 -> 90681 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/outer2s2c.tex76
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.pdfbin0 -> 85528 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.tex82
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.pdfbin0 -> 86261 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.tex82
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.pdfbin0 -> 95490 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.pdfbin0 -> 95312 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.pdfbin0 -> 93716 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.pdfbin0 -> 85996 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.tex82
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/preamble.ltx44
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right1s1c.pdfbin0 -> 87117 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right1s1c.tex76
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right1s2c.pdfbin0 -> 94212 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right1s2c.tex81
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right2s1c.pdfbin0 -> 86973 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right2s1c.tex74
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right2s2c.pdfbin0 -> 92840 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/right2s2c.tex80
-rwxr-xr-xmacros/latex/contrib/hvfloat/doc/examples/runAll.sh20
-rwxr-xr-xmacros/latex/contrib/hvfloat/doc/examples/runEXA.sh20
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.pdfbin0 -> 148850 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.tex129
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.pdfbin0 -> 149638 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.tex129
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.pdfbin0 -> 148984 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.tex130
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.pdfbin0 -> 149897 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.tex131
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.pdfbin0 -> 150072 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.tex131
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.pdfbin0 -> 148775 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.tex129
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.pdfbin0 -> 149735 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.tex129
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.pdfbin0 -> 149445 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.tex129
-rw-r--r--macros/latex/contrib/hvfloat/doc/hvfloat.pdfbin0 -> 2941910 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/hvfloat.tex2577
-rw-r--r--macros/latex/contrib/hvfloat/doc/images/CTAN.pngbin0 -> 69089 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/images/frose.pngbin0 -> 5208 bytes
-rw-r--r--macros/latex/contrib/hvfloat/doc/images/rose.pngbin0 -> 2493 bytes
-rw-r--r--macros/latex/contrib/hvfloat/latex/hvfloat-fps.sty30
-rw-r--r--macros/latex/contrib/hvfloat/latex/hvfloat.sty1032
109 files changed, 8478 insertions, 0 deletions
diff --git a/macros/latex/contrib/hvfloat/Changes b/macros/latex/contrib/hvfloat/Changes
new file mode 100644
index 0000000000..d8e8f80e88
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/Changes
@@ -0,0 +1,30 @@
+hvfloat.sty:
+2.16 2019-08-31 - fix for \hvFloat* and full page images
+2.15 2019-05-13 - added optional arguments capFormat and subcapFormat
+ which will pass the key values to \caption or
+ \subcaption from package caption/subcaption
+2.14 2019-05-10 - changed floatCapSep into a dimen
+2.13 2019-04-08 - fix for trailing spaces
+2.12a 2019-04-04 - fix for wrong index
+2.12 2019-04-04 - added option left/right for twocolumn mode
+2.11 2019-03-29 - fix for sub float pages
+ - added examples.zip
+2.10 2019-03-21 - added support for multi float pages
+ - added support for subfloat pages
+2.00 2019-03-14 - added support for wide floats, inner/outer captions,
+ fullpage objects for one- or twocolumn mode.
+1.2b 2017-12-22 - added option all for hvfloat-fps
+1.2a 2017-09-16 - new package for global float setting
+1.2 2017-04-28 - fix bug with caption (no entry in lof)
+1.1 2012-03-04 - added environment hvFloatEnv
+ - don't load package ifthen
+ - load package caption by default
+0.9 2003 - Rotating floating objects and captions in different ways
+
+
+hvfloat.tex: the source of the documentation
+
+
+hvfloat-fps.sty
+0.02 2017-09-20 - small changes
+0.01 2017-09-16 - first CTAN version
diff --git a/macros/latex/contrib/hvfloat/README b/macros/latex/contrib/hvfloat/README
new file mode 100644
index 0000000000..c1f973c24c
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/README
@@ -0,0 +1,18 @@
+hvfloat
+hvfloat-fps (float placement setting)
+
+hvfloat
+Placing figures/tables with various options, like rotating
+the image/table and/or caption. Placing object and caption
+side by side in one- and twocolumn mode. Fullpage objects
+with captions on the preceeding or following page in
+one- and twocolumn mode.
+
+hvfloat-fps
+Simple global placement setting for floats
+
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN archives
+%% in directory macros/latex/base/lppl.txt.
+
+hvoss@tug.org \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/README.exa b/macros/latex/contrib/hvfloat/doc/examples/README.exa
new file mode 100644
index 0000000000..f5c52e2e98
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/README.exa
@@ -0,0 +1,25 @@
+The meaning of a filename like default1s2c.tex is:
+ default: no special setting
+ 1s : oneside mode
+ 2c : twocolumn mode
+
+The meaning of a filename like after2s1c.tex is:
+ after : capPos=after
+ 2s : twoside mode
+ 1c : onecolumn mode
+
+The meaning of a filename like odd1s2c.tex is:
+ odd : capPos=oddPage
+ 1s : oneside mode
+ 2c : twocolumn mode
+
+The meaning of a filename like inner2s2c.tex is:
+ inner : capPos=inner
+ 2s : twoside mode
+ 2c : twocolumn mode
+
+a.s.o.
+
+runEXA.sh <base>
+runs a group of examples, e.g. "./runEXA.sh inner" runs _all_ examples
+started with "inner".
diff --git a/macros/latex/contrib/hvfloat/doc/examples/after1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/after1s1c.pdf
new file mode 100644
index 0000000000..92a7a3e94c
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/after1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/after1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/after1s1c.tex
new file mode 100644
index 0000000000..de0464cc9d
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/after1s1c.tex
@@ -0,0 +1,76 @@
+\documentclass{scrartcl}
+%% $Id: after1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\Blindtext
+
+\Blindtext
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/after2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/after2s2c.pdf
new file mode 100644
index 0000000000..7930998fff
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/after2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/after2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/after2s2c.tex
new file mode 100644
index 0000000000..4e0e17c83a
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/after2s2c.tex
@@ -0,0 +1,80 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: after2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+
+\begin{document}
+
+\tableofcontents
+ ewpage
+
+\blinddocument
+
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext \Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/default1s1c.pdf
new file mode 100644
index 0000000000..69580b7601
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/default1s1c.tex
new file mode 100644
index 0000000000..387ebd6a24
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default1s1c.tex
@@ -0,0 +1,78 @@
+\documentclass{scrartcl}
+%% $Id: default1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+
+\Blindtext
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage1} has a caption~\vpageref{fig:fullpage1-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage1} has a caption~\vpageref{fig:fullpage1-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/default1s2c.pdf
new file mode 100644
index 0000000000..098f2cf9c5
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/default1s2c.tex
new file mode 100644
index 0000000000..a1d9e9d997
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default1s2c.tex
@@ -0,0 +1,68 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: default1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for a star version of hvfloat}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\Blindtext
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+\hvFloat*[capPos=right]{figure}%
+ {\includegraphics{frose}}%
+ [A float with the default caption setting]%
+ {A default caption of a ``default'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:0}
+\end{lstlisting}
+
+\Float[default star]
+\hvFloat*[capPos=right]{figure}%
+ {\includegraphics{frose}}%
+ [A float with the default caption setting]%
+ {A default caption of a ``default'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:0}
+
+\blinddocument
+
+\blindtext
+
+\begin{lstlisting}
+\hvFloat[capPos=right]{figure}%
+ {\includegraphics{frose}}%
+ [A float with the default caption setting]%
+ {A default caption of a ``default'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.}%
+ {fig:1}
+\end{lstlisting}
+
+\Float[default]
+\hvFloat[capPos=right]{figure}%
+ {\includegraphics{frose}}%
+ [A float with the default caption setting]%
+ {A default caption of a ``default'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.}{fig1}
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document}
+
+
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default2s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/default2s1c.pdf
new file mode 100644
index 0000000000..300d92e5aa
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default2s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default2s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/default2s1c.tex
new file mode 100644
index 0000000000..b0935fe53c
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default2s1c.tex
@@ -0,0 +1,73 @@
+\documentclass[twoside]{scrartcl}
+%% $Id: default2s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/default2s2c.pdf
new file mode 100644
index 0000000000..24f6f83ab6
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/default2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/default2s2c.tex
new file mode 100644
index 0000000000..6bd583d8de
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/default2s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: default2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/even1s1c.pdf
new file mode 100644
index 0000000000..11f2859fe9
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/even1s1c.tex
new file mode 100644
index 0000000000..ac29b4782b
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even1s1c.tex
@@ -0,0 +1,72 @@
+\documentclass{scrartcl}
+%% $Id: even1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\Blindtext
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+\Blindtext
+
+\end{document}
+
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/even1s2c.pdf
new file mode 100644
index 0000000000..db6dd0f348
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/even1s2c.tex
new file mode 100644
index 0000000000..aed80a2d3c
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even1s2c.tex
@@ -0,0 +1,79 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: even1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even2s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/even2s1c.pdf
new file mode 100644
index 0000000000..c1a47cdedf
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even2s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even2s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/even2s1c.tex
new file mode 100644
index 0000000000..06a0b3119e
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even2s1c.tex
@@ -0,0 +1,80 @@
+\documentclass[twoside]{scrartcl}
+%% $Id: even2s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/even2s2c.pdf
new file mode 100644
index 0000000000..2a76ef9e65
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/even2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/even2s2c.tex
new file mode 100644
index 0000000000..a35ce24fbc
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/even2s2c.tex
@@ -0,0 +1,80 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: even2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=evenPage]
+\hvFloat[fullpage,capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.pdf
new file mode 100644
index 0000000000..15b69d3f9f
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.tex
new file mode 100644
index 0000000000..cbc25e80bf
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/fullpage1s2c.tex
@@ -0,0 +1,64 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: fullpage1s2c.tex 1072 2019-06-09 14:14:19Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\section{The fullpage optional arguments}
+\Blindtext
+
+\subsection{\texttt{fullpage}}
+\blindtext
+\blindtext
+\verb|\includegraphics[fullpage]{tiger}|
+
+\includegraphics[fullpage]{tiger}
+
+\Blindtext
+\subsection{\texttt{FullPage}}
+\blindtext
+
+\verb|\includegraphics[FullPage]{tiger}|
+\begin{figure*}[p]
+\includegraphics*[FullPage]{tiger}
+\end{figure*}
+
+\Blindtext
+
+\Blindtext
+
+\subsection{\texttt{FULLPAGE}}
+\blindtext
+
+\verb|\includegraphics[FULLPAGE]{tiger}|
+
+\begin{figure*}[p]
+ \vspace*{\the\dimexpr-1in-\voffset+\topskip-\headheight-0.5\baselineskip}%
+ \if@twoside
+ \leavevmode\checkoddpage
+ \ifoddpage
+ \hspace*{\the\dimexpr-\oddsidemargin-\parindent-1in}%
+ \else
+ \hspace*{\the\dimexpr-\evensidemargin-\parindent-1in}%
+ \fi
+ \else
+ \hspace*{\the\dimexpr-\oddsidemargin-\parindent-1in}%
+ \fi
+ \put(0,0){\usebox\hvObjectBox}%
+ \AtBeginShipoutNext{\thispagestyle{empty}}%
+\includegraphics*[FULLPAGE]{tiger}
+\end{figure*}
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/inner1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/inner1s2c.pdf
new file mode 100644
index 0000000000..f90af1abd1
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/inner1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/inner1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/inner1s2c.tex
new file mode 100644
index 0000000000..001d9e824d
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/inner1s2c.tex
@@ -0,0 +1,77 @@
+\documentclass{scrartcl}
+%% $Id: inner1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage0}
+\end{lstlisting}
+
+\Float[capPos=e]
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=e]
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/inner2s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/inner2s1c.pdf
new file mode 100644
index 0000000000..e5487420bc
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/inner2s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/inner2s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/inner2s1c.tex
new file mode 100644
index 0000000000..ec50400c01
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/inner2s1c.tex
@@ -0,0 +1,76 @@
+\documentclass[twoside]{scrartcl}
+%% $Id: inner2s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage0}
+\end{lstlisting}
+
+\Float[capPos=e]
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=e]
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/inner2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/inner2s2c.pdf
new file mode 100644
index 0000000000..da0c2ba44a
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/inner2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/inner2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/inner2s2c.tex
new file mode 100644
index 0000000000..315b04f769
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/inner2s2c.tex
@@ -0,0 +1,77 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: inner2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage0}
+\end{lstlisting}
+
+\Float[capPos=e]
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=e]
+\hvFloat[fullpage, capPos=inner]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the inner side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/left2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/left2s2c.pdf
new file mode 100644
index 0000000000..d4354bfe51
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/left2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/left2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/left2s2c.tex
new file mode 100644
index 0000000000..20f991759a
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/left2s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: left2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=left]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage,capPos=left]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=left]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[fullpage,capPos=left]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.pdf
new file mode 100644
index 0000000000..222eede9be
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.tex
new file mode 100644
index 0000000000..e38ac497ee
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-after1s1c.tex
@@ -0,0 +1,147 @@
+\documentclass{scrartcl}
+%% $Id: multi-after1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=after,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=after,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=after,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=after,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.pdf
new file mode 100644
index 0000000000..1e82b18692
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.tex
new file mode 100644
index 0000000000..11a813f499
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s1c.tex
@@ -0,0 +1,148 @@
+\documentclass{scrartcl}
+%% $Id: multi-default1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.pdf
new file mode 100644
index 0000000000..6d5726c238
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.tex
new file mode 100644
index 0000000000..86d0211eb3
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default1s2c.tex
@@ -0,0 +1,138 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: multi-default1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+
+
+
+
+\blinddocument
+
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.pdf
new file mode 100644
index 0000000000..5a02689ef6
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.tex
new file mode 100644
index 0000000000..3bb4198577
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s1c.tex
@@ -0,0 +1,147 @@
+\documentclass[twoside]{scrartcl}
+%% $Id: multi-default2s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=l,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.pdf
new file mode 100644
index 0000000000..7f2cf31049
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.tex
new file mode 100644
index 0000000000..2508fa7c71
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-default2s2c.tex
@@ -0,0 +1,138 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: multi-default2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+\end{lstlisting}
+
+%\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+
+
+
+
+\blinddocument
+
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+\end{lstlisting}
+
+%\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.pdf
new file mode 100644
index 0000000000..2dd7669927
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.tex
new file mode 100644
index 0000000000..796f367595
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-inner2s2c.tex
@@ -0,0 +1,148 @@
+\errorcontextlines=200
+\documentclass[twoside]{scrartcl}
+%% $Id: multi-inner2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+\captionsetup{singlelinecheck=false}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\twocolumn
+\Blindtext
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat,capPos=inner]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+\end{lstlisting}
+
+
+\Float[Multi]
+
+
+\hvFloat[fullpage,multiFloat,capPos=inner]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+
+
+%\blinddocument
+\Blindtext
+\Blindtext
+
+
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat,capPos=inner]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+\end{lstlisting}
+
+
+\Float[Multi]
+
+%\end{document}
+\hvFloat[fullpage,multiFloat,capPos=inner]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+
+
+
+
+\blinddocument
+
+\Blindtext
+
+\Blindtext
+
+
+
+\end{document}
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.pdf
new file mode 100644
index 0000000000..1b1d0907ef
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.tex
new file mode 100644
index 0000000000..1947d4c409
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-outer2s2c.tex
@@ -0,0 +1,146 @@
+\errorcontextlines=100
+\documentclass[twoside]{scrartcl}
+%% $Id: multi-outer2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+\captionsetup{singlelinecheck=false}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+
+\twocolumn
+\Blindtext
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{multi:demo0} has a caption~\vpageref{multi:demo0-cap}.
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat,capPos=outer]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+\end{lstlisting}
+
+\Float[Multi]
+
+\hvFloat[fullpage,multiFloat,capPos=o,objectPos=c]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+
+
+
+\blinddocument
+\blindtext
+
+
+\Blindtext
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat,capPos=outer]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+\end{lstlisting}
+
+
+\Float[Multi]
+
+%\end{document}
+\hvFloat[fullpage,multiFloat,capPos=outer]%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo2}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo3}
+
+
+
+
+\blinddocument
+
+\Blindtext
+
+\Blindtext
+
+
+
+\end{document}
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.pdf
new file mode 100644
index 0000000000..2dd5415802
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.tex
new file mode 100644
index 0000000000..16b2ebacbf
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/multi-right1s1c.tex
@@ -0,0 +1,147 @@
+\documentclass{scrartcl}
+%% $Id: multi-right1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+\end{lstlisting}
+
+The fullpage multifloat~\vref{img:demo0} has a caption~\vpageref{img:demo0-cap}.
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=right,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=right,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=right,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+\end{lstlisting}
+
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=right,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo3}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo4}
+ +{figure}{\includegraphics[width=\linewidth]{CTAN}}%% no 4
+ {A Caption D of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo5}
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/odd1s1c.pdf
new file mode 100644
index 0000000000..de42239562
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/odd1s1c.tex
new file mode 100644
index 0000000000..073d3b0d7e
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd1s1c.tex
@@ -0,0 +1,74 @@
+\documentclass{scrartcl}
+%% $Id: odd1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+
+\Blindtext
+\Blindtext
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\Blindtext
+\Blindtext
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+\Blindtext
+
+\end{document}
+
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/odd1s2c.pdf
new file mode 100644
index 0000000000..90d6d62206
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/odd1s2c.tex
new file mode 100644
index 0000000000..b749afc192
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd1s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: odd1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd2s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/odd2s1c.pdf
new file mode 100644
index 0000000000..af4fd9ca4d
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd2s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd2s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/odd2s1c.tex
new file mode 100644
index 0000000000..a2f6e8fb0d
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd2s1c.tex
@@ -0,0 +1,80 @@
+\documentclass[twoside]{scrartcl}
+%% $Id: odd2s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/odd2s2c.pdf
new file mode 100644
index 0000000000..6e46682910
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/odd2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/odd2s2c.tex
new file mode 100644
index 0000000000..a6014dfe5d
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/odd2s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: odd2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=oddPage]
+\hvFloat[fullpage,capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/outer1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/outer1s2c.pdf
new file mode 100644
index 0000000000..15198bc21d
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/outer1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/outer1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/outer1s2c.tex
new file mode 100644
index 0000000000..92bca1907c
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/outer1s2c.tex
@@ -0,0 +1,76 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: outer1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:full0} has a caption~\vpageref{fig:full0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:full0} has a caption~\vpageref{fig:full0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:full0}
+\end{lstlisting}
+
+\Float[capPos=outer]
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:full0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=outer]
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/outer2s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/outer2s1c.pdf
new file mode 100644
index 0000000000..e13c10e526
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/outer2s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/outer2s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/outer2s1c.tex
new file mode 100644
index 0000000000..2392915bcb
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/outer2s1c.tex
@@ -0,0 +1,76 @@
+\documentclass[twoside]{scrartcl}
+%% $Id: outer2s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:full0} has a caption~\vpageref{fig:full0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:full0} has a caption~\vpageref{fig:full0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:full0}
+\end{lstlisting}
+
+\Float[capPos=outer]
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:full0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=outer]
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/outer2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/outer2s2c.pdf
new file mode 100644
index 0000000000..1b7d295d70
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/outer2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/outer2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/outer2s2c.tex
new file mode 100644
index 0000000000..fd96ebb4c9
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/outer2s2c.tex
@@ -0,0 +1,76 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: outer2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:full0} has a caption~\vpageref{fig:full0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:full0} has a caption~\vpageref{fig:full0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:full0}
+\end{lstlisting}
+
+\Float[capPos=outer]
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:full0}
+
+\blinddocument
+
+\section{Next Example}
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=outer]
+\hvFloat[fullpage, capPos=outer]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on the outer side of a twosided document.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.pdf
new file mode 100644
index 0000000000..09d3cf9c52
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.tex
new file mode 100644
index 0000000000..1832540102
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-after1s1c.tex
@@ -0,0 +1,82 @@
+\documentclass{scrartcl}
+%% $Id: paper-after1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\usepackage{pdfpages}
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+\Blindtext
+
+\blindtext
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+%\blinddocument
+\Blindtext
+
+
+\begin{lstlisting}
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.pdf
new file mode 100644
index 0000000000..7d8a729015
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.tex
new file mode 100644
index 0000000000..09233d3b4f
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s1c.tex
@@ -0,0 +1,82 @@
+\documentclass{scrartcl}
+%% $Id: paper-default1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\usepackage{pdfpages}
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+\Blindtext
+
+\blindtext
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+%\blinddocument
+\Blindtext
+
+
+\begin{lstlisting}
+\hvFloat[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.pdf
new file mode 100644
index 0000000000..91fe896dc9
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.tex
new file mode 100644
index 0000000000..bb4b173deb
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-default1s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: paper-default1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for FULLPAGE floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The FULLPAGE image~\vref{fig:FULLPAGE0} has a caption~\vpageref{fig:FULLPAGE0-cap}.
+\end{lstlisting}
+
+The FULLPAGE image~\vref{fig:FULLPAGE0} has a caption~\vpageref{fig:FULLPAGE0-cap}.
+
+\begin{lstlisting}
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE1}
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.pdf
new file mode 100644
index 0000000000..4a303dee2f
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.tex
new file mode 100644
index 0000000000..6647b434ed
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-default2s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: paper-default2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for FULLPAGE floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The FULLPAGE image~\vref{fig:FULLPAGE0} has a caption~\vpageref{fig:FULLPAGE0-cap}.
+\end{lstlisting}
+
+The FULLPAGE image~\vref{fig:FULLPAGE0} has a caption~\vpageref{fig:FULLPAGE0-cap}.
+
+\begin{lstlisting}
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat*[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE1}
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.pdf
new file mode 100644
index 0000000000..945d4e9c41
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.tex
new file mode 100644
index 0000000000..08a44c47eb
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-inner2s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: paper-inner2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for FULLPAGE floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The FULLPAGE image~\vref{fig:FULLPAGE0} has a caption~\vpageref{fig:FULLPAGE0-cap}.
+\end{lstlisting}
+
+The FULLPAGE image~\vref{fig:FULLPAGE0} has a caption~\vpageref{fig:FULLPAGE0-cap}.
+
+\begin{lstlisting}
+\hvFloat*[FULLPAGE,capPos=inner]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE0}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat*[FULLPAGE,capPos=inner]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat*[FULLPAGE,capPos=inner]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE1}
+\end{lstlisting}
+
+
+\Float[default]
+\hvFloat*[FULLPAGE,capPos=inner]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose}}%
+ [A FULLPAGE float with the default caption setting]%
+ {A default caption of a ``FULLPAGE'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:FULLPAGE1}
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.pdf
new file mode 100644
index 0000000000..e4606b5751
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.tex
new file mode 100644
index 0000000000..23ee98ff60
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/paper-right1s1c.tex
@@ -0,0 +1,82 @@
+\documentclass{scrartcl}
+%% $Id: paper-right1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\usepackage{pdfpages}
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+\blindtext
+
+\blindtext
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\Blindtext
+
+\Blindtext
+
+\begin{lstlisting}
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[FULLPAGE,capPos=after]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/preamble.ltx b/macros/latex/contrib/hvfloat/doc/examples/preamble.ltx
new file mode 100644
index 0000000000..dd2d7ccc4f
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/preamble.ltx
@@ -0,0 +1,44 @@
+\PassOptionsToPackage{silent}{fontspec}
+\usepackage{libertinus}
+\setmonofont[Scale=MatchLowercase,FakeStretch=0.9]{DejaVu Sans Mono}
+\usepackage{microtype}
+\usepackage[english]{babel}
+
+\usepackage{listings}
+\usepackage{xcolor}
+\usepackage[automark]{scrlayer-scrpage}
+\pagestyle{scrheadings}
+%
+\lstset{%
+ language=[LaTeX]TeX,%
+ showstringspaces=false,%
+ tabsize=5,%
+% frame={tb},%
+% lineskip=-1pt,%
+ extendedchars=true,%
+ basicstyle={\small\ttfamily},%
+% numbers=left,%
+% stepnumber=1,%
+% numberstyle=\tiny,%
+% xleftmargin=2em,%
+% backgroundcolor=black!20,
+ breaklines=true}
+%
+
+%\usepackage{marginnote}
+%newcommand\Float[1][]{\ifx\relax#1\relax\marginnote{\fbox{float}}\else
+% \marginnote{\fbox{\shortstack{float\\#1}}}\fi
+%
+
+\newcommand\Float[1][]{\centerline{\fbox{Float #1}}}
+
+\usepackage{graphicx}
+\usepackage{varioref}
+\usepackage{nameref}
+\usepackage[hyperref]{hvfloat}
+%\usepackage{hvfloat}
+\DeclareCaptionFont{red}{\color{red}}
+\captionsetup{labelfont={red,sf},font={red,sf},format=plain}
+
+\usepackage{blindtext}
+\flushbottom
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/right1s1c.pdf
new file mode 100644
index 0000000000..8423fc99de
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/right1s1c.tex
new file mode 100644
index 0000000000..a3042a3530
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right1s1c.tex
@@ -0,0 +1,76 @@
+\documentclass{scrartcl}
+%% $Id: right1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=right]
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\Blindtext
+
+\Blindtext
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=right]
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/right1s2c.pdf
new file mode 100644
index 0000000000..62e121a492
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/right1s2c.tex
new file mode 100644
index 0000000000..98ce0eb17d
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right1s2c.tex
@@ -0,0 +1,81 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: right1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+
+\blinddocument
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right2s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/right2s1c.pdf
new file mode 100644
index 0000000000..c4cf629636
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right2s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right2s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/right2s1c.tex
new file mode 100644
index 0000000000..362f953f8b
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right2s1c.tex
@@ -0,0 +1,74 @@
+\documentclass[twoside]{scrartcl}
+%% $Id: right2s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=after]
+\hvFloat[fullpage,capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/right2s2c.pdf
new file mode 100644
index 0000000000..04fe952cb5
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/right2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/right2s2c.tex
new file mode 100644
index 0000000000..154a7beeae
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/right2s2c.tex
@@ -0,0 +1,80 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: right2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+
+\begin{document}
+
+\tableofcontents
+ ewpage
+
+\blinddocument
+
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+\end{lstlisting}
+
+The fullpage image~\vref{fig:fullpage0} has a caption~\vpageref{fig:fullpage0-cap}.
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+\Float[capPos=right]
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+
+\blinddocument
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+\Float[capPos=right]
+\hvFloat[fullpage,capPos=right]%
+ {figure}%
+ {\includegraphics[fullpage]{frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage1}
+
+\blinddocument
+
+
+\Blindtext \Blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/runAll.sh b/macros/latex/contrib/hvfloat/doc/examples/runAll.sh
new file mode 100755
index 0000000000..94e35c43f1
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/runAll.sh
@@ -0,0 +1,20 @@
+#!/bin/bash
+for datei in *.tex
+do
+ RUNS=1
+ echo "LuaLaTeX-Lauf Nr. $RUNS von $datei ======================================="
+ lualatex $datei
+ MAIN=$(basename -a -s .tex $datei)
+ TEST=`grep -c "Label(s) may have changed." $MAIN.log`
+ while [ $TEST -gt 0 ];
+ do
+ let RUNS=RUNS+1
+ echo "LuaLaTeX-Lauf Nr. $RUNS von $datei ======================================="
+ lualatex $datei
+ TEST=`grep -c "Label(s) may have changed." $MAIN.log `
+ if [ $RUNS -gt 5 ]
+ then TEST=0
+ fi
+ done
+ rm $MAIN.aux $MAIN.log $MAIN.out $MAIN.toc
+done
diff --git a/macros/latex/contrib/hvfloat/doc/examples/runEXA.sh b/macros/latex/contrib/hvfloat/doc/examples/runEXA.sh
new file mode 100755
index 0000000000..8d6e6f84fe
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/runEXA.sh
@@ -0,0 +1,20 @@
+#!/bin/bash
+for datei in $1????.tex
+do
+ RUNS=1
+ echo "LuaLaTeX-Lauf Nr. $RUNS von $datei ======================================="
+ lualatex $datei
+ MAIN=$(basename -a -s .tex $datei)
+ TEST=`grep -c "Label(s) may have changed." $MAIN.log`
+ while [ $TEST -gt 0 ];
+ do
+ let RUNS=RUNS+1
+ echo "LuaLaTeX-Lauf Nr. $RUNS von $datei ======================================="
+ lualatex $datei
+ TEST=`grep -c "Label(s) may have changed." $MAIN.log `
+ if [ $RUNS -gt 5 ]
+ then TEST=0
+ fi
+ done
+ rm $MAIN.aux $MAIN.log $MAIN.out $MAIN.toc
+done
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.pdf
new file mode 100644
index 0000000000..2ba15f5ffc
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.tex
new file mode 100644
index 0000000000..4d87de577a
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-after1s1c.tex
@@ -0,0 +1,129 @@
+\documentclass{scrartcl}
+%% $Id: sub-after1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The sub images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.pdf
new file mode 100644
index 0000000000..a06feaca2a
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.tex
new file mode 100644
index 0000000000..5d46609f00
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-after2s2c.tex
@@ -0,0 +1,129 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: sub-after2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The sub images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.pdf
new file mode 100644
index 0000000000..89721e0270
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.tex
new file mode 100644
index 0000000000..6777dea5c7
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s1c.tex
@@ -0,0 +1,130 @@
+\documentclass{scrartcl}
+%% $Id: sub-default1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo6}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo7}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo6}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.pdf
new file mode 100644
index 0000000000..db16fbc2dd
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.tex
new file mode 100644
index 0000000000..1ebc5bb9cc
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-default1s2c.tex
@@ -0,0 +1,131 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: sub-default1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo6}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.pdf
new file mode 100644
index 0000000000..6de66848d6
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.tex
new file mode 100644
index 0000000000..3e007f239e
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-default2s2c.tex
@@ -0,0 +1,131 @@
+\documentclass[twoside,twocolumn]{scrartcl}
+%% $Id: sub-default2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo6}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=l,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.pdf
new file mode 100644
index 0000000000..7f7bd67892
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.tex
new file mode 100644
index 0000000000..078f901932
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s1c.tex
@@ -0,0 +1,129 @@
+\documentclass{scrartcl}
+%% $Id: sub-right1s1c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The sub images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.pdf
new file mode 100644
index 0000000000..87ff80154a
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.tex
new file mode 100644
index 0000000000..f721256a11
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-right1s2c.tex
@@ -0,0 +1,129 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: sub-right1s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The sub images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=after,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.pdf b/macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.pdf
new file mode 100644
index 0000000000..e27919a3bc
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.tex b/macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.tex
new file mode 100644
index 0000000000..e4f5f9c246
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/examples/sub-right2s2c.tex
@@ -0,0 +1,129 @@
+\documentclass[twocolumn]{scrartcl}
+%% $Id: sub-right2s2c.tex 1033 2019-04-04 07:24:57Z herbert $
+
+\input{preamble.ltx}
+\setlength\columnseprule{0.4pt}
+\begin{document}
+\title{Example for fullpage floats}
+\author{Herbert Voß}
+\maketitle
+
+\tableofcontents
+
+\blinddocument
+
+\section{File \texttt{\jobname}}
+
+\begin{lstlisting}
+The sub images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+\end{lstlisting}
+
+The multi images~\vref{sub:demo0} has a caption~\vpageref{sub:demo0-cap} and the
+subimage~~\vref{sub:demo1} has a caption~\vpageref{sub:demo1}.
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+
+
+
+\blinddocument
+
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+\end{lstlisting}
+
+\Float[subfloat]
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=right,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo4}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo5}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo6}
+ +{}{\includegraphics[width=\linewidth]{CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo7}
+
+
+
+\blinddocument
+
+\Blindtext
+
+\blindtext
+
+
+\end{document} \ No newline at end of file
diff --git a/macros/latex/contrib/hvfloat/doc/hvfloat.pdf b/macros/latex/contrib/hvfloat/doc/hvfloat.pdf
new file mode 100644
index 0000000000..5f28291fa0
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/hvfloat.pdf
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/hvfloat.tex b/macros/latex/contrib/hvfloat/doc/hvfloat.tex
new file mode 100644
index 0000000000..dca29f2ebe
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/hvfloat.tex
@@ -0,0 +1,2577 @@
+%% $Id: hvfloat.tex 1072 2019-06-09 14:14:19Z herbert $
+\listfiles
+\errorcontextlines=100
+\documentclass[twoside,paper=a4]{scrartcl}
+\usepackage{fontspec}
+\usepackage{libertinus}
+%\usepackage[scaled=0.85]{beramono}
+\setmonofont[Scale=MatchLowercase,FakeStretch=0.9]{DejaVu Sans Mono}
+
+\usepackage{microtype}
+\usepackage[english]{babel}
+
+\usepackage[automark]{scrlayer-scrpage}
+\pagestyle{scrheadings}
+
+\usepackage[showframe=false]{geometry}
+\usepackage{listings}
+%
+\lstset{%
+ language=[LaTeX]TeX,%
+ showstringspaces=false,%
+ tabsize=5,%
+% frame={tb},%
+% lineskip=-1pt,%
+ extendedchars=true,%
+ basicstyle={\small\ttfamily},%
+% numbers=left,%
+% stepnumber=1,%
+% numberstyle=\tiny,%
+% xleftmargin=2em,%
+ breaklines=true}
+%
+
+\usepackage{graphicx}
+\usepackage{placeins}
+\usepackage{ragged2e}
+\usepackage{xcolor}
+\usepackage{url}
+\usepackage{booktabs,xltabular}
+\usepackage{lscape}
+\usepackage{varioref}
+\usepackage{multicol}
+\usepackage{blindtext}
+
+\usepackage{marginnote}
+
+%\usepackage{imakeidx}
+\usepackage{xindex}
+\makeindex
+
+\usepackage{hvindex}
+\usepackage[all=!htb]{hvfloat-fps}
+\usepackage[fbox,hyperref]{hvfloat}
+\captionsetup{format=plain,font=sf,labelfont=sf}
+\captionsetup[sub]{format=plain,font=sf,labelfont=sf}
+
+\hypersetup{urlcolor=blue, linktocpage, colorlinks=true}
+%
+\makeatletter
+
+\def\Lfile#1{\texttt{#1}\index{#1@\texttt{#1} (file)}}
+\def\Lext#1{\texttt{.#1}\index{#1@\texttt{.#1} (file extension)}}
+\def\Ldim#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1} (length)}}
+\def\Lcs#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1}}}
+\def\nxLcs#1{\texttt{\textbackslash#1}}
+\def\Lenv#1{\texttt{#1}\index{#1@\texttt{#1} (environment)}}
+\def\Lpack#1{\texttt{#1}\index{#1@\texttt{#1} (package)}}
+\def\Lprog#1{\texttt{#1}\index{#1@\texttt{#1} (program)}}
+\def\Loption#1{\texttt{#1}\index{#1@\texttt{#1} (package option)}}
+\def\Lkeyword#1{\texttt{#1}\index{#1@\texttt{#1} (keyword)}}
+\def\Lkeyval#1{\texttt{#1}\index{#1@\texttt{#1} (value)}}
+\def\Lskip#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1} (skip)}}
+\def\Lkeyset#1{\expandafter\Lkeyset@i#1\@nil}
+\def\Lkeyset@i#1=#2\@nil{\texttt{#1=#2}%
+ \index{#1@\texttt{#1} (keyword)}\index{Keyword!#1@\texttt{#1}}
+ \index{#2@\texttt{#2} (value)}\index{Value!#2@\texttt{#2}}}
+
+
+
+\newsavebox\boxdef
+\newenvironment{BDef}
+ {\begin{lrbox}{\boxdef}
+ \def\arraystretch{1.0}
+ \begin{tabular}{@{}l@{}l@{}l@{}}}
+ {\end{tabular}\end{lrbox}
+%
+% braces around next block are needed to stop the list env checking for blank lines
+% and the \aftergroups then for making sure no indentation happens ... as i said
+% urg
+%
+ {\BCmd\fbox{\usebox\boxdef}\endBCmd}
+ \aftergroup\@afterindentfalse\aftergroup\@afterheading
+ }
+
+\newskip\BDefaboveskip
+\newskip\BDefbelowskip
+\newskip\BDefinlineskip
+\setlength\BDefaboveskip{0pt plus 2pt}% first-level list topsep
+\setlength\BDefbelowskip{10pt}
+\setlength\BDefinlineskip{6pt}
+
+\newenvironment{BCmd}{
+ \@beginparpenalty-\@lowpenalty
+ \topsep\BDefaboveskip
+ \fboxsep3pt
+ \flushleft}
+ {\@endparpenalty\@M
+ \@topsepadd\BDefbelowskip
+ \endflushleft}
+
+\newenvironment{BCmd*}{
+ \@beginparpenalty\@M
+ \topsep\BDefinlineskip
+ \fboxsep3pt
+ \flushleft}
+ {\@endparpenalty5000
+ \endflushleft}
+
+
+\def\OptArgs{\colorbox{black!20}{\texttt{[Options]}}\kern1pt}
+\def\OptArg{\@ifnextchar*\OptArg@i{\OptArg@ii*}}% star version without braces
+\def\OptArg@i*#1{\colorbox{black!20}{\texttt{#1}}\kern1pt}
+\def\OptArg@ii*#1{\colorbox{black!20}{\texttt{[#1]}}\kern1pt}
+\def\DBS{{\ttfamily\textbackslash\textbackslash}}
+
+
+\makeatother
+
+\newcommand\Larg [1]{{\normalfont\itshape#1\/}}
+\newcommand\Larga[1]{$\langle$\Larg{#1}$\rangle$}% angles
+\newcommand\Largb[1]{\lcb\Larg{#1}\rcb} % curly brace
+\newcommand\Largs[1]{\lsb\Larg{#1}\rsb} % square brackets
+\newcommand\Largr[1]{\lrb\Larg{#1}\rrb} % round brackets
+\newcommand\LBEG[1]{{\normalfont\ttfamily\bs{}begin\lcb#1\rcb}\xLenv{#1}}
+\newcommand\LmBEG[1]{{\normalfont\ttfamily\bs{}begin\lcb#1\rcb}\xLmenv{#1}}
+\newcommand\LEND[1]{{\normalfont\ttfamily\bs{}end\lcb#1\rcb}\xLenv{#1}}
+\newcommand\LmEND[1]{{\normalfont\ttfamily\bs{}end\lcb#1\rcb}\xLmenv{#1}}
+
+\DeclareRobustCommand\bs{{\normalfont\ttfamily\textbackslash}} % \let\bslash=\bs
+\DeclareRobustCommand\lcb{{\normalfont\ttfamily\textbraceleft}}
+\DeclareRobustCommand\rcb{{\normalfont\ttfamily\textbraceright}}
+\DeclareRobustCommand\lsb{{\normalfont\ttfamily[}}
+\DeclareRobustCommand\rsb{{\normalfont\ttfamily]}}
+\DeclareRobustCommand\lrb{{\normalfont\ttfamily(}}
+\DeclareRobustCommand\rrb{{\normalfont\ttfamily)}}
+\DeclareRobustCommand\false{{\ttfamily false}}
+\DeclareRobustCommand\true{{\ttfamily true}}
+
+\let\CMD\Lcs
+\let\ENV\Lenv
+
+\newcommand\Float[1][]{\ifx\relax#1\relax\marginnote{\fbox{float}}\else
+ \marginnote{\fbox{\shortstack{float\\#1}}}\fi
+}
+
+
+\begin{document}
+\title{Package \texttt{hvfloat}\\Rotating and scaling of objects and captions\\ver \hvFileVersion}
+\author{Herbert Voß\thanks{\protect\url{hvoss@tug.org}}}
+\date{\today}
+\maketitle
+
+
+
+\begin{abstract}
+The package \texttt{hvfloat} defines a macro to place objects and captions of floats in different
+positions with different rotating angles.
+
+All objects and captions are framed on the first pages, which is only for some demonstration here and
+has no additional sense!
+
+To compare the place of the definition of the floating objects in the source and the output a
+marginnote \fbox{float} is set into the margin. This is done also only for demonstration!
+\end{abstract}
+\vfill
+
+\hvFloat[%
+ nonFloat=true,
+ capWidth=0.5,
+ capPos=right,
+ objectAngle=120,
+ capAngle=-210,
+ objectPos=center
+]{figure}{\protect\fbox{\includegraphics[scale=0.9]{images/rose}}}{\protect\fbox{What a nice Caption :-)}}{fig:title}
+
+\vspace*{\fill}
+
+\clearpage
+
+
+\tableofcontents
+
+\clearpage
+
+\listoftables
+\listoffigures
+
+
+\clearpage
+\section{The package options}
+
+\noindent\begin{tabularx}{\textwidth}{lX}
+\Loption{fbox} & The objects and captions are put into a \Lcs{fbox} command, like in
+this documentation. This doesn't make real sense and is only for some demonstration useful or for locating
+problems if images seems to have too much whitespace.\\
+\Loption{hyperref} & Load package \Lpack{hyperref}. % and also package \Lpack{hypcap}.
+\end{tabularx}
+
+\bigskip
+
+The length \Lskip{belowcaptionskip} is set by \LaTeX{} to 0pt and changed in \Lpack{hvfloat} to the
+same value than \Lskip{abovecaptionskip}. This length can be changed to another value in the usual
+way with \Lcs{setlength} or \Lcs{addtolength}.
+
+The following packages are loaded by \Lpack{hvfloat} and the optional argument
+\Loption{hypcap} is passed to the packages \Lpack{caption} and \Lpack{subcaption}:
+
+\Lpack{caption},
+\Lpack{subcaption},
+\Lpack{atbegshi},
+%\RequirePackage{hyperref}
+\Lpack{expl3}, \Lpack{multido},
+\Lpack{graphicx},
+\Lpack{xkeyval},
+\Lpack{ifoddpage}, and
+\Lpack{afterpage}.
+
+
+
+\section{The Macros and optional arguments}
+The syntax for the macros and \Lcs{setDefaults}, \Lcs{hvSet}, and \CMD{hvFloat} is
+
+\begin{BDef}
+\Lcs{hvset}\Largb{key=value list}\\
+\Lcs{setDefaults}\\
+\Lcs{hvFloat}\OptArg*{*}\OptArgs\OptArg*{+}\Largb{float type}\Largb{floating object}\OptArg{short caption}\Largb{long caption}\Largb{label}
+\end{BDef}
+
+The star version is explained in section~\vref{star-version0} and \vref{star-version} and
+the optional \OptArg*{+} is explained in section~\vref{sec:multifloats}.
+
+\Lcs{hvSet} allows the global setting of keywords and \Lcs{setDefaults} sets all keywords to
+its default value as shown in Table~\vref{tab:options}.
+
+If \Lcs{hvFloat} has an empty second parameter \texttt{<float type>}, then \Lcs{hvFloat} switches by default to
+a nonfloat (see table~\ref{tab:options}) object, which is not important for the user. All other parameters
+may also be empty and the short caption as second optional parameter missing. This one is as usual the
+caption for the \Lcs{listoffigures}.
+
+There are some more macros defined, more or less for internally use in \Lpack{hvfloat}, but they can
+be used for own purposes.
+
+
+\begin{BDef}
+\Lcs{figcaption}\OptArg{short caption text}\Largb{caption text}\\
+\Lcs{tabcaption}\OptArg{short caption text}\Largb{caption text}
+\end{BDef}
+
+They are used for the \Lkeyword{nonFloat} keyword, where these macros write captions in the same way but outside of
+a float environment. The default caption cannot be used here. It is no problem to use the \CMD{tabcaption}
+command to place a caption anywhere, like here in an inlined mode:
+\tabcaption[The Caption without sense ...]{A Caption without any sense and any object}\label{dummy}
+A label can be put inside the argument or after the command in the usual way, so that a reference to
+the not existing table~\ref{dummy} is no problem.
+
+{\small\begin{verbatim}
+[...] It is no problem to use the \verb|\tabcaption| command to place a caption anywhere,
+like here in an inlined mode: \tabcaption[The Caption without sense ...]{A Caption without any
+sense and any object}\label{dummy} A label can be put inside the argument or after the command
+in the usual way, so that a reference to the not existing table~\ref{dummy} is no problem.
+\end{verbatim}}
+
+
+With the macro \Lcs{defhvstyle} one can define a style which can be used instead of
+the individual setting:
+
+\begin{BDef}
+\Lcs{defhvstyle}\Largb{name}\Largb{setting}
+\end{BDef}
+
+Internally the style is saved in a macro named \verb|\hv@<name>|.
+
+
+%\index{capPos@\texttt {capPos} (keyword)|(}
+
+%\subsection{The Options}
+There are the following keywords:
+
+\begin{xltabular}{\textwidth}{@{} l>{\small\ttfamily}cX @{}}
+\caption{The optional keywords for the macro \nxLcs{hvFloat}}\label{tab:options}\\\toprule
+\emph Keyword & \emph Default & \emph Description\\\midrule
+\endfirsthead
+\midrule
+\emph Keyword & \emph Default & \emph Description\\\midrule
+\endhead
+\midrule
+\endfoot
+\bottomrule
+\endlastfoot
+\Lkeyword{floatPos} & \texttt{htb} & This is \emph{not} the same default placement setting like the one from the floats.\\
+\Lkeyword{rotAngle} & 0& The value for the angle if both, the object and the caption should be rotated in the same way.\\
+
+\Lkeyword{capWidth} & n& The width of the caption. Can be »\texttt{n}« like a natural width,
+ »\texttt{w}« for the width of the object, »\texttt{h}« for the height of the object, or a scale for \verb|\columnwidth|.\\
+
+\Lkeyword{capAngle} & 0 & The value for the angle if the caption should be rotated. Counted anti clockwise.\\
+
+\Lkeyword{capPos} & before& The position of the caption relative to the object. Possible values are\\
+ & & \Lkeyval{before}: \emph{always} before (left) from the object.\\
+ & & \Lkeyval{left}: \emph{always} before (left) from the object, but on the \emph{same page} in \Index{twocolumn} mode.\\
+ & & \Lkeyval{after}: \emph{always} after (right) from the object.\\
+ & & \Lkeyval{right}: \emph{always} after (right) from the object, but on the \emph{same page} in \Index{twocolumn} mode.\\
+ & & \Lkeyval{inner}: in \Index{twoside} mode always typeset at the inner margin.\\
+ & & \Lkeyval{outer}: in \Index{twoside} mode always typeset at the outer margin.\\
+ & & \Lkeyval{evenPage}: in \Index{twoside} mode with \Index{fullpage} objects always on an even page.\\
+ & & \Lkeyval{oddPage}: in \Index{twoside} mode with \Index{fullpage} objects always on an odd page.\\
+
+\Lkeyword{capVPos}& c& This is only important for \texttt{capPos=left|right}. Only in this case the
+ caption can vertically placed at the \Lkeyval{bottom}, \Lkeyval{center} and \Lkeyval{top}.\\
+
+\Lkeyword{objectPos} & center & The horizontalplacement of the object relative to the document. Possible values are (\textbf{l})eft|(\textbf{c})enter|(\textbf{r})ight.\\
+
+\Lkeyword{objectAngle} & 0 & The value for the angle if the object should be rotated. Counted anti clockwise.\\
+
+\Lkeyword{floatCapSep} & 5pt & The additional width between the object and a left or right placed caption.\\
+
+
+\Lkeyword{useOBox} & false & Instead of passing the object as parameter to the \Lcs{hvFloat}, the contents maybe saved in the box \texttt{\textbackslash hvOBox} With \texttt{useOBox=true} the contents of this box will be used.\\
+
+\Lkeyword{nonFloat} & false & The object isn't put in a floating environment. It is printed as standard text with an additional caption. The float counters are increased as usual and can be referenced.\\
+
+\Lkeyword{wide} & false & The float can use \Ldim{textwidth}+\Ldim{marginparwidth} as horizontal width.\\
+
+\Lkeyword{objectFrame} & false & put a frame with no separation around the float object.\\
+
+\Lkeyword{style} & --- & Use a defined style\\
+
+\Lkeyword{capFormat} & --- & Define formatting options for \Lcs{caption} (see documentation of package \Lpack{caption}).\\
+
+\Lkeyword{subcapFormat} & --- & Define formatting options for \Lcs{subcaption}.\\
+\end{xltabular}
+
+
+
+\section{The default use of floating environments}
+In this case there is no essential difference to the well known \Lenv{figure}
+or \Lenv{table} environment, f.ex.:
+
+
+\small\begin{verbatim}
+\begin{figure}
+... object ...
+\caption{...}% caption below the object
+\end{figure}
+\end{verbatim}
+
+
+\normalsize
+
+\hvFloat{figure}{\includegraphics{images/rose}}{Without any keywords (only the \texttt{fbox} package option)}{fig:0}
+
+Code for figure \ref{fig:0}:
+\begin{lstlisting}
+\hvFloat{figure}{\includegraphics{images/rose}}{Without any keywords (only the \texttt{fbox} package option)}{fig:0}
+\end{lstlisting}
+
+\Float
+\hvFloat[capPos=top]{table}{%
+\begin{tabularx}{\textwidth}{l|l|X}
+ \rmfamily Name & Type & Description\\\hline
+ \CMD{hvFloat} & command & places object and caption in different ways\\
+ \Lenv{hvFloatEnv} & environment & places object and caption exactly Here\\
+ \CMD{figcaption} & command & writes a figure caption in a non floating environment\\
+ \CMD{tabcaption} & command & writes a table caption in a non floating environment\\
+ \CMD{setDefaults} & command & sets all options to the defaults\\
+ \CMD{defhvstyle} & command & define a user style
+\end{tabularx}%
+}{With the only Option \texttt{capPos=top} to place the caption on top of the table, which is often the default.}{tab:0}
+
+Code for table \ref{tab:0}:
+\begin{lstlisting}
+\hvFloat[capPos=top]{table}{%
+\begin{tabularx}{\textwidth}{>{\ttfamily}l|l|X}
+ \rmfamily Name & Type & Description\\\hline
+ \CMD{hvFloat} & command & places object and caption in different ways\\
+ hvFloatEnv & environment & places object and caption exactly Here\\
+ \CMD{figcaption} & command & writes a figure caption in a non floating environment\\
+ \CMD{tabcaption} & command & writes a table caption in a non floating environment\\
+ \CMD{setDefaults} & command & sets all options to the defaults\\
+ \CMD{defhvstyle} & command & define a user style
+\end{tabularx}}%
+{With the only Option \texttt{capPos=top} to place the caption on top of the table, which is often the default.}%
+{tab:0}
+\end{lstlisting}
+
+See section~\ref{sec:tables} for some more informations about tabulars as objects.
+
+
+
+\section{Caption width}
+%\Lkeyword{capWidth} & 0.8& The width of the caption.
+%Can be "\texttt{w}" for the width of the object or
+%"\texttt{h}" for the height of the object
+%or a scale for \verb|\columnwidth|.\\
+
+\subsection{Default -- natural width}
+
+The default setting is the natural width of a paragraph with respect to the current linewidth or columnwidth
+for a caption below or above an object. It behaves in the same way as a caption set by one of the default
+floating environments like \Lenv{figure} or \Lenv{table}:
+
+
+\begin{lstlisting}
+\hvFloat[floatPos=!htb]{figure}{\includegraphics{images/rose}}%
+ {Default caption width setting, which is the natural width with respect to the current linewidth.}{fig:width0}
+\end{lstlisting}
+
+\Float
+\hvFloat[floatPos=!htb]{figure}{\includegraphics{images/rose}}%
+ {Default caption width setting, which is the natural width with respect to the current linewidth.}{fig:width0}
+
+
+For\marginnote{!!} the following examples the package option \texttt{fbox} is disabled. All
+frames are now set with the macro \Lcs{frame} or the optional keyword \Lkeyword{objectFrame}.
+
+
+
+For a caption beside an object, the \emph{natural} caption width (without the optional argument \Lkeyword{wide})
+is given by the current linewidth
+minus the width of the object and the space between object and caption, which is set by
+\Lkeyword{floatCapSep} (see Table~\vref{tab:options}).
+
+\makeatletter
+\hv@fboxfalse
+\makeatother
+
+\begin{lstlisting}
+\hvFloat[floatPos=!htb,capPos=after,objectFrame]{figure}{\includegraphics[scale=1.5]{images/rose}}%
+ {Caption right beside with a \emph{natural} width, which is given by the width of the object,
+ the separation between object and caption, and the current linewidth.}{fig:width1}
+\end{lstlisting}
+
+\Float
+\hvFloat[floatPos=!htb,capPos=after,objectFrame]{figure}{\includegraphics[scale=1.5]{images/rose}}%
+ {Caption right beside with a \emph{natural} width, which is given by the width of the object,
+ the separation between object and caption, and the current linewidth.}{fig:width1}
+
+
+\subsection{Relative linewidth}
+
+With \Lkeyword{capWidth}\texttt{=<number>} the caption width is set to \texttt{<number>}\Ldim{columnwidth}.
+For captions at the bottom or on top of objects the setting is not checked if \texttt{<number>}
+is greater than 1.
+
+% If the given scale (0.8 in the
+%following example) leads to a
+%greater caption width than this maximal caption width, it will automatically set to the maximal width:
+
+\begin{lstlisting}
+\hvFloat[floatPos=!htb,capWidth=0.9]{figure}{\includegraphics{images/rose}}%
+ {Caption below with a width of 0.9 of the current line width (column width), which is
+ in this special case \the\linewidth. Divide it by 28.82 to get cm.}{fig:width2}
+\end{lstlisting}
+
+\Float
+\hvFloat[floatPos=!htb,capWidth=0.9]{figure}{\includegraphics{images/rose}}%
+ {Caption below with a width of 0.9 of the current line width (column width), which is
+ in this special case \the\linewidth. Divide it by 28.82 to get cm.}{fig:width2}
+
+
+
+If such a value like 0.9\Ldim{linewidth} is used for a caption beside an object, then
+the macro does a test if the space beside the object is less equal the defined caption width.
+If not then the width is set to the possible value between object and margin:
+
+
+
+\begin{lstlisting}
+\hvFloat[floatPos=!htb,
+ capPos=after,
+ capWidth=0.9]{figure}{\includegraphics[scale=1.5]{images/rose}}%
+ {Caption right beside with a width setting of \texttt{0.9\textbackslash linewidth}
+ which is too big for this example and therefore corrected
+ by the macro to the maximal width.}{fig:width3}
+\end{lstlisting}
+
+\Float
+\hvFloat[floatPos=!htb,capPos=after,capWidth=0.9]{figure}{\includegraphics[scale=1.5]{images/rose}}%
+ {Caption right beside with a width setting of \texttt{0.9\textbackslash linewidth}
+ which is too big for this example and therefore corrected by the macro to the maximal width.}{fig:width3}
+
+
+\subsection{Identical object and caption width}
+
+With \Lkeyset{capWidth=w} the caption width is like the object width which makes only
+real sense if you have a lot of identical images with respect to its widths.
+
+\begin{lstlisting}
+\hvFloat[floatPos=!htb,capWidth=w]{figure}{\includegraphics[width=0.5\linewidth]{images/CTAN}}%
+ {Caption below with a width of the given object which may be a problem
+ if it is a very small object.}{fig:width4}
+\end{lstlisting}
+
+\Float
+\hvFloat[floatPos=!htb,capWidth=w]{figure}{\includegraphics[width=0.5\linewidth]{images/CTAN}}%
+ {Caption below with a width of the given object which may be a problem
+ if it is a very small object.}{fig:width4}
+
+
+\subsection{caption width to height of the object}
+
+With \Lkeyset{capWidth=h} the caption width is like the object height which makes only
+real sense if you want to put a rotated caption beside the object.
+
+\begin{lstlisting}
+\hvFloat[floatPos=!htb,capPos=after,capWidth=h,capAngle=90,objectFrame]{figure}{\includegraphics{images/rose}}%
+ {Caption beside with a width of the given object height which may be a problem
+ if it is a very small object.}{fig:width5}
+\end{lstlisting}
+
+\hvFloat[floatPos=!htb,capPos=after,capWidth=h,capAngle=90,objectFrame]{figure}{\includegraphics{images/rose}}%
+ {Caption beside with a width of the given object height which may be a problem
+ if it is a very small object.}{fig:width5}
+
+
+
+\section{Caption left or right of the object}
+By default the caption is set on the left side of the object. If the caption and the object are set side by side, then
+the keyvalue \Lkeyval{before} is identical to the setting \Lkeyval{left}.
+
+\subsection{Caption right with specific length}
+Code for figure \ref{fig:1}:
+\begin{lstlisting}
+\hvFloat%
+ [floatPos=htb,
+ capPos=right,
+ objectFrame,
+ objectPos=c]{figure}{\includegraphics[scale=0.9]{images/rose}}%
+ [Caption beside object and vertically centered]%
+ {Caption vertically centered right beside the float with a natural caption width
+ (the default). \blindtext}%
+ {fig:1}
+\end{lstlisting}
+
+\Float[capPos=right]
+\hvFloat%
+ [floatPos=htb,
+ capPos=right,
+ objectFrame,
+ objectPos=c]{figure}{\includegraphics[scale=0.9]{images/rose}}%
+ [Caption beside object and vertically centered]%
+ {Caption vertically centered right beside the float with a natural caption width
+ (the default). \blindtext}%
+ {fig:1}
+
+
+\subsection{Caption left and rotated}
+
+Code for figure \ref{fig:2}:
+\begin{lstlisting}
+\hvFloat%
+ [floatPos=htb,
+ capPos=left,
+ capWidth=h,% of \columnwidth
+ capAngle=90,
+ objectFrame
+ ]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption beside Object]%
+ {Caption vertically centered left beside the float with a caption width
+ of \texttt{capWidth=h}, which is the height of the object.}{fig:2}
+\end{lstlisting}
+
+\Float[capAngle=90]
+\hvFloat%
+ [floatPos=htb,
+ capPos=left,
+ capWidth=h,% of \columnwidth
+ capAngle=90,
+ objectFrame
+ ]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption beside Object]%
+ {Caption vertically centered left beside the float with a caption width
+ of \texttt{capWidth=h}, which is the height of the object.}{fig:2}
+
+It is no problem to rotate the object, too. But with a different angle value than for the caption.
+Do not ask for the sense, it is only a demonstration of what is possible \ldots\ The object (image)
+is rotated by $-30$ degrees with the macro \Lcs{rotatebox}. Without any definition the caption will be
+placed vertically centered to the object. Important for the height of the object is the surrounding
+orthogonal rectangle.
+
+
+\blindtext
+
+Code for figure \ref{fig:3}:
+\begin{lstlisting}
+\hvFloat[%
+ capWidth=h,
+ capPos=after,
+ capAngle=180,
+ objectAngle=90,
+ capVPos=center,
+ objectPos=center]{figure}{\frame{\includegraphics{images/rose}}}%
+ [Centered Caption beside Object]{%
+ {Caption vertically centered right beside the float with a caption width of the height
+ of the image and a rotation of the caption and the object.}{fig:3}
+\end{lstlisting}
+
+
+\Float
+\hvFloat[%
+ capWidth=h,% of \columnwidth
+ capPos=after,
+ capAngle=180,
+ objectAngle=90,
+ capVPos=center,
+ objectPos=center]{figure}{\frame{\includegraphics{images/rose}}}%
+ {Caption vertically centered right beside the float with a caption width of the height of the image and
+ a rotation of the caption and the object.}{fig:3}
+
+
+\section{Caption inner or outer}
+Setting the caption position to \emph{inner} or \emph{outer} makes only sense for a document in \Index{twoside} mode.
+For a oneside document \emph{inner} is the same as \emph{left} and \emph{outer} is
+the same as \emph{right}. We show only the code for the first image with the setting \Lkeyset{capPos=inner},
+whereas the second one
+chooses only \Lkeyset{capPos=outer}.
+
+
+Code for figure~\ref{fig:20}:
+\begin{lstlisting}
+\hvFloat[capPos=inner]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption on the inner side]{%
+ Caption set with the parameter setting \texttt{capPos=inner}, which will be
+ a caption on the right side for an even page and on the left side for
+ an odd page.}{fig:20}
+\end{lstlisting}
+
+\Float[capPos=inner]
+\hvFloat[capPos=inner]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption on the inner side]{%
+ Caption set with the parameter setting \texttt{capPos=inner}, which will be
+ a caption on the right side for an even page and on the left side for
+ an odd page.}{fig:20}
+
+\blindtext
+
+
+\label{page:1}\checkoddpage
+Now the same Image with \Lkeyset{capPos=outer}. The current pagenumber is~\pageref{page:1}, an \ifoddpage odd \else
+even \fi page. We now set a pagebreak at the end of the second image to see if it works with
+\emph{inner}/\emph{outer}.
+
+
+
+
+\begin{lstlisting}
+\hvFloat[capPos=outer]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption on the inner side]{%
+ Caption set with the parameter setting \texttt{capPos=outer}, which will be
+ a caption on the right side for an even page and on the left side for
+ an odd page.}{fig:20b}
+\end{lstlisting}
+
+\Float[capPos=outer]
+\hvFloat[capPos=outer]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption on the inner side]{%
+ Caption set with the parameter setting \texttt{capPos=outer}, which will be
+ a caption on the right side for an even page and on the left side for
+ an odd page.}{fig:20b}
+
+
+
+
+\Float
+\hvFloat[%
+ capWidth=0.5,% of \columnwidth
+ capPos=outer,
+ capAngle=0,%
+ capVPos=bottom,%
+ objectPos=center]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption beside Object]{%
+ Caption at the bottom right beside the float with a caption width
+ of \texttt{0.5\textbackslash columnwidth} and and \texttt{capPos=outer}.}{fig:21}
+
+We have an \checkoddpage
+\ifoddpage odd \else
+even \fi page, the reason why figure~\ref{fig:20b} has the caption for \emph{inner} on the left side
+and figure~\ref{fig:21} for \emph{outer} on the right side.
+
+
+\blindtext
+
+\label{page:2}
+Code for figure \ref{fig:22}:
+\begin{lstlisting}
+\hvFloat[%
+ capWidth=0.5,% of \columnwidth
+ capPos=inner,% ====> INNER
+ capAngle=0,
+ capVPos=bottom,
+ objectPos=center]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption beside Object]{%
+ Caption vertically centered right beside the float with a caption
+ width of \texttt{0.5\textbackslash columnwidth} and \texttt{capPos=outer} }{fig:22}
+\end{lstlisting}
+
+\Float
+\hvFloat[%
+ capWidth=0.5,% of \columnwidth
+ capPos=inner,
+ capAngle=0,%
+ capVPos=center,%
+ objectPos=center]{figure}{\includegraphics{images/rose}}%
+ [Centered Caption beside Object]{%
+ Caption vertically centered right beside the float with a caption
+width of \texttt{0.5\textbackslash columnwidth} and \texttt{capPos=outer}}{fig:22}
+
+
+
+We have an \checkoddpage
+\ifoddpage odd \else
+even \fi page, the reason why figure~\ref{fig:20} has the caption for \emph{inner} on the right side
+and figure~\ref{fig:21} for \emph{outer} on the left side.
+
+
+\section{Vertical Position of the Caption}
+The caption can be placed beside the object in the positions
+\begin{verbatim}
+(c)enter|(b)ottom|(t)op
+\end{verbatim}
+
+The code for figure \ref{fig:4}:
+\begin{lstlisting}
+\hvFloat[%
+ floatPos=htb,%
+ capWidth=0.25,%
+ capPos=right,%
+ capVPos=bottom,%
+]{figure}{\frame{\includegraphics{images/rose}}}{Caption at bottom right beside the float}{fig:4}
+\end{lstlisting}
+
+
+\Float
+\hvFloat[%
+ floatPos=htb,%
+ capWidth=0.25,%
+ capPos=right,%
+ capVPos=bottom,%
+]{figure}{\frame{\includegraphics{images/rose}}}{Caption at bottom right beside the float}{fig:4}
+
+
+
+The code for figure \ref{fig:5}:
+\begin{lstlisting}
+\hvFloat[%
+ floatPos=htb,
+ capWidth=0.25,
+ capPos=right,
+ capVPos=top,
+]{figure}{\frame{\includegraphics{images/rose}}}{Caption at top left beside the float}{fig:5}
+\end{lstlisting}
+
+
+\Float
+\hvFloat[%
+ floatPos=htb,%
+ capWidth=0.25,%
+ capPos=before,%
+ capVPos=top,%
+]{figure}{\frame{\includegraphics{images/rose}}}{Caption at top left beside the float}{fig:5}
+
+
+The code for figure \ref{fig:6}:
+\begin{lstlisting}
+\hvFloat[%
+ capWidth=0.25,
+ capPos=right,
+ capVPos=center,% the default
+]{figure}{\frame{\includegraphics{images/rose}}}{Caption centered right beside the float}{fig:6}
+\end{lstlisting}
+
+
+\Float
+\hvFloat[%
+ capWidth=0.25,%
+ capPos=right,%
+ capVPos=center,% the default
+]{figure}{\frame{\includegraphics{images/rose}}}{Caption centered right beside the float}{fig:6}
+
+
+\section{Caption format}
+The \Lcs{caption} and \Lcs{subcaption} macros are fully under the control of the package \Lpack{caption}.
+The formatting can be set with the macros \Lcs{captionsetup}, \Lcs{subcaptionsetup}, or via the optional
+argument setting of \Lcs{hvFloat} with the keywords \Lkeyword{capFormat} and \Lkeyword{subcapFormat}.
+The argument itself will then be used internally by \Lcs{captionsetup} and/or \Lcs{subcaptionsetup}
+in a minipage, the reason why it will be local to the current image..
+
+\begin{lstlisting}
+\hvFloat[%
+ capPos=right,
+ capFormat={labelsep=newline,justification=RaggedRight,font={small,it},labelfont=bf}
+]{figure}{\frame{\includegraphics{images/rose}}}{\blindtext}{fig:66}
+\end{lstlisting}
+
+\Float
+\hvFloat[%
+ capPos=right,
+ capFormat={labelsep=newline,justification=RaggedRight,font={small,it},labelfont=bf}
+]{figure}{\frame{\includegraphics{images/rose}}}{\blindtext}{fig:66}
+
+
+\section{Horizontal Position of the Float}
+
+The caption is always near the object, only divided by the length \Ldim{floatCapSep}
+which can be set by the keyword of the same name \Lkeyword{floatCapSep}. It accepts only
+a value with any allowed unit. %The default unit is \texttt{pt} and cannot be changed.
+The keyword \Lkeyword{objectPos} refers always to the complete floating object: caption
+\emph{and} object. The meaning of \Lkeyset{objectPos=left} is: Put the object as far as possible to the
+left margin. If \Lkeyset{capPos=left} is also used, then the caption is at the left margin followed by
+the object (see Figure~\vref{fig:700}).
+
+The code for figure \ref{fig:7}:
+\begin{lstlisting}
+\hvFloat[%
+ capWidth=0.25,
+ capPos=right,
+ capVPos=top,
+ objectPos=left,
+ objectFrame,
+]{figure}{\includegraphics{images/rose}}{%
+ Caption at top right beside the float and object position left}{fig:7}
+\end{lstlisting}
+
+
+\Float
+\hvFloat[%
+ capWidth=0.25,%
+ capPos=right,%
+ capVPos=top,%
+ objectPos=left,%
+ objectFrame,
+]{figure}{\includegraphics{images/rose}}{%
+ Caption at top right beside the float and object position left}{fig:7}
+
+\blindtext
+
+
+The same with \Lkeyset{capPos=left}:
+
+
+\Float[capPos=left]
+\hvFloat[%
+ capWidth=0.25,%
+ capPos=left,%
+ capVPos=top,%
+ objectPos=left,%
+ objectFrame,
+]{figure}{\includegraphics{images/rose}}{%
+ Caption at top right beside the float and object position left}{fig:700}
+
+\blindtext
+
+
+The code for figure \ref{fig:8}:
+\begin{lstlisting}
+\hvFloat[%
+ capWidth=0.25,
+ capPos=before,
+ capVPos=top,
+ objectPos=right,
+ objectFrame,
+]{figure}{\includegraphics{images/rose}}{%
+ Caption at top leftt beside the float and object position right}{fig:8}
+\end{lstlisting}
+
+
+\Float
+\hvFloat[%
+ capWidth=0.25,%
+ capPos=before,%
+ capVPos=top,%
+ objectPos=right,%
+ objectFrame,
+]{figure}{\includegraphics{images/rose}}{%
+ Caption at top left beside the float and object position right}{fig:8}
+
+\blindtext
+
+
+\section{Wide floats}
+
+With the optional argument \Lkeyword{wide} the width of the defined \Ldim{marginparwidth} is
+added to the allowed horizontal width of the float.
+
+The code for figure \ref{fig:70}:
+\begin{lstlisting}
+\hvFloat[wide,
+ capPos=right,
+ capVPos=top,
+ objectPos=left,
+]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}{%
+ Caption at top right beside the float and object position left and
+the option \texttt{wide}.}{fig:70}
+\end{lstlisting}
+
+%\Float
+\hvFloat[%
+ wide,
+ capPos=right,%
+ capVPos=top,%
+ objectPos=left,%
+]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}{%
+ Caption at top right beside the float and object position left and
+the option \texttt{wide}.}{fig:70}
+
+%\blindtext
+
+
+The code for figure \ref{fig:80}:
+\begin{lstlisting}
+\hvFloat[wide,
+ capPos=left,
+ capVPos=top,
+ objectPos=right,
+ ]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}%
+ {Caption at top left beside the object and object position left and
+ the option \texttt{wide}.}{fig:80}
+\end{lstlisting}
+
+
+%\Float
+\hvFloat[wide,
+ capPos=left,%
+ capVPos=top,%
+]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}%
+ {Caption at top left beside the object and object position left and
+ the option \texttt{wide}.}{fig:80}
+
+
+For a twosided document it will place the object always in the margin.
+
+\blindtext
+
+\begin{lstlisting}
+\hvFloat[wide,
+ capPos=inner,
+ capVPos=top,
+]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}{%
+Caption at top and inner beside the float and object position right and
+the option \texttt{wide}.}{fig:81}
+\end{lstlisting}
+
+%\Float[capPos=outer]
+
+\hvFloat[wide,
+ capPos=inner,
+ capVPos=top,
+]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}{%
+Caption at top and inner beside the float and object position right and
+the option \texttt{wide}.}{fig:81}
+
+Now we set the same image with the same setting on the next page. The caption will
+change its side due to the setting \Lkeyset{capPos=outer}.
+
+\blindtext
+
+
+
+\begin{lstlisting}
+\hvFloat[wide,
+ capPos=inner,
+ capVPos=top,
+]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}{%
+Caption at top inner beside the float and object position right and
+the option \texttt{wide}.}{fig:811}
+\end{lstlisting}
+
+%\Float[capPos=outer]
+
+\hvFloat[wide,
+ capPos=inner,
+ capVPos=top,
+]{figure}{\includegraphics[width=0.75\linewidth]{images/CTAN}}{%
+Caption at top inner beside the float and object position right and
+the option \texttt{wide}.}{fig:811}
+
+The caption can be typeset completely into the margin with:
+
+\begin{lstlisting}
+\captionsetup{justification=RaggedRight}
+\hvFloat[wide,
+ capPos=outer,
+ capVPos=top,
+ floatCapSep=\marginparsep,
+]{figure}{\includegraphics[width=\linewidth]{images/CTAN}}{%
+Caption at top inner beside the float and object position right and
+the option \texttt{wide}.}{fig:812}
+\end{lstlisting}
+
+%\Float[capPos=outer]
+
+\begingroup
+\captionsetup{justification=RaggedRight}
+\hvFloat[wide,
+ capPos=outer,
+ capVPos=top,
+ floatCapSep=\marginparsep,
+]{figure}{\includegraphics[width=\linewidth]{images/CTAN}}{%
+Caption at top inner beside the float and object position right and
+the option \texttt{wide}.}{fig:812}
+\endgroup
+
+
+
+\section{The star version \Lcs{hvFloat*}}\label{star-version0}
+In the \Index{twocolumn} mode the floating environment can be set over both
+columns with the star version \Lcs{hvFloat*}. The floating environment will
+not be on the bottom of the page. The code for
+the following example (Figure~\vref{default1s2c}) is:
+
+\begin{lstlisting}
+\hvFloat*[capPos=right]{figure}%
+ {\includegraphics{images/frose}}%
+ [A float with the default caption setting]%
+ {A default caption of a ``'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:0}
+\end{lstlisting}
+
+The example shows on page 3 the star version and on page 4 the same without using the star.
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/default1s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/default1s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/default1s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/default1s2c}}
+\caption{Output of \texttt{default1s2c} (pages 2 --5)}\label{default1s2c}
+\end{figure}
+
+
+
+
+\section{Full Page Width in Landscape Mode}
+
+If you do not want to load the package \Lpack{lscape} (or \Lpack{pdflscape}) you can use the \Lkeyset{floatPos=p}
+option to put the image on an own page and rotated by 90 degrees (figure~\ref{fig:9}).
+
+
+
+
+Code for figure \ref{fig:9}:
+\begin{lstlisting}
+\hvFloat[%
+ floatPos=p,
+ capPos=bottom,
+ rotAngle=90,
+ objectPos=center,
+]{figure}{\includegraphics[width=0.9\textheight]{images/CTAN}}%
+ [Object and Caption in landscape mode]{%
+ Caption and object in landscape mode. \blindtext}{fig:9}
+\end{lstlisting}
+
+The float can also be put to the left or to the right (above/below in landscape)
+with the \Lkeyset{objectPos=l} parameter
+
+\Float[landscape]
+\hvFloat[%
+ floatPos=p,
+ capPos=bottom,
+ rotAngle=90,
+ objectPos=center,
+]{figure}{\includegraphics[width=0.9\textheight]{images/CTAN}}%
+ [Object and Caption in landscape mode]{%
+ Caption and object in landscape mode. \blindtext}{fig:9}
+
+
+\blindtext
+
+
+The code for figure \ref{fig:10}:
+\begin{lstlisting}
+\hvFloat[%
+ floatPos=p,
+ capWidth=h,
+ capPos=right,
+ objectAngle=90,
+ capAngle=-90,
+ objectPos=left,
+]{figure}{\includegraphics[width=\textheight]{images/CTAN}}%
+ [Rotated Caption in Landscape]{%
+ Caption right beside the float and object position left. The caption rotated by $-90$
+ degrees.\blindtext}{fig:10}
+\end{lstlisting}
+
+\Float
+\hvFloat[%
+ floatPos=p,%
+ capWidth=h,%
+ capPos=right,%
+ objectAngle=90,%
+ capAngle=-90,%
+ objectPos=left%
+]{figure}{\includegraphics[width=\textheight]{images/CTAN}}%
+ [Rotated Caption in Landscape]{%
+ Caption right beside the float and object position left. The caption rotated by $-90$ degrees.
+ \blindtext}{fig:10}
+
+
+
+\blindtext
+
+\blindtext
+
+
+
+\section{The \Lkeyword{nonFloat} Option}
+Sometimes it is better to put a ``float'' in a specific position of the page. This is possible
+with the \Lpack{nonfloat} package and the keyword \Lkeyword{nonFloat}.
+
+\begin{lstlisting}
+Some nonsense text before the following \emph{non floating} object.
+
+\hvFloat[%
+ nonFloat,
+ capWidth=0.25,
+ capPos=right,
+ capVPos=bottom,
+ objectPos=center,
+ objectFrame,
+]{figure}{\includegraphics[scale=1.5]{images/rose}}%
+ [Nonfloat Captions]{%
+ Caption of a ``nonfloat'' Object, using the \texttt{nonfloat} Package}{fig:11}
+
+Some nonsense text after the preceding \emph{non floating} object.
+\end{lstlisting}
+
+\Float
+Some nonsense text before the following \emph{non floating} object.
+
+\hvFloat[%
+ nonFloat,%
+ capWidth=0.25,%
+ capPos=right,%
+ capVPos=bottom,%
+ objectPos=center,%
+ objectFrame,
+]{figure}{\includegraphics[scale=1.5]{images/rose}}%
+ [Nonfloat Captions]{%
+ Caption of a ``nonfloat'' Object, using the \texttt{nonfloat} Package}{fig:11}
+
+Some nonsense text after the preceding \emph{non floating} object.
+
+\bigskip
+The image \ref{fig:11} is exactly placed where the command \Lcs{hvFloat} appears.
+There are only commands for \Lenv{figure} and \Lenv{table} environments:
+
+\begin{verbatim}
+\newcommand{\figcaption}{\def\@captype{figure}\caption}
+\newcommand{\tabcaption}{\def\@captype{table}\caption}
+\end{verbatim}
+
+But it is no problem, to define more \texttt{xxxcaption} commands to support other with the
+\Lpack{float} package defined new floats.
+
+
+
+
+
+\section{Tabulars as Objects}\label{sec:tables}
+The object has to be passed as an parameter to the \Lcs{hvFloat} macro. This is no
+problem with images but maybe with tables, so it is easier to use the box \Lcs{hvOBox}
+to save the table in this box and pass it then to \Lcs{hvFloat} with the \Lkeyword{useOBox} option.
+For example see table~\ref{table:1} and \ref{table:2}:
+
+\savebox{\hvOBox}{%
+ \begin{tabular}{>{\small\ttfamily}l|l|l}\hline
+ \rmfamily Name & Type & Description\\\hline
+ \CMD{hvFloat} & command & places object and caption in different ways\\
+ hvFloatEnv & environment & places object and caption exactly Here\\
+ \CMD{figcaption} & command & writes a figure caption in a non floating environment\\
+ \CMD{tabcaption} & command & writes a table caption in a non floating environment\\
+ \CMD{setDefaults} & command & sets all options to the defaults\\\hline
+ \end{tabular}%
+}
+
+\blindtext
+
+%[xrightmargin=-8em,xleftmargin=-1em]
+\begin{lstlisting}
+\savebox{\hvOBox}{%
+ \begin{tabular}{>{\small\ttfamily}l|l|l}\hline
+ \rmfamily Name & Type & Description\\\hline
+ \CMD{hvFloat} & command & places object and caption in different ways\\
+ hvFloatEnv & environment & places object and caption exactly Here\\
+ \CMD{figcaption} & command & writes a figure caption in a non floating environment\\
+ \CMD{tabcaption} & command & writes a table caption in a non floating environment\\
+ \CMD{setDefaults} & command & sets all options to the defaults\\\hline
+ \end{tabular}%
+}
+\end{lstlisting}
+
+The code for table \ref{table:1} and \ref{table:2} is:
+
+%[xrightmargin=-7em,xleftmargin=-3em]
+\begin{lstlisting}
+\hvFloat[%
+ floatPos=!hb,
+ capPos=top,
+ useOBox=true]{table}{}{Demonstration of the \texttt{useOBox} Parameter}{table:1}
+
+\blindtext
+
+\hvFloat[%
+ floatPos=hb,
+ useOBox=true,
+ objectAngle=90,
+ capPos=right,
+ capVPos=top,
+ capWidth=0.3]{table}{}{Another demonstration of the \texttt{useOBox} Parameter}{table:2}
+\end{lstlisting}
+
+In this case leave the third parameter empty.
+
+\Float
+\hvFloat[%
+ floatPos=!hb,
+ capPos=top,
+ useOBox=true]{table}{}{Demonstration of the \texttt{useOBox} Parameter}{table:1}
+
+
+
+\Float
+\hvFloat[%
+ floatPos=!htb,%
+ useOBox=true,%
+ objectAngle=90,%
+ capPos=right,%
+ capVPos=top,%
+ capWidth=0.3]{table}{}{Demonstration of the \texttt{useOBox} Parameter}{table:2}
+
+
+\section{Text and objects}\label{sec:text}
+
+With the \Lkeyword{onlyText} keyword it is no problem to put some text beside an image without
+getting the caption title Figure/Table. The object still can be a floating one or a nonfloating
+if the \Lkeyword{nonfloat} keyword is used.
+
+The code for figure \ref{fig:text}:
+
+\begin{lstlisting}
+\hvFloat[%
+ onlyText=true,
+ capAngle=90,
+ capPos=right,
+ capVPos=top,
+ objectFrame,
+ capWidth=h]{}{\includegraphics{images/rose}}%
+ [``\texttt{onlyText}'' Caption]{%
+ Demonstration of the \texttt{onlyText} Parameter, which makes it
+ possible to put some text beside a floating object without getting
+ a starting \texttt{Figure:} or \texttt{Table:}}{fig:text}
+\end{lstlisting}
+
+
+\Float
+\hvFloat[%
+ onlyText=true,%
+ capAngle=90,%
+ capPos=right,%
+ capVPos=top,%
+ objectFrame,
+ capWidth=h]{}{\includegraphics{images/rose}}%
+ [``\texttt{onlyText}'' Caption]{%
+ Demonstration of the \texttt{onlyText} Parameter, which makes it
+ possible to put some text beside a floating object without getting
+ a starting \texttt{Figure:} or \texttt{Table:}}{fig:text}
+
+\bigskip
+%\blindtext
+
+%\blindtext
+
+\section{Environment \texttt{hvFloatEnv}}\label{sec:env}
+
+With the environment \Lenv{hvFloatEnv} one can place an object exactly on that position where the
+environment is defined. For captions the use of \Lcs{captionof} is recommended:
+
+\begin{lstlisting}
+\begin{hvFloatEnv}
+\captionof{table}{A caption for a nice table}
+\begin{tabular}{@{} l c r @{}}\hline
+left & center & right \\
+L & C & R \\\hline
+\end{tabular}
+\end{hvFloatEnv}
+\end{lstlisting}
+
+\begin{hvFloatEnv}
+\captionof{table}{A caption for a nice table}
+\begin{tabular}{@{} l c r @{}}\hline
+left & center & right \\
+L & C & R \\\hline
+\end{tabular}
+\end{hvFloatEnv}
+
+
+\bigskip
+The environment has an optional argument for setting the line width which is preset to \Ldim{textwidth}.
+The object is always centered.
+
+
+\begin{lstlisting}
+\begin{hvFloatEnv}[0.5\textwidth]
+\captionof{table}{A caption for a nice table}
+\begin{tabular}{@{} l c r @{}}\hline
+left & center & right \\
+L & C & R \\\hline
+\end{tabular}
+\end{hvFloatEnv}
+\end{lstlisting}
+
+
+\begin{hvFloatEnv}[0.5\textwidth]
+\captionof{table}{A caption for a nice table}
+\begin{tabular}{@{} l c r @{}}\hline
+left & center & right \\
+L & C & R \\\hline
+\end{tabular}
+\end{hvFloatEnv}
+
+%\bigskip
+%\blindtext
+
+%\blindtext
+
+
+\section{Full page objects in onecolumn mode}
+For an image or table which needs the whole space of a page the caption can be
+printed at the bottom of the preceeding or following page. It is possible in
+oneside and twoside mode, but makes only real sense in the twoside mode.
+%
+\Lpack{hvfloat} defines three additional optional arguments for placing
+images in a complete column, page or paper:
+
+\noindent
+\minipage[t]{0.49\linewidth}
+\begin{verbatim}
+\define@key{Gin}{fullpage}[true]{%
+ \def\Gin@ewidth{\columnwidth}%
+ \def\Gin@eheight{\textheight}%
+ \Gin@boolkey{false}{iso}%
+}
+\define@key{Gin}{FULLPAGE}[true]{%
+ \def\Gin@ewidth{\paperwidth}%
+ \def\Gin@eheight{\paperheight}%
+ \Gin@boolkey{false}{iso}%
+}
+\end{verbatim}
+\endminipage\hfill
+\minipage[t]{0.49\linewidth}
+\begin{verbatim}
+\define@key{Gin}{FullPage}[true]{%
+ \def\Gin@ewidth{\textwidth}%
+ \def\Gin@eheight{\textheight}%
+ \Gin@boolkey{false}{iso}%
+}
+\end{verbatim}
+\endminipage
+
+Figure~\vref{fig:fullpage60} shows the meaning of the optional arguments \Lkeyword{fullpage},
+\Lkeyword{FullPage}, and \Lkeyword{FULLPAGE} for \Lcs{inclugegraphics}\OptArg{...}\Largb{tiger}.
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=1,width=0.24\linewidth]{examples/fullpage1s2c}}\hfill
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/fullpage1s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/fullpage1s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/fullpage1s2c}}
+
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/fullpage1s2c}}\hfill
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/fullpage1s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/fullpage1s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/fullpage1s2c}}
+\caption{Output of \texttt{fullpage1s2c} (pages 1--8)}\label{fig:fullpage60}
+\end{figure}
+
+
+
+
+
+\subsection{Using the textarea}
+
+The setting \Lkeyset{capPos=evenPage} (even) or \Lkeyset{capPos=oddPage} (odd) page for
+a document in \Index{twocolumn} mode makes no real sense. For a twosided document a
+setting like \Lkeyset{capPos=inner} for inner or \Lkeyset{capPos=outer} for outer
+margin makes more sense.
+%
+For an image or table which needs the whole space of a page the caption can be
+printed at the bottom of the preceeding or following page. It is possible in
+oneside and twoside mode, but makes only real sense in the twoside mode.
+Without any additional argument the caption is set first and the object on the follwing page:
+
+
+
+\subsubsection{Using the default or \Lkeyset{capPos=before}}
+
+Without any additional argument the caption is set first (left) at the bottom of the current page
+and the object on the following page. This is the same setting like \Lkeyset{capPos=left} for a onecolumn document.
+For the \Loption{twocolumn} option it makes more sense to use the setting \Lkeyset{capPos=before} if the
+caption and object can appear on different pages.
+
+
+
+
+\begin{lstlisting}
+\hvFloat[fullpage]%
+ {figure}%
+ {\includegraphics[fullpage]{images/frose}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears ``before'' the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+
+
+
+
+\begin{table}[!h]
+\caption{Valid optional arguments for a full page object.}\label{tab:fullpage}
+\centering
+ \begin{tabularx}{\linewidth}{>{\small\ttfamily}l|>{\small\ttfamily}l|X}\toprule
+ \rmfamily Name & \rmfamily Type & Description\\\midrule
+\Lkeyword{fullpage} & true|false & Put the caption on the bottom of the preceding or following page and the object alone a page.\\
+
+%\Lkeyword{FullPage} & true|false & The same for \Index{twocolumn} mode with object over both columns.\\
+
+\Lkeyword{FULLPAGE} & true|false & The same for full papersize objects over one or two columns.
+The pagestyle is set to \texttt{empty}\\
+
+\Lkeyword{multiFloat} & true|false & For multiple objects with captions for every object. See section~\vref{sec:multifloats}.\\
+
+\Lkeyword{subFloat} & true|false & For multiple objects with one main and more subcaptions. See section~\vref{sec:subfloats}.\\
+
+\Lkeyword{separatorLine} & true & Put a line with a predefined width of 0.4pt between
+ the text and the caption. Only valid for the keyword \Lkeyword{fullpage}.\\
+\Lkeyword{capPos} & value
+ & caption \Lkeyval{before}, \Lkeyval{after} an object or on an
+ \Lkeyval{evenPage} or \Lkeyval{oddPage}.\\
+\bottomrule
+ \end{tabularx}%
+\end{table}
+
+
+
+
+With this setting the caption is always placed \textit{before} the following object.
+This maybe sufficient for a \Index{oneside} document but not the best solution if
+this document is printed on a duplex machine. In such a case
+it may make sense to have the captions always on an even (left) page, even though the
+socument is typeset in a oneside mode. Figure~\vref{fig:fullpage0} shows the output
+for a oneside document with a setting \Lkeyset{capPos=before}.
+
+
+
+Depending to the
+used documentclass it can be a problem, if the caption should be placed on the first page.
+In such a case use one of the other setting.
+Table~\vref{tab:fullpage} shows the valid optional arguments for a full page floating object.
+
+
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/default1s1c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/default1s1c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/default1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/default1s1c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/default1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/default1s1c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/default1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/default1s1c}}
+\caption{Output of \texttt{default1s1c} (pages 2--9)}\label{fig:fullpage0}
+\end{figure}
+
+
+
+
+
+
+%\FloatBarrier
+
+\clearpage
+
+\subsubsection{Using \Lkeyset{capPos=after}}
+
+The caption will be printed always on the right side which is the same as \textit{after} the full page object.
+The object appers immediately on the next page and the caption of the next following page at the bottom. There
+is no check for an even or odd page. This behaviour makes only sense for a oneside document.
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=after]%
+ {figure}%
+ {\includegraphics[fullpage]{images/frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption of a ``fullpage'' object, which follows on the next page.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage1}
+\end{lstlisting}
+
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/after1s1c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/after1s1c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/after1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/after1s1c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/after1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/after1s1c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/after1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/after1s1c}}
+\caption{Output of \texttt{after1s1c} (pages 2--9)}\label{after1s1c}
+\end{figure}
+
+
+%\FloatBarrier
+
+\clearpage
+
+\subsubsection{Using \Lkeyset{capPos=evenPage} --- caption on an even page}
+
+With \Lkeyset{capPos=evenPage} the caption will be printed on an even (left) page,
+the object will always be on an odd (right) page.
+This option makes only real sense for The \Loption{twoside} mode!
+
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=evenPage]%
+ {figure}%
+ {\includegraphics[fullpage]{images/frose}}%
+ [A float whith a caption on an even page (left)]%
+ {A caption on an even (left) page of a ``fullpage'' object.. \blindtext}
+ {fig:fullpage3}
+\end{lstlisting}
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/even1s1c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/even1s1c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/even1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/even1s1c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/even1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/even1s1c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/even1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/even1s1c}}
+\caption{Output of \texttt{even1s1c} (pages 2--9)}\label{fig:fullpage6}
+
+\end{figure}
+
+
+%\FloatBarrier
+\clearpage
+
+
+\subsubsection{Using \Lkeyset{capPos=oddPage} --- caption on an odd page}
+
+With \Lkeyset{capPos=oddPage} the caption will be printed on an odd (right) page, the object will always be on an even (left) page,
+which is before the caption.
+%This option makes only sense for The \Loption{twoside} mode!
+
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=oddPage]%
+ {figure}%
+ {\includegraphics[fullpage]{images/frose}}%
+ [A float which needs the complete page width and height.]%
+ {A Caption on an odd page of a ``fullpage'' object, which follows on the next page.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}
+ {fig:fullpage2}
+\end{lstlisting}
+
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/odd1s1c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/odd1s1c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/odd1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/odd1s1c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/odd1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/odd1s1c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/odd1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/odd1s1c}}
+\caption{Output of \texttt{odd1s1c} (pages 2--9)}\label{fig:fullpage10}
+\end{figure}
+
+\iffalse
+\begin{figure}
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/odd2s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/odd2s1c}}\hfill
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/odd2s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/odd2s1c}}
+
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/odd2s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/odd2s1c}}\hfill
+\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/odd2s1c}}\hfill
+\frame{\includegraphics[page=11,width=0.24\linewidth]{examples/odd2s1c}}
+\caption{Output of \texttt{odd2s1c} (pages 4--11)}\label{fig:fullpage12}
+\end{figure}
+\fi
+
+\FloatBarrier
+
+
+\subsubsection{Using \Lkeyset{capPos=inner} or \Lkeyset{capPos=outer}--- caption on the inner or outer side}
+
+These settings make no sense in \Index{onecolumn} mode.
+
+
+\subsection{Using the paper size}
+
+It belongs to the user to create an object which fills the complete page. However, with the
+keyword \Lkeyword{FULLPAGE} which is valis for \Lcs{hvfloat} \emph{and}
+for the macro \Lcs{includegraphics} an image will be scaled to
+the paper dimensions \Ldim{paperwidth} and
+\Ldim{paperheight}. It can be used in one- and twocolumn mode!
+
+\begin{lstlisting}
+\hvFloat[FULLPAGE]%
+ {figure}%
+ {\includegraphics[FULLPAGE]{frose.png}}%
+ [A fullpage float with the default caption setting]%
+ {A default caption of a ``fullpage'' object with the default setting, which
+ is a ``left'' caption which means that it always appears before the object.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {fig:fullpage0}
+\end{lstlisting}
+
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/paper-default1s1c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/paper-default1s1c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/paper-default1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/paper-default1s1c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/paper-default1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/paper-default1s1c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/paper-default1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/paper-default1s1c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/paper-default1s1c}}
+\caption{Output of \texttt{paper-default1s1c} (pages 2--9)}\label{paper-default1s1c}
+\end{figure}
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/paper-after1s1c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/paper-after1s1c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/paper-after1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/paper-after1s1c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/paper-after1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/paper-after1s1c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/paper-after1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/paper-after1s1c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/paper-after1s1c}}
+\caption{Output of \texttt{paper-after1s1c} (pages 2--9)}\label{paper-after1s1c}
+\end{figure}
+
+
+\FloatBarrier
+
+
+
+\subsection{Multifloats}\label{sec:multifloats}
+Multifloats is the name for more than one image and/or tabular in \emph{one} floating
+environment. Every image and/or tabular has its own caption, which is different to
+a subcaption. The syntax for multiple floats is
+
+\begin{BDef}
+\Lcs{hvFloat}\OptArgs&+\Largb{float type}\Largb{floating object}\OptArg{short caption}\Largb{long caption}\Largb{label}\\
+&+\Largb{float type}\Largb{floating object}\OptArg{short caption}\Largb{long caption}\Largb{label}\\
+&+\ldots\\
+&+\Largb{float type}\Largb{floating object}\OptArg{short caption}\Largb{long caption}\Largb{label}
+\end{BDef}
+
+The + symbol defines an additional Object which will be part of the same floating environment.
+It's up too the user to be sure that one page or one column can hold all defined objects.
+Every object gets its own caption which is the reason why figures and tabulars and \ldots\
+can be mixed:
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,capPos=before,multiFloat]%
+ +{figure}{\includegraphics[width=\linewidth]{images/CTAN}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {img:demo0}%
+ +{table}{\begin{tabular}{lrcp{3cm}}\hline % no 2
+ Linksbündig & Rechtsbündig & Zentriert & Parbox\\\hline
+ L & R & C & P\\
+ left & right & center & Text with possible linebreaks\\
+ \multicolumn{4}{c}{Multicolumn over all columns}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[width=\linewidth]{images/CTAN}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo1}
+ +{figure}{\includegraphics[width=\linewidth]{images/CTAN}}%% no 4
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {img:demo2}
+\end{lstlisting}
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/multi-default1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/multi-default1s1c}}\hfill
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/multi-default1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/multi-default1s1c}}
+
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/multi-default1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/multi-default1s1c}}\hfill
+\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/multi-default1s1c}}\hfill
+\frame{\includegraphics[page=11,width=0.24\linewidth]{examples/multi-default1s1c}}
+\caption{Output of \texttt{multi-default1s1c} (pages 4--11)}\label{multi-default1s1c}
+\end{figure}
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/multi-after1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/multi-after1s1c}}\hfill
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/multi-after1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/multi-after1s1c}}
+
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/multi-after1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/multi-after1s1c}}\hfill
+\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/multi-after1s1c}}\hfill
+\frame{\includegraphics[page=11,width=0.24\linewidth]{examples/multi-after1s1c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/odd1s2c}}
+\caption{Output of \texttt{multi-after1s1c} (pages 4--11)}\label{multi-after1s1c}
+\end{figure}
+
+
+
+
+
+The page with the objects has no additional informations it holds only the figures and/or tabulars.
+If you want it like subfigures or subtabulars then go to section~\vref{sec:subfloats}. The setting
+\Lcs{captionsetup}\Largb{\Lkeyset{singlelinecheck=false}} is needed if you want the captions always
+left aligned.
+
+
+\FloatBarrier
+
+
+\section{Subfloat page}\label{sec:subfloats}
+A subfloat page can have only one type of floats which will have one main caption and
+individual subcaptions. The syntax is similiar to the one for a multifloat page:
+
+
+\begin{BDef}
+\Lcs{hvFloat}\OptArgs&+\Largb{float type}\Largb{<empty>}\OptArg{short caption}\Largb{long caption}\Largb{label}\\
+&+\Largb{<empty>}\Largb{floating object}\OptArg{short caption}\Largb{long caption}\Largb{label}\\
+&+\ldots\\
+&+\Largb{<empty>}\Largb{floating object}\OptArg{short caption}\Largb{long caption}\Largb{label}
+\end{BDef}
+
+Some arguments are ignored for a subfloat, one can leave them empty. The first line defines only the type and the main caption,
+the object entry is ignored! All aditional lines will have the same float type, the reason why the
+float type entry is ignored.
+
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=before,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo0}%
+ +{}{\includegraphics[width=\linewidth]{images/CTAN}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[width=\linewidth]{images/CTAN}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo1}
+ +{}{\includegraphics[width=\linewidth]{images/CTAN}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo2}
+ +{}{\includegraphics[width=\linewidth]{images/CTAN}}%
+ {A Caption E of a ``fullpage'' object}%
+ {sub:demo3}
+\end{lstlisting}
+
+
+The keyword \Lkeyword{subFloat} defines the images or tabulars as subfloats.
+The package \Lpack{subcaption} is loaded by default and should be activated with
+\Lcs{captionsetup}\Largs{sub}\Largs{\Lkeyword{singlelinecheck}}.
+
+
+
+\begin{figure}[p]
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/sub-default1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/sub-default1s1c}}\hfill
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/sub-default1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/sub-default1s1c}}
+
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/sub-default1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/sub-default1s1c}}\hfill
+\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/sub-default1s1c}}\hfill
+\frame{\includegraphics[page=11,width=0.24\linewidth]{examples/sub-default1s1c}}
+\caption{Output of \texttt{sub-default1s1c} (pages 4--11)}\label{sub-default1s1c}
+
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/sub-after1s1c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/sub-after1s1c}}\hfill
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/sub-after1s1c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/sub-after1s1c}}
+
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/sub-after1s1c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/sub-after1s1c}}\hfill
+\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/sub-after1s1c}}\hfill
+\frame{\includegraphics[page=11,width=0.24\linewidth]{examples/sub-after1s1c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/odd1s2c}}
+\caption{Output of \texttt{sub-after1s1c} (pages 4--11)}\label{sub-after1s1c}
+\end{figure}
+
+
+
+\FloatBarrier
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+%\twocolumn[
+\section{Full page objects in twocolumn mode}%]
+
+The filenames always have a ``2c'' for two columns in its names, e.g. \texttt{left2s2c}
+indicates \Lkeyset{capPos=before} and the documentclass setting \Loption{twoside} and \Loption{twocolumn}.
+Depending to the
+used documentclass it can be a problem, if the caption should be placed on the first page of the whole document.
+In such a case use one of the other setting.
+Table~\vref{tab:fullpage} shows the valid optional arguments for a full page floating object.
+%In the following we use some blind text to show the other setting for full page objects.
+%Such text has no meaning here.
+
+
+
+\subsection{Default setting}
+
+For the \Index{twocolumn} mode the caption can be in the left (first) or right (second) column.
+With the default setting (without using the keyword \Lkeyword{capPos})
+it is equivalent to the setting \Lkeyset{capPos=before}, the caption is always placed \emph{before} (left of)
+the object. This can be the first or the second column and both can be on different pages.
+With \Lkeyset{capPos=before} (uppercase L) it is possible to get the caption and the object in the twocolumn mode always on one page.
+This is then the left (first) column for the caption (see figure~\vref{default2s2c}).
+
+
+
+
+\begin{figure}[!h]
+%\frame{\includegraphics[page=1,width=0.24\linewidth]{examples/default2s2c}}\hfill
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/default2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/default2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/default2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/default2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/default2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/default2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/default2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/default2s2c}}
+\caption{Output of \texttt{default2s2c} (pages 2--9)}\label{default2s2c}
+\end{figure}
+
+
+\FloatBarrier
+
+
+\begin{lstlisting}
+\hvFloat[fullpage]{figure}%
+ {\includegraphics[width=\columnwidth,height=0.9\textheight]{images/frose}}%
+ [A float which needs the complete column width and height.]%
+ {A Caption of a ``fullpage'' object, which follows on the next column.
+ This is always the right column on an even or odd page. And some more
+ text whch has no real meaning because it fills only the space for a long
+ caption.}%
+ {fig:fullpage0-2}
+\end{lstlisting}
+
+
+
+The example~\vref{default2s2c} shows that the caption and the object can be on different
+pages. If you do not like this behaviour, then use the setting \Lkeyset{capPos=left}, which puts
+the caption before the object, but always on the \emph{same page} (see Figure~\vref{left2s2c}).
+
+
+\begin{figure}[!h]
+%\frame{\includegraphics[page=1,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/left2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/left2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/left2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/left2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/left2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/left2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/left2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/left2s2c}}
+\caption{Output of \texttt{left2s2c} (pages 2--9)}\label{left2s2c}
+\end{figure}
+
+
+
+
+\subsubsection{Using \Lkeyset{capPos=after}}
+
+The caption will be printed always right of the object which is the same as \textit{after} the full page object.
+With \Lkeyset{capPos=after} it is possible to get the caption in the twocolumn mode always in
+the right (second) column (see figure~\vref{right2s2c})
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=after]{figure}%
+ {\includegraphics[fullpage]{images/rose}}%
+ [A float which needs the complete column width and height.]%
+ {A Caption of a ``fullpage'' object, which is on the left column.
+ This is always the right column on an even or odd page. And some more
+ text whch has no real meaning because it fills only the space for a long
+ caption.}%
+ {fig:fullpage1-2}
+\end{lstlisting}
+
+
+\begin{figure}[!h]
+%\frame{\includegraphics[page=1,width=0.24\linewidth]{examples/after2s2c}}\hfill
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/after2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/after2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/after2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/after2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/after2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/after2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/after2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/after2s2c}}
+\caption{Output of \texttt{after2s2c} (pages 2--9)}\label{after2s2c}
+\end{figure}
+
+
+The caption and the object can be on different pages (Figure~\vref{after2s2c}).
+If you do not like this behaviour, then use the setting \Lkeyset{capPos=right} instead
+of \Lkeyset{capPos=after}. Figure~{right2s2c} shows that caption and object in this case
+are always on the same page.
+
+\begin{figure}[!h]
+%\frame{\includegraphics[page=1,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/right2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/right2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/right2s2c}}
+\caption{Output of \texttt{right2s2c} (pages 2--9)}\label{right2s2c}
+\end{figure}
+
+%\FloatBarrier
+
+\clearpage%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+\subsubsection{Using \Lkeyset{capPos=evenPage} --- caption on an even page}
+
+There can be a problem if there is not enough space on the bottom of the
+even page. Then the caption will be on the next page which is an odd one.
+In such a case use a manually \Lcs{clearpage} or wait for an update
+of \Lpack{hvfloat}.
+
+
+\iffalse
+\begin{figure}[p]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/even1s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/even1s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/even1s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/even1s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/even1s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/even1s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/even1s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/even1s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/even1s2c}}
+\caption{Output of \texttt{even1s2c} (pages 2--9)}\label{even1s2c}
+\fi
+
+\begin{figure}
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/even2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/even2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/even2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/even2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/even2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/even2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/even2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/even2s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/even1s2c}}
+\caption{Output of \texttt{even2s2c} (pages 2--9)}\label{even2s2c}
+\end{figure}
+
+%\FloatBarrier
+
+
+\clearpage
+
+
+\subsubsection{Using \Lkeyset{capPos=oddPage} --- caption on an odd page}
+
+There can be a problem if there is not enough space on the bottom of the
+even page. Then the caption will be on the next page which is an odd one.
+In such a case use a manually \Lcs{clearpage} or wait for an update
+of \Lpack{hvfloat}.
+
+
+\iffalse
+\begin{figure}[p]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/odd1s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/odd1s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/odd1s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/odd1s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/odd1s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/odd1s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/odd1s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/odd1s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/odd1s2c}}
+\caption{Output of \texttt{odd1s2c} (pages 2--9)}\label{odd1sc2}
+\fi
+
+\begin{figure}
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/odd2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/odd2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/odd2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/odd2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/odd2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/odd2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/odd2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/odd2s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/odd1s2c}}
+\caption{Output of \texttt{odd2s2c} (pages 2--9)}\label{odd2s2c}
+\end{figure}
+
+
+
+
+%\FloatBarrier
+\clearpage
+
+
+\subsubsection{Using \Lkeyset{capPos=inner} --- caption in the inner column}
+
+The caption will be printed in the right column for an even page and
+in the left column for an odd page.
+
+
+\begin{lstlisting}
+\hvFloat[fullpage,capPos=inner]{figure}{\includegraphics[fullpage]{images/rose}}%
+ [A float which needs the complete column width and height.]%
+ {A Caption of a ``fullpage'' object, which follows on the left or right column.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}{fig:fullpage3-2}
+\end{lstlisting}
+
+\iffalse
+\Float[capPos=inner]
+\hvFloat[fullpage,capPos=inner]{figure}%
+ {\includegraphics[fullpage]{images/rose}}%
+ [A float which needs the complete column width and height.]%
+ {A Caption of a ``fullpage'' object, which follows on the left or
+ right column.
+ This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}{fig:fullpage3-2}
+\fi
+
+
+\begin{figure}
+%\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/inner1s2c}}\hfill
+%\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/inner1s2c}}\hfill
+%\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/inner1s2c}}\hfill
+%\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/inner1s2c}}
+
+%\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/inner1s2c}}\hfill
+%\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/inner1s2c}}\hfill
+%\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/inner1s2c}}\hfill
+%\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/inner1s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/inner1s2c}}
+%\caption{Output of \texttt{inner1s2c} (pages 2--9)}\label{inner1s2c}
+
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/inner2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/inner2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/inner2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/inner2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/inner2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/inner2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/inner2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/inner2s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/inner1s2c}}
+\caption{Output of \texttt{inner2s2c} (pages 2--9)}\label{inner2s2c}
+\end{figure}
+
+
+%\FloatBarrier
+\clearpage
+
+
+\subsubsection{Using \Lkeyset{capPos=outer} --- caption on the outer column}
+
+The caption will be printed on the left column an odd page, the object can appear before
+or after this caption.
+
+
+\begin{lstlisting}
+\hvFloat[fullpage, capPos=outer]{figure}%
+ {\includegraphics[fullpage]{images/rose}}%
+ [A float which needs the complete page width and height with \texttt{capPos=outer}.]%
+ {A Caption of a ``fullpage'' object, which has the caption position in the
+ outer page. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}{fig:fullpage2-2a}
+\end{lstlisting}
+
+\iffalse
+\Float[capPos=outer]
+\hvFloat[fullpage, capPos=outer]{figure}%
+ {\includegraphics[fullpage]{images/rose}}%
+ [A float which needs the complete page width and height with \texttt{capPos=outer}.]%
+ {A Caption of a ``fullpage'' object, which has the caption position in the
+ outer page. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}{fig:fullpage2-2a}
+\fi
+
+
+
+
+\begin{figure}
+%\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/outer1s2c}}\hfill
+%\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/outer1s2c}}\hfill
+%\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/outer1s2c}}\hfill
+%\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/outer1s2c}}
+%
+%\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/outer1s2c}}\hfill
+%\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/outer1s2c}}\hfill
+%\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/outer1s2c}}\hfill
+%\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/outer1s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/outer1s2c}}
+%\caption{Output of \texttt{outer1s2c} (pages 2--9)}\label{outer1s2c}
+
+
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/outer2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/outer2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/outer2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/outer2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/outer2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/outer2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/outer2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/outer2s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/outer1s2c}}
+\caption{Output of \texttt{outer2s2c} (pages 2--9)}\label{outer2s2c}
+\end{figure}
+
+
+\FloatBarrier
+
+
+\clearpage
+
+
+\subsection{Using full page in twocolumn mode}\label{star-version}
+
+With the star version of \Lcs{hvfloat} The object ist placed over both columns, the whole page.
+In such a case the only useful caption position is \Lkeyset{capPos=inner} for \emph{inner}.
+
+
+\begin{lstlisting}
+\hvFloat*[fullpage, capPos=inner]{figure}%
+ {\includegraphics[FullPage]{images/rose}}%
+ [A float which needs the complete page width and height with \texttt{capPos=outer}.]%
+ {A caption of a ``fullpage'' object in twocolumn mode: It uses the star version
+ of \textbackslash hvFloat. The object goes over both columns.}{fig:two}
+\end{lstlisting}
+
+\iffalse
+\Float[capPos=inner]
+\hvFloat*[fullpage, capPos=inner]{figure}%
+ {\includegraphics[FullPage]{images/rose}}%
+ [Star version with \texttt{capPos=outer}.]%
+ {A caption of a ``fullpage'' object in twocolumn mode: It uses the star version
+ of \textbackslash hvFloat. The object goes over both columns.}{fig:two}
+
+\fi
+
+
+\begin{figure}
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/paper-default2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/paper-default2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/paper-default2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/paper-default2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/paper-default2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/paper-default2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/paper-default2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/paper-default2s2c}}
+
+%\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/paper-default2s2c}}
+\caption{Output of \texttt{paper-default2s2c} (pages 2--9)}\label{paper-default2s2c}
+\end{figure}
+
+
+\begin{figure}
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/paper-inner2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/paper-inner2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/paper-inner2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/paper-inner2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/paper-inner2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/paper-inner2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/paper-inner2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/paper-inner2s2c}}
+
+%\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/paper-inner1s2c}}
+\caption{Output of \texttt{paper-inner2s2c} (pages 2--9)}\label{paper-inner2s2c}
+\end{figure}
+
+
+\FloatBarrier
+
+
+\subsection{Multifloats}
+Multifloats is the name for more than one image and/or tabular in \emph{one} floating
+environment. Every image and/or tabular has its own caption, which is different to
+a subcaption.
+The + symbol defines an additional Object which will be part of the same floating environment.
+It's up too the user to be sure that one page or one column can hold all defined objects.
+Every object gets its own caption which is the reason why figures and tabulars and \ldots\
+can be mixed:
+
+\begin{lstlisting}
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat,capPos=inner]%
+ +{figure}{\includegraphics[height=0.4\textheight]{images/rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}%
+ {}%
+ +{figure}{\includegraphics[height=0.4\textheight]{images/rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+\end{lstlisting}
+
+
+
+\iffalse
+\Float[Multi]
+\captionsetup{singlelinecheck=false}
+\hvFloat[fullpage,multiFloat,capPos=inner]%
+ +{figure}{\includegraphics[height=0.4\textheight]{images/rose}}%% no 1
+ [Short caption A]%
+ {A Caption A of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {multi:demo0}%
+ +{table}{\begin{tabular}{lr}\hline % no 2
+ Linksbündig & Rechtsbündig\\
+ L & R \\
+ left & right \\
+ \multicolumn{2}{c}{Multicolumn}\\\hline
+ \end{tabular}}%
+ [Short Caption B]%
+ {A Caption B of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page.}{}%
+ +{figure}{\includegraphics[height=0.4\textheight]{images/rose}}%% no 3
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {multi:demo1}
+\fi
+
+
+The page with the objects has no additional informations it holds only the figures and/or tabulars.
+If you want it like subfigures or subtabulars then go to section~\vref{sec:subfloats}. The setting
+\Lcs{captionsetup}\Largb{\Lkeyset{singlelinecheck=false}} is needed if you want the captions always
+left aligned.
+
+
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/multi-default2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/multi-default2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/multi-default2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/multi-default2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/multi-default2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/multi-default2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/multi-default2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/multi-default2s2c}}
+%\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/multi-default2s2c}}
+\caption{Output of \texttt{multi-default2s2c} (pages 2-9)}\label{multi-defaults2s2c}
+\end{figure}
+
+\begin{figure}[!h]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/multi-inner2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/multi-inner2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/multi-inner2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/multi-inner2s2c}}%%
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/multi-inner2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/multi-inner2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/multi-inner2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/multi-inner2s2c}}
+%\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/multi-inner2s2c}}
+\caption{Output of \texttt{multi-inner2s2c} (pages 2-9)}\label{multi-inners2s2c}
+\end{figure}
+
+
+
+\section{Subfloat page}
+A subfloat page can have only one type of floats which will have one main caption and
+individual subcaptions.
+Some arguments are ignored for a subfloat, one can leave them empty. The first line defines only the type and the main caption,
+the object entry is ignored! All aditional lines will have the same float type, the reason why the
+float type entry is ignored.
+
+\enlargethispage{\normalbaselineskip}
+
+\begin{lstlisting}
+\captionsetup[sub]{singlelinecheck}
+\hvFloat[fullpage,capPos=before,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]% main short lsi entry
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}% main caption
+ {sub:demo00}%
+ +{}{\includegraphics[height=0.28\textheight]{images/rose}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}% subcaption
+ {}%
+ +{}{\includegraphics[height=0.28\textheight]{images/rose}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or right column.}%
+ {sub:demo10}
+ +{}{\includegraphics[height=0.28\textheight]{images/rose}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo20}
+\end{lstlisting}
+
+
+The keyword \Lkeyword{subFloat} defines the images or tabulars as subfloats.
+The package \Lpack{subcaption} is loaded by default. For the subcaptions the \Lkeyword{singlelinecheck}
+should be true (see listing).
+
+\iffalse
+\captionsetup[sub]{singlelinecheck}
+\Float[subFloat]
+\hvFloat[fullpage,capPos=before,objectFrame,subFloat]%
+ +{figure}{}[Short main caption of the objects]%
+ {The main caption of a ``fullpage'' object, which follows on the left or
+ right column. This can be an even or odd page. And some more text whch has no
+ real meaning because it fills only the space for a long caption.}%
+ {sub:demo00}%
+ +{}{\includegraphics[height=0.28\textheight]{images/rose}}%
+ [Short caption B]%
+ {A Caption B of a ``fullpage'' sub object.}%
+ {}%
+ +{}{\includegraphics[height=0.28\textheight]{images/rose}}%
+ {A Caption C of a ``fullpage'' object, which follows on the left or
+ right column.}%
+ {sub:demo10}
+ +{}{\includegraphics[height=0.28\textheight]{images/rose}}%
+ {A Caption D of a ``fullpage'' object}%
+ {sub:demo20}
+\fi
+
+
+
+\begin{figure}[p]
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/sub-default2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/sub-default2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/sub-default2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/sub-default2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/sub-default2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/sub-default2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/sub-default2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/sub-default2s2c}}
+\caption{Output of \texttt{sub-default2s2c} (pages 2--9)}\label{sub-default2s2c}
+
+\frame{\includegraphics[page=2,width=0.24\linewidth]{examples/sub-after2s2c}}\hfill
+\frame{\includegraphics[page=3,width=0.24\linewidth]{examples/sub-after2s2c}}\hfill
+\frame{\includegraphics[page=4,width=0.24\linewidth]{examples/sub-after2s2c}}\hfill
+\frame{\includegraphics[page=5,width=0.24\linewidth]{examples/sub-after2s2c}}
+
+\frame{\includegraphics[page=6,width=0.24\linewidth]{examples/sub-after2s2c}}\hfill
+\frame{\includegraphics[page=7,width=0.24\linewidth]{examples/sub-after2s2c}}\hfill
+\frame{\includegraphics[page=8,width=0.24\linewidth]{examples/sub-after2s2c}}\hfill
+\frame{\includegraphics[page=9,width=0.24\linewidth]{examples/sub-after2s2c}}
+%\frame{\includegraphics[page=10,width=0.24\linewidth]{examples/odd2s2c}}
+\caption{Output of \texttt{sub-after2s2c} (pages 2--9)}\label{sub-after2s2c}
+\end{figure}
+
+
+
+\FloatBarrier
+
+%\index{capPos@\texttt {capPos} (keyword)|)}
+
+
+
+
+\section{References to the page}\label{varioref}
+%Whith loading package \texttt{hyperref} references to floating objects with a caption left or right of the object
+%are no problem in difference to captions below othe object or on another page (using \texttt{fullpage} option).
+%With loading package \texttt{hypcap}
+With the command \CMD{pageref} one can have a reference to the page number of a caption. For the
+\Lkeyword{fullpage} option this can be the wrong page if someone wants a refence to the page where
+the object is set. Let's assume that we use something like
+
+\begin{verbatim}
+\setDefaults
+\hvFloat[fullpage,capPos=evenPage]{figure}%
+ {\IncludeGraphics{images/frose}}%
+ [A float which needs the complete paper width and height.]%
+ {A Caption of a ``fullpage'' object, which follows on the next page.
+ This can be an even or odd page. The object uses the complete paper dimensions}%
+ {demo:fullpage}
+\end{verbatim}
+
+The label \texttt{demo:fullpage} is used for the \emph{image} and not for the caption! Internally another label
+called \texttt{demo:fullpage-cap} is set on the caption page which can be before or
+behind the opject (depending to the optional argument of \Lkeyword{capPos}).
+For example:
+
+\begin{verbatim}
+The caption of figure~\ref{demo:fullpage-cap} is on page~\pageref{demo:fullpage-cap}, but
+the image itself is on page~\pageref{demo:fullpage}.
+\end{verbatim}
+
+
+The caption of figure~\ref{demo:fullpage-cap} is on page~\pageref{demo:fullpage-cap}, but
+the image itself is on page~\pageref{demo:fullpage}.
+With package \Lpack{varioref} it is:
+
+\begin{verbatim}
+Whith the package \Lpack{varioref} (\url{https://ctan.org/pkg/varioref})
+one can get something like: see figure~\vref{demo:fullpage}, which uses a
+correct page number of the floatinmg object and not the caption
+page number which is~\vpageref{demo:fullpage-cap}.
+The figure~\ref{demo:fullpage} is on page~\pageref{demo:fullpage}
+and the caption on page~\pageref{demo:fullpage-cap}
+\end{verbatim}
+
+Whith the package \Lpack{varioref} (\url{https://ctan.org/pkg/varioref})
+one can get something like: see figure~\vref{demo:fullpage}, which uses a
+correct page number of the floating object and not the caption
+pagenumber which is~\vpageref{demo:fullpage-cap}.
+The figure~\ref{demo:fullpage} is on page~\pageref{demo:fullpage}
+and the caption on page~\pageref{demo:fullpage-cap}
+
+
+\FloatBarrier
+
+\section{Defining a style}
+
+With \Lcs{defhvstyle} one can define a special style to get rid of the individual setting:
+
+\begin{BDef}
+\Lcs{defhvstyle}\Largb{name}\Largb{setting}
+\end{BDef}
+
+For example:
+\begin{verbatim}
+\defhvstyle{RightCaption}{floatPos=htb, capWidth=0.5, capPos=after, capVPos=bottom, objectPos=center}
+\end{verbatim}
+
+
+\begin{lstlisting}
+\hvFloat[style=RightCaption]{figure}{\includegraphics{images/rose}}%
+ {Caption vertically centered right beside the float with a caption width of
+ \texttt{0.5\textbackslash columnwidth}.}{fig:style}
+\end{lstlisting}
+
+\defhvstyle{RightCaption}{floatPos=htb, capWidth=0.5, capPos=after, capVPos=bottom, objectPos=center}
+
+
+\hvFloat[style=RightCaption]{figure}{\includegraphics{images/rose}}%
+ {Caption at bottom right beside the float with a caption width of
+ \texttt{0.5\textbackslash columnwidth}.}{fig:style}
+
+
+
+\section{Global float setting}
+Instead of writing the following sequence into the preamble:
+
+\begin{verbatim}
+\makeatletter
+\renewcommand\fps@figure{tb}
+\renewcommand\fps@table{t}
+\makeatother
+\end{verbatim}
+
+you can change the global setting of floats by loading the package \Lpack{hvfloat-fps}. It allows
+optional package options to set the global placement:
+
+
+\begin{verbatim}
+\usepackage[figure=tb,table=t]{hvfloat-fps}
+\end{verbatim}
+
+\blindtext
+
+\blindtext
+
+%\setDefaults
+\hvFloat[FULLPAGE]{figure}%
+ {\includegraphics[FULLPAGE]{images/frose}}%
+ [A float which needs the complete paper width and height.]%
+ {A Caption of a ``fullpage'' object, which follows on the next page.
+ This can be an even or odd page. The object uses the complete paper dimensions}%
+ {demo:fullpage}
+
+
+\Blindtext
+
+\printindex
+
+
+\clearpage
+
+
+
+%\appendix
+%\section{Problems}
+%\begin{itemize}
+%\item[] With the \texttt{nonfloat} option all objects are left aligned, \verb|\centering| doesn't work here. Only God knows why ...\hfill \textbf{solved!}
+%\end{itemize}
+
+
+\section{The Package Source}
+\lstinputlisting[basicstyle=\ttfamily\footnotesize,tabsize=3,numbers=left,numberstyle=\tiny]{hvfloat.sty}
+
+
+\end{document}
+
diff --git a/macros/latex/contrib/hvfloat/doc/images/CTAN.png b/macros/latex/contrib/hvfloat/doc/images/CTAN.png
new file mode 100644
index 0000000000..805ae3be95
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/images/CTAN.png
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/images/frose.png b/macros/latex/contrib/hvfloat/doc/images/frose.png
new file mode 100644
index 0000000000..0efe947eee
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/images/frose.png
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/doc/images/rose.png b/macros/latex/contrib/hvfloat/doc/images/rose.png
new file mode 100644
index 0000000000..3bbb2e85fd
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/doc/images/rose.png
Binary files differ
diff --git a/macros/latex/contrib/hvfloat/latex/hvfloat-fps.sty b/macros/latex/contrib/hvfloat/latex/hvfloat-fps.sty
new file mode 100644
index 0000000000..6fff6b4323
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/latex/hvfloat-fps.sty
@@ -0,0 +1,30 @@
+%% $Id: hvfloat-fps.sty 1031 2019-04-03 20:40:25Z herbert $
+%%
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{hvfloat-fps}[2017/09/16 setting float objects]
+%%
+%% IMPORTANT NOTICE:
+%%
+%% This is file `hvfloat-fps.sty',
+%%
+%% Herbert Voss <hvoss@tug.de>
+%%
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN archives
+%% in directory macros/latex/base/lppl.txt.
+%%
+%% DESCRIPTION:
+%% `hvfloat-fps' offers global placement of floats
+%%
+\def\fileversion{0.02}
+\def\filedate{2017/09/20}
+\message{`hvfloat-fps' v\fileversion, \filedate\space (Herbert Voss)}
+%
+\RequirePackage{xkeyval}
+%
+\DeclareOptionX{figure}{\renewcommand*\fps@figure{#1}}
+\DeclareOptionX{table}{\renewcommand*\fps@table{#1}}
+\DeclareOptionX{all}{\renewcommand*\fps@figure{#1}\renewcommand*\fps@table{#1}}
+\ProcessOptionsX\relax
+%
+\endinput
diff --git a/macros/latex/contrib/hvfloat/latex/hvfloat.sty b/macros/latex/contrib/hvfloat/latex/hvfloat.sty
new file mode 100644
index 0000000000..7eda015ab8
--- /dev/null
+++ b/macros/latex/contrib/hvfloat/latex/hvfloat.sty
@@ -0,0 +1,1032 @@
+%% $Id: hvfloat.sty 1054 2019-05-13 08:20:11Z herbert $
+%%
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{hvfloat}[2019/05/13 rotating of floating objects]
+%%
+%% IMPORTANT NOTICE:
+%%
+%% This is file `hvfloat.sty',
+%%
+%% Herbert Voss <hvoss@tug.org>
+%%
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN archives
+%% in directory macros/latex/base/lppl.txt.
+%%
+%% DESCRIPTION:
+%% `hvfloat' offers rotating of captions and objects for floats
+%%
+\def\fileversion{2.15}
+\def\filedate{2019/08/31}
+\message{`hvfloat' v\fileversion, \filedate\space (Herbert Voss)}
+\let\hvFileVersion\fileversion
+%
+\newif\ifhv@fbox \hv@fboxfalse
+\newif\ifhv@hyperref \hv@hyperreffalse
+\DeclareOption{fbox}{\hv@fboxtrue\setlength{\fboxsep}{1pt}}
+\DeclareOption{hyperref}{\hv@hyperreftrue}
+
+\ProcessOptions
+
+\PassOptionsToPackage{hypcap}{caption}
+\RequirePackage{caption}
+\PassOptionsToPackage{hypcap}{subcaption}
+\RequirePackage{subcaption}
+\RequirePackage{atbegshi}
+
+\RequirePackage{expl3,multido}
+\RequirePackage{graphicx}
+
+\RequirePackage{xkeyval}
+\RequirePackage{ifoddpage}
+\RequirePackage{afterpage}
+%\RequirePackage{zref-abspos}
+
+\ifhv@hyperref
+ \RequirePackage{hyperref}
+% \RequirePackage{hypcap}
+\fi
+%
+%\unitlength=1cm
+\providecommand*\LenToUnit[1]{\strip@pt\dimexpr#1*\p@/\unitlength}
+
+\newlength\hvObjectWidth
+\newlength\hvCapWidth
+\newlength\hvWideWidth
+\newlength\hvMultiFloatSkip
+\newlength\hvMaxCapWidth
+%\newlength\hv@BottomSpace
+%\AtBeginDocument{%
+% \setlength\hv@BottomSpace{\dimexpr\paperheight-1in-\topmargin-\headheight-\headsep-\textheight}}
+
+\newsavebox\hvObjectBox
+\newsavebox\hvCaptionBox
+\newsavebox\hvOBox
+\newsavebox\@tempbox
+\newsavebox\hv@caption@box
+
+\newif\ifhv@capbeside \hv@capbesidefalse
+
+\def\hv@Top{top}
+\def\hv@Bottom{bottom}
+\def\hv@After{after}
+\def\hv@Before{before}
+\def\hv@Right{right}
+\def\hv@Left{left}
+\def\hv@Center{center}
+\def\hv@Outer{outer}
+\def\hv@Inner{inner}
+\def\hv@Even{evenPage}
+\def\hv@Odd{oddPage}
+\def\hv@Natural{n}
+\def\hv@Width{w}
+\def\hv@Height{h}
+\def\hv@Zero{0}
+%
+\def\hv@figure{figure}
+%
+\define@key{hvSet}{floatPos}[htbp]{% LaTeX's position parameters htbp
+ \def\hvSet@floatPos{#1}%
+}
+\define@key{hvSet}{rotAngle}[0]{% rotates caption AND image together
+ \def\hvSet@rotAngle{#1}%
+}
+\define@key{hvSet}{capWidth}[n]{% (n)atural width|object (w)idth)|object (h)eight|<scale of \columnwidth>
+ \def\hvSet@capWidth{#1}%
+}
+\define@key{hvSet}{capAngle}[0]{% -360..+360
+ \def\hvSet@capAngle{#1}%
+}
+\define@key{hvSet}{capPos}[bottom]{% (l)eft|(b)ottom|(t)op|(r)ight|(i)nner|(o)uter|(e)ven|o(d)d
+ \def\hvSet@capPos{#1}% it is relativ to the object, (e),(d) only valid for fullpage float
+ \edef\@tempa{#1}%
+ \ifx\hv@Bottom\@tempa
+ \hv@capbesidefalse
+ \else
+ \ifx\hv@Top\@tempa
+ \hv@capbesidefalse
+ \else
+ \hv@capbesidetrue
+ \fi
+ \fi
+}
+\define@key{hvSet}{capVPos}[center]{% bottom|center|top
+ \def\hvSet@capVPos{#1}% it is relativ to the object
+}
+\define@key{hvSet}{objectPos}[center]{% (l)eft|(c)enter|(r)ight|(i)nner|(o)uter
+ \def\hvSet@objectPos{#1}% it is relativ to the document
+}
+\define@key{hvSet}{objectAngle}[0]{% -360..+360
+ \def\hvSet@objectAngle{#1}%
+}
+\define@key{hvSet}{floatCapSep}[5pt]{% a width with the unit pt
+ \def\hvSet@floatCapSep{#1}%
+}
+\define@key{hvSet}{multiFloatSkip}[\normalbaselineskip]{% a width with the unit pt
+ \setlength\hvMultiFloatSkip{#1}%
+}
+\define@boolkey{hvSet}[hv@]{useOBox}[true]{}% use of the hvOBox contents
+\define@boolkey{hvSet}[hv@]{nonFloat}[true]{}% Do not use float environment
+\define@boolkey{hvSet}[hv@]{onlyText}[true]{}% Write the caption only as text
+\define@boolkey{hvSet}[hv@]{wide}[true]{}% Write the caption only as text
+
+
+\newif\ifhv@fullpage
+\newif\ifhv@FULLPAGE
+
+%\define@boolkey{hvSet}[hv@]{fullpage}[true]{}% fullpage float with caption on other page
+%\define@boolkey{hvSet}[hv@]{FullPage}[true]{}% fullpage float with caption on other page
+%\define@boolkey{hvSet}[hv@]{FULLPAGE}[true]{}% fullpage float with caption on other page
+
+\define@key{hvSet}{fullpage}[true]{\global\@nameuse{hv@fullpage#1}}% wegen \afterpage problem
+\define@key{hvSet}{FULLPAGE}[true]{\global\@nameuse{hv@FULLPAGE#1}}
+
+\define@boolkey{hvSet}[hv@]{subFloat}[true]{% typeset values as subfloats
+ \ifhv@subFloat\setkeys{hvSet}{multiFloat=false}\fi%
+}%
+\define@boolkey{hvSet}[hv@]{multiFloat}[true]{% typeset values as continous floats
+ \ifhv@multiFloat\setkeys{hvSet}{subFloat=false}\fi%
+}%
+\define@boolkey{hvSet}[hv@]{separatorLine}[true]{}% separator line for caption of a full page float
+\define@boolkey{hvSet}[hv@]{objectFrame}[true]{}% a frame around the object with no separation
+\define@key{hvSet}{style}{%
+ \@ifundefined{hv@#1}%
+ {\errmessage{Custom style `#1' undefined}}%
+ {\begingroup
+ \edef\x{\endgroup\noexpand\setkeys{hvSet}{\@nameuse{hv@#1}}}\x}% use a defined style
+}
+\define@key{hvSet}{capFormat}[]{\def\hv@caption@format{#1}}%
+\define@key{hvSet}{subcapFormat}[]{\def\hv@subcaption@format{#1}}%
+
+\def\hv@set#1{\begingroup\edef\x{\endgroup\noexpand\setkeys{hvSet}{#1}}\x}
+\let\hvFloatSet\hv@set
+%
+\def\defhvstyle#1#2{\@namedef{hv@#1}{#2}}
+%
+\newcommand{\setDefaults}{%
+ \hv@set{%
+ floatPos=htbp, rotAngle=0, capWidth=n, capAngle=0,
+ capPos=bottom, capVPos=center, objectPos=center, objectAngle=0,
+ floatCapSep=5pt, useOBox=false, nonFloat=false,
+ onlyText=false, wide=false, fullpage=false, FULLPAGE=false,
+ multiFloat=false,subFloat=false,
+ separatorLine,objectFrame=false,multiFloatSkip=\normalbaselineskip,
+ capFormat={}, subcapFormat={},
+}%
+}
+\newcommand\reset@special@float{%
+ \hv@set{subFloat=false,%fullpage=false,
+ multiFloat=false,%FULLPAGE=false
+}}
+
+\def\hv@vskip{\vspace{\hvMultiFloatSkip}}
+
+%
+\newlength\hvAboveCaptionSkip
+\newlength\hvBelowCaptionSkip
+\newcount\hv@@capPos
+
+\newlength\fboxlinewidth
+\AtBeginDocument{%
+ \setlength\fboxlinewidth{\dimexpr\linewidth-2\fboxrule-2\fboxsep}%
+}
+\setlength\belowcaptionskip{\abovecaptionskip}% it is in latex.ltx = 0pt
+\newcommand\saveCaptionSkip{%
+ \setlength{\hvAboveCaptionSkip}{\abovecaptionskip}
+ \setlength{\hvBelowCaptionSkip}{\belowcaptionskip}
+ \setlength{\abovecaptionskip}{0pt}
+ \setlength{\belowcaptionskip}{0pt}
+}
+\newcommand{\restoreCaptionSkip}{%
+ \setlength\abovecaptionskip{\hvAboveCaptionSkip}%
+ \setlength\belowcaptionskip{\hvBelowCaptionSkip}%
+}
+%
+\newcommand\figcaption[2][]{\def\@captype{figure}%
+ \begingroup
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \ifx\relax#1\relax \caption{#2}\else\caption[#1]{#2}\fi
+ \endgroup}
+\newcommand\tabcaption[2][]{\def\@captype{table}%
+ \begingroup
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \ifx\relax#1\relax \caption{#2}\else\caption[#1]{#2}\fi
+ \endgroup}
+%
+\newlength\hv@maxImageWidth
+\AtBeginDocument{\hv@maxImageWidth=\columnwidth}
+
+\define@key{Gin}{fullpage}[true]{%
+ \def\Gin@ewidth{\columnwidth}%
+ \def\Gin@eheight{\textheight}%
+ \Gin@boolkey{false}{iso}%
+}
+\define@key{Gin}{FullPage}[true]{%
+ \def\Gin@ewidth{\textwidth}%
+ \def\Gin@eheight{\textheight}%
+ \Gin@boolkey{false}{iso}%
+}
+\define@key{Gin}{FULLPAGE}[true]{%
+ \def\Gin@ewidth{\paperwidth}%
+ \def\Gin@eheight{\paperheight}%
+ \Gin@boolkey{false}{iso}%
+}
+\newcommand\IncludeGraphics[2][]{%
+% \newpage
+%\iffalse
+ \vspace*{\the\dimexpr-1in-\voffset+\topskip-\headheight-0.5\baselineskip}%
+ \leavevmode\checkoddpage
+ \ifoddpage
+ \hspace*{\dimexpr-\oddsidemargin-\parindent-1in}%
+ \else
+ \hspace*{\dimexpr-\evensidemargin-\parindent-1in}%
+ \fi\noindent
+ \includegraphics[#1,width=\paperwidth,height=\paperheight,keepaspectratio=false]{#2}%
+%\fi
+% \includepdf[#1]%,width=\paperwidth,height=\paperheight,keepaspectratio=false]
+% {#2}%
+}
+
+\newcommand\put@CaptionBox[1][0]{%
+ \ifcase#1
+ \ifhv@fbox
+ \fbox{\parbox{\wd\hvCaptionBox}{\usebox{\hvCaptionBox}}}%
+ \else
+ \parbox{\wd\hvCaptionBox}{\usebox{\hvCaptionBox}}%
+ \fi
+ \or
+ \ifhv@fbox
+ \fbox{\raisebox{-\height}{\usebox{\hvCaptionBox}}}%
+ \else
+ \raisebox{-\height}{\usebox{\hvCaptionBox}}%
+ \fi
+ \or
+ \ifhv@fbox\fbox{\usebox{\hvCaptionBox}}\else\usebox{\hvCaptionBox}\fi
+ \fi
+}
+
+\newcommand\put@ObjectBox[1][0]{%
+ \ifcase#1
+ \ifhv@fbox
+ \fbox{\parbox{\wd\hvObjectBox}{\usebox{\hvObjectBox}}}%
+ \else
+ \parbox{\wd\hvObjectBox}{\ifhv@objectFrame\frame{\usebox{\hvObjectBox}}\else\usebox{\hvObjectBox}\fi}%
+ \fi
+ \or
+ \ifhv@fbox
+ \fbox{\raisebox{-\height}{\usebox{\hvObjectBox}}}%
+ \else
+ \raisebox{-\height}{\ifhv@objectFrame\frame{\usebox{\hvObjectBox}}\else\usebox{\hvObjectBox}\fi}%
+ \fi
+ \or
+ \ifhv@fbox
+ \fbox{\usebox{\hvObjectBox}}%
+ \else
+ \ifhv@objectFrame\frame{\usebox{\hvObjectBox}}\else\usebox{\hvObjectBox}\fi%
+ \fi
+ \fi
+}
+
+\newif\ifhv@star
+\newif\if@hvsubstar
+\setDefaults
+
+\def\hvFloat{\@ifnextchar*% Main macro
+ {\global\hv@startrue\hv@maxImageWidth=\textwidth\hvFloat@i}%
+ {\global\hv@starfalse\hv@maxImageWidth=\columnwidth\hvFloat@i*}%
+}
+
+%\newcommand*{\hvFloat}[5][]+{%
+% [#1}: keyvalues
+% #2: type figure | table | ...
+% #3: float contents
+% [#4]: short caption
+% #5: caption
+% #6: label
+%
+\def\hvFloat@i*{\@ifnextchar[{\do@hvFloat}{\do@hvFloat[]}}
+
+\def\do@hvFloat[#1]{%
+ \begingroup
+ \setlength\hvWideWidth{\dimexpr\linewidth+\marginparwidth}%
+ \hv@maxImageWidth=\textwidth
+% \hv@capbesidefalse
+ \reset@special@float
+ \setcounter{hv@pfigure}{\value{figure}}%
+ \setcounter{hv@ptable}{\value{table}}%
+ \gdef\hv@save@setting{#1}%
+ \ifx\relax#1\relax\else\setkeys{hvSet}{#1}\fi
+ \gdef\hv@floatType{figure}%
+ \@ifnextchar+{\do@multiFloat}{\hvFloat@ii[#1]}}
+
+\ExplSyntaxOn
+
+\def\do@multiFloat+#1#2{%
+ \clist_set:Nn\l_clist_Type{{#1}}%
+ \clist_set:Nn\l_clist_Object{{#2}}%
+ \@ifnextchar[\do@multiFloat@i{\do@multiFloat@i[]}%
+}
+\def\do@multiFloat@i[#1]#2#3{% lof-caption, caption,label
+ \ifx\relax#1\relax
+ \clist_set:Nn\l_clist_LofCaption{{}}%
+ \else
+ \clist_set:Nn\l_clist_LofCaption{{#1}}%
+ \fi
+ \clist_set:Nn\l_clist_Caption{{#2}}%
+ \ifx\relax#3\relax
+ \clist_set:Nn\l_clist_Label{{}}%
+ \else
+ \clist_set:Nn\l_clist_Label{{#3}}%
+ \fi
+ \@ifnextchar+{\do@multiFloat@ii}{}%
+}
+\def\do@multiFloat@ii+#1#2{%
+ \clist_put_right:Nn\l_clist_Type{{#1}}%
+ \clist_put_right:Nn\l_clist_Object{{#2}}%
+ \@ifnextchar[\do@multiFloat@iii{\do@multiFloat@iii[]}%
+}
+
+\def\do@multiFloat@iii[#1]#2#3{% lof-caption, caption, label
+ \ifx\relax#1\relax
+ \clist_put_right:Nn\l_clist_LofCaption{{}}%
+ \else
+ \clist_put_right:Nn\l_clist_LofCaption{{#1}}%
+ \fi
+ \clist_put_right:Nn\l_clist_Caption{{#2}}%
+ \ifx\relax#3\relax
+ \clist_put_right:Nn\l_clist_Label{{}}%
+ \else
+ \clist_put_right:Nn\l_clist_Label{{#3}}%
+ \fi
+ \@ifnextchar+\do@multiFloat@ii%
+ {\def\hvSet@CapWidth{n}%
+ \do@@@@hvFloat}%
+}
+\ExplSyntaxOff
+
+
+\newcounter{hv@pfigure}
+\newcounter{hv@ptable}
+\newcounter{subhv@pfigure}
+\newcounter{subhv@ptable}
+
+\def\drawSepLine{%
+ \par\noindent
+ \if@twocolumn\rule{\columnwidth}{0.4pt}\else\rule{\linewidth}{0.4pt}\fi
+ \vspace{0pt}%
+}
+
+\newcount\hv@cnta
+\newcount\hv@cntb
+
+
+\def\hvFloat@ii[#1]#2#3{%
+ \hv@maxImageWidth=\textwidth
+% \hv@capbesidefalse
+ \ifx\relax#1\relax\else\setkeys{hvSet}{#1}\fi
+ \gdef\hv@floatType{#2}%
+ \ifx\relax#2\relax \setkeys{hvSet}{nonFloat=true}\fi
+ \gdef\hv@floatObject{#3}%
+ \@ifnextchar[{\do@@hvFloat}{\do@@hvFloat[]}%
+}
+\def\do@@hvFloat[#1]#2#3{%
+ \gdef\hv@shortCap{#1}%
+ \gdef\hv@longCap{#2}%
+ \gdef\hv@label{#3}%
+ \ifhv@fullpage
+ \def\hvSet@CapWidth{n}% relative value
+ \do@@@@hvFloat% fullpage with caption on other page
+ \else
+ \ifhv@FULLPAGE
+ \def\hvSet@CapWidth{n}% relative value
+ \do@@@@hvFloat% fullpage with caption on other page
+ \else
+ \do@@@hvFloat
+ \fi
+ \fi
+}
+%
+\def\do@@@hvFloat{% no special float page
+ \def\@tempa{90}%
+ \ifx\hvSet@rotAngle\@tempa
+ \setlength\hvMaxCapWidth{\textheight}%
+ \else
+ \setlength\hvMaxCapWidth{\hvWideWidth}%
+ \fi
+%
+% First we save the object in \hvObjectBox
+%
+ \ifx\hvSet@objectAngle\hv@Zero % rotate the object?
+ \savebox{\hvObjectBox}{\ifhv@useOBox\usebox{\hvOBox}\else\hv@floatObject\fi}%
+ \else
+ \savebox{\hvObjectBox}{%
+ \rotatebox{\hvSet@objectAngle}{%
+ \ifhv@useOBox\usebox{\hvOBox}\else\hv@floatObject\fi
+ }%
+ }%
+ \fi
+ \setlength\hvObjectWidth{\wd\hvObjectBox}%
+%
+% Now we save the caption with its defined \hvCapWidth
+%
+ \ifx\hvSet@capWidth\hv@Width% captionwidth=objectwidth
+ \setlength\hvCapWidth{\hvObjectWidth}%
+ \else
+ \ifx\hvSet@capWidth\hv@Height% captionwidth=objectheight
+ \setlength\hvCapWidth{\ht\hvObjectBox}%
+ \else
+ \ifx\hvSet@capWidth\hv@Natural% captionwidth=\linewidth-\objectwidth-separation
+ \ifhv@capbeside
+ \ifhv@wide
+ \setlength\hvCapWidth{\the\dimexpr\hvWideWidth-\hvObjectWidth-\hvSet@floatCapSep\relax}%
+ \else
+ \ifhv@star
+ \setlength\hvCapWidth{\the\dimexpr\textwidth-\hvObjectWidth-\hvSet@floatCapSep\relax}%
+ \else
+ \setlength\hvCapWidth{\the\dimexpr\linewidth-\hvObjectWidth-\hvSet@floatCapSep\relax}%
+ \fi
+ \fi
+ \else
+ \setlength\hvCapWidth{\columnwidth}%
+ \fi
+ \else
+ \ifhv@capbeside
+ \ifhv@wide
+ \setlength\hvCapWidth{\hvSet@capWidth\hvWideWidth}%
+ \setlength\@tempdima{\the\dimexpr\hvWideWidth-\hvObjectWidth-\hvSet@floatCapSep\relax}%
+ \else
+ \setlength\hvCapWidth{\hvSet@capWidth\columnwidth}%
+ \setlength\@tempdima{\the\dimexpr\columnwidth-\hvObjectWidth-\hvSet@floatCapSep\relax}%
+ \fi
+ \ifdim\hvCapWidth>\@tempdima
+ \setlength\hvCapWidth{\@tempdima}%
+ \fi
+ \else
+ \ifhv@wide
+ \setlength\hvCapWidth{\hvSet@capWidth\hvWideWidth}%
+ \else
+ \setlength\hvCapWidth{\hvSet@capWidth\columnwidth}%
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \saveCaptionSkip % we put this space ourselve
+ \ifx\hvSet@capAngle\hv@Zero % need rotation?
+ \sbox\hvCaptionBox{% NO rotation
+ \begin{minipage}[b]{\hvCapWidth}% minipage, to get hyphenation
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \ifhv@nonFloat
+ \ifhv@onlyText\hv@longCap
+ \else
+ \ifx\hv@floatType\hv@figure
+ \ifx\relax\hv@shortCap\relax \figcaption{\hv@longCap}\else\figcaption[\hv@shortCap]{\hv@longCap}\fi
+ \else
+ \ifx\relax\hv@shortCap\relax \tabcaption{\hv@longCap}\else\tabcaption[\hv@shortCap]{\hv@longCap}\fi
+ \fi
+ \fi
+ \else
+ \let\@captype\hv@floatType
+ \expandafter\ifx\expandafter\relax\hv@shortCap\relax \caption{\hv@longCap}\else\caption[\hv@shortCap]{\hv@longCap}\fi
+ \fi
+ \expandafter\label\expandafter{\hv@label}%
+ \end{minipage}%
+ }%
+ \else
+ \sbox\hvCaptionBox{% Rotation
+ \rotatebox{\hvSet@capAngle}{%
+ \begin{minipage}[b]{\hvCapWidth}% minipage, to get hyphenation
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \ifhv@nonFloat
+ \ifhv@onlyText\hv@longCap
+ \else
+ \ifx\hv@floatType\hv@figure
+ \ifx\relax\hv@shortCap\relax \figcaption{\hv@longCap}\else\figcaption[\hv@shortCap]{\hv@longCap}\fi
+ \else
+ \ifx\relax\hv@shortCap\relax \tabcaption{\hv@longCap}\else\tabcaption[\hv@shortCap]{\hv@longCap}\fi
+ \fi
+ \fi
+ \else
+ \let\@captype\hv@floatType
+ \expandafter\ifx\expandafter\relax\hv@shortCap\relax \caption{\hv@longCap}\else\caption[\hv@shortCap]{\hv@longCap}\fi
+ \fi
+ \label{\hv@label}%
+ \end{minipage}%
+ }% rotatebox
+ }% \sbox
+ \fi
+%
+% now we have the object and the caption with the right
+% rotated angles saved in different boxes
+%%
+ \restoreCaptionSkip% save old values
+ \def\fps@figure{\hvSet@floatPos}%
+ \ifhv@nonFloat
+ \begingroup% Start the nonfloat part
+ \else
+ \ifhv@star
+ \@nameuse{\hv@floatType*}% Start the floating environment *****************************
+ \else
+ \begin{\hv@floatType} % Start the floating environment
+ \fi
+ \fi
+ \checkoddpage
+ \ifx\hvSet@objectPos\hv@Right\raggedleft\fi
+ \ifx\hvSet@objectPos\hv@Center
+ \ifhv@nonFloat\hspace*{\fill}\else\centering\fi
+ \fi
+ \ifx\hvSet@objectPos\hv@Outer
+ \ifoddpage\raggedleft\fi
+ \fi
+ \ifx\hvSet@objectPos\hv@Inner
+ \ifoddpage\else\raggedleft\fi
+ \fi
+%
+% to rotate object and caption together, we save all in another box
+% the caption comes first, if its on the left or the top
+% 0 caption left, inner and odd page, oneside inner
+% 1 caption top
+% 2 caption right, inner and even page, oneside outer
+% 3 caption bottom
+%
+ \ifx\hvSet@capPos\hv@Left
+ \hv@@capPos=0
+ \else
+ \ifx\hvSet@capPos\hv@Top
+ \hv@@capPos=1
+ \else
+ \ifx\hvSet@capPos\hv@Right
+ \hv@@capPos=2
+ \else
+ \ifx\hvSet@capPos\hv@Bottom
+ \hv@@capPos=3
+ \else
+ \ifx\hvSet@capPos\hv@Inner
+ \ifoddpageoroneside\hv@@capPos=0\else\hv@@capPos=2\fi
+ \else
+ \ifx\hvSet@capPos\hv@Outer
+ \ifoddpageoroneside\hv@@capPos=2\else\hv@@capPos=0\fi
+ \else
+ \ifx\hvSet@capPos\hv@Before
+ \hv@@capPos=0 % same as cappos=right
+ \else
+ \ifx\hvSet@capPos\hv@After
+ \hv@@capPos=2 % same as capPos=right
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+%%%%
+ \savebox{\@tempboxa}{% ***** @tempbox start
+ \expandafter\ifcase\the\hv@@capPos% 0 is LEFT START \ifcase
+ \ifx\hvSet@capVPos\hv@Center
+ \put@CaptionBox
+ \hspace{\hvSet@floatCapSep}% capfloatsep
+ \put@ObjectBox
+ \else
+ \ifx\hvSet@capVPos\hv@Top% caption and object at top aligned
+ \put@CaptionBox[1]%
+ \hspace{\hvSet@floatCapSep}% capfloatsep
+ \put@ObjectBox[1]%
+ \else% caption on bottom
+ \put@CaptionBox[2]%
+ \hspace{\hvSet@floatCapSep}% capfloatsep
+ \put@ObjectBox[2]%
+ \fi
+ \fi% end caption left
+ \or%1 is top
+ \ifdim\wd\hvCaptionBox>\wd\hvObjectBox
+ \begin{minipage}{\wd\hvCaptionBox}%
+ \else
+ \begin{minipage}{\wd\hvObjectBox}%
+ \fi
+ \centering
+ \ifhv@fbox
+ \fbox{\usebox{\hvCaptionBox}}\\[\hvBelowCaptionSkip]%
+ \fbox{\usebox{\hvObjectBox}}%
+ \else
+ \usebox{\hvCaptionBox}\\[\hvBelowCaptionSkip]%
+ \usebox{\hvObjectBox}%
+ \fi
+ \end{minipage}%
+ \or %2 is right
+ \ifx\hvSet@capVPos\hv@Center
+ \put@ObjectBox
+ \hspace{\hvSet@floatCapSep}%
+ \put@CaptionBox
+ \else
+ \ifx\hvSet@capVPos\hv@Top
+ \put@ObjectBox[1]%
+ \hspace{\hvSet@floatCapSep}% capfloatsep
+ \put@CaptionBox[1]%
+ \else
+ \put@ObjectBox[2]%
+ \hspace{\hvSet@floatCapSep}% capfloatsep
+ \put@CaptionBox[2]%
+ \fi
+ \fi
+ \or %3 bottom
+ \ifdim\wd\hvCaptionBox>\wd\hvObjectBox
+ \begin{minipage}{\wd\hvCaptionBox}%
+ \else
+ \begin{minipage}{\wd\hvObjectBox}%
+ \fi
+ \centering
+ \ifhv@fbox
+ \fbox{\usebox{\hvObjectBox}}\\[\hvAboveCaptionSkip]%
+ \fbox{\usebox{\hvCaptionBox}}%
+ \else
+ \ifhv@objectFrame\frame{\usebox{\hvObjectBox}}\else\usebox{\hvObjectBox}\fi\\[\hvAboveCaptionSkip]%
+ \usebox{\hvCaptionBox}%
+ \fi
+ \end{minipage}%
+ \fi% \ifcase\the\hv@@capPos
+ }% End savebox Object and caption %%%%%%%%%%%%%%%%% @tempboxa
+%
+% now we rotate the object and caption, if needed
+%
+ \ifhv@wide
+ \ifoddpageoroneside\else\ifoddpage\else\hspace*{-\marginparwidth}\fi\fi% <- for wide and left page
+ \fi
+ \ifx\hvSet@rotAngle\hv@Zero
+ \usebox{\@tempboxa}%
+ \else
+ \rotatebox{\hvSet@rotAngle}{\usebox{\@tempboxa}}%
+ \fi
+ \ifhv@nonFloat
+ \ifx\hvSet@objectPos\hv@Center
+ \ifhv@nonFloat
+ \hspace{\fill}%
+ \fi
+ \fi
+ \endgroup% End the nonfloat part
+ \else
+ \ifhv@star
+ \@nameuse{end\hv@floatType*}% End the floating environment
+ \else
+ \end{\hv@floatType}% End the floating environment
+ \fi
+ \fi
+ \endgroup% startet at main \hvFloat
+}
+%
+\newenvironment{hvFloatEnv}[1][\textwidth]
+ {\minipage{#1}\center}
+ {\endcenter\endminipage}
+%
+
+\ExplSyntaxOn
+\let\clist@item@Nn\clist_item:Nn
+\let\l@clist@Type\l_clist_Type
+\let\l@clist@LofCaption\l_clist_LofCaption
+\let\l@clist@Label\l_clist_Label
+\let\clist@count@N\clist_count:N
+\ExplSyntaxOff
+
+\def\do@@@@hvFloat{% special float page: caption <-> fullpage image
+ \ifx\hvSet@capPos\hv@After \hv@@capPos=1
+ \else
+ \ifx\hvSet@capPos\hv@Even \hv@@capPos=2
+ \else
+ \ifx\hvSet@capPos\hv@Odd \hv@@capPos=3
+ \else
+ \ifx\hvSet@capPos\hv@Inner \hv@@capPos=4
+ \else
+ \ifx\hvSet@capPos\hv@Outer \hv@@capPos=5
+ \else
+ \ifx\hvSet@capPos\hv@Right \hv@@capPos=6 % only for twocolumn mode
+ \else
+ \ifx\hvSet@capPos\hv@Left \hv@@capPos=7 % only for twocolumn mode
+ \else
+ \hv@@capPos=0
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \checkoddpage
+ \set@caption@object% set caption and object into a box
+ \ifcase\hv@@capPos% caption before object 0-> _always_ left
+ \setBottomCaption\setPageObject
+ \or% caption after object 1-> _always_ right
+ \setPageObject\setBottomCaption
+ \or% caption on even page 2-> left page
+ \ifoddpage
+ \afterpage{\setBottomCaption\setPageObject}%
+ \else% we are on an even page
+% \zsaveposy{hv@currentPos}%
+% \ifdim\the\dimexpr\zposy{hv@currentPos}sp-\hv@BottomSpace-1cm>\ht\TBox % enough space*
+ \setBottomCaption\setPageObject
+% \else
+% \afterpage{\afterpage{\setBottomCaption\setPageObject}}%
+% \fi
+ \fi
+ \or% caption on odd page 3->right page
+ \if@twoside
+ \if@twocolumn
+ \ifoddpage
+ \if@firstcolumn% on right side
+ \setBottomCaption\setPageObject
+ \else
+ \afterpage{\setPageObject\setBottomCaption}% start next column
+ \fi
+ \else% left (even) page
+ \if@firstcolumn
+ \afterpage{\setPageObject\setBottomCaption}% start next column
+ \else
+ \setPageObject\setBottomCaption
+ \fi
+ \fi
+ \else % onecolumn
+ \ifoddpage
+ \setPageObject\setBottomCaption
+ \else% even page
+ \afterpage{\setPageObject\setBottomCaption}%
+ \fi
+ \fi
+ \else % oneside
+ \if@twocolumn
+ \ifoddpage
+ \if@firstcolumn% on right side
+ \setBottomCaption\setPageObject
+ \else
+ \setPageObject\setBottomCaption
+ \fi
+ \else
+ \if@firstcolumn% on left side
+ \afterpage{\setPageObject\setBottomCaption}%
+ \else
+ \setPageObject\setBottomCaption
+ \fi
+ \fi
+ \else % onecolumn
+ \ifoddpage
+ \setBottomCaption\setPageObject
+ \else
+ \afterpage{\setBottomCaption\setPageObject}%
+ \fi
+ \fi
+ \fi
+ \or% caption on the inner column 4->inner
+ \set@caption@object
+ \if@twocolumn
+ \ifoddpage
+ \if@firstcolumn% on right side
+ \setBottomCaption\setPageObject
+ \else % right column on right side
+ \setPageObject\setBottomCaption% start next firstcolumn next page
+ \fi
+ \else
+ \if@firstcolumn% on left side
+ \afterpage{\afterpage{\setBottomCaption\setPageObject}}% start next page/first column
+ \else% left page/column
+ \setBottomCaption\setPageObject% start on same page/column
+ \fi
+ \fi
+ \else % onecolumn
+ \setBottomCaption\setPageObject
+ \fi
+ \or% caption on the outer column 5->outer
+ \set@caption@object
+ \if@twocolumn
+ \ifoddpage
+ \if@firstcolumn
+ \afterpage{\afterpage{\setBottomCaption\setPageObject}}%
+ \else
+ \afterpage{\setBottomCaption\setPageObject}%
+ \fi
+ \else% even page (left)
+ \if@firstcolumn
+ \setBottomCaption\setPageObject
+ \else
+
+ \fi
+ \fi
+ \else% onecolumn
+ \setBottomCaption\setPageObject
+ \fi
+ \or% caption after object on same page 6->right for twocolumn
+ \if@twocolumn
+ \if@firstcolumn
+ \afterpage{\setPageObject\setBottomCaption}%
+ \else
+ \setPageObject\setBottomCaption
+ \fi
+ \else% always caption _after_ object for onecolumn
+ \setPageObject\setBottomCaption
+ \fi
+ \or% caption before object on same page 7->left for twocolumn
+ \if@twocolumn
+ \if@firstcolumn
+ \setBottomCaption\setPageObject
+ \else
+ \afterpage{\setBottomCaption\setPageObject}
+ \fi
+ \else% onecolumn -> same as before
+ \setBottomCaption\setPageObject
+ \fi
+ \fi
+ \endgroup% startet at main \hvFloat
+}%
+%
+\def\setBottomCaption{%
+ \begin{\hv@floatType}[!b]
+ \ifhv@separatorLine\drawSepLine\fi
+ \par
+ \usebox\hvCaptionBox
+ \end{\hv@floatType}%
+}
+
+\def\setPageObject{%
+ \ifhv@star
+ \begin{\hv@floatType*}[p]%
+ \else
+ \begin{\hv@floatType}[p]%
+ \fi
+ \ifhv@FULLPAGE
+ \vspace*{\the\dimexpr-1in-\voffset-\topmargin-\headheight-\headsep}%-0.5\baselineskip}%
+ \checkoddpage
+ \if@twoside
+ \ifoddpage
+ \hspace*{\the\dimexpr-\oddsidemargin-\parindent-1in}%
+ \else
+ \hspace*{\the\dimexpr-\evensidemargin-\parindent-1in}%
+ \fi
+ \else
+ \hspace*{\the\dimexpr-\oddsidemargin-\parindent-1in}%
+ \fi
+ %\put(0,0){
+ \AtBeginShipoutNext{\thispagestyle{empty}}%
+ \usebox\hvObjectBox%}%
+ \else
+ \usebox\hvObjectBox
+ \fi
+ \ifhv@star
+ \end{\hv@floatType*}%
+ \else
+ \end{\hv@floatType}%
+ \fi
+}
+
+\ExplSyntaxOn
+
+\def\getMultiCaptionAndLabel{%
+ \global\sbox\hvCaptionBox{\minipage[b]{\linewidth}%
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \setlength\belowcaptionskip{5pt}%
+ \setlength\abovecaptionskip{0pt}%
+ \hv@cntb=\clist_count:N\l_clist_Type
+ \advance\hv@cntb by \@ne
+ \hv@cnta=1
+ \loop
+ \edef\@captype{\clist_item:Nn\l_clist_Type{\hv@cnta}}%
+ \edef\@tempa{\clist_item:Nn\l_clist_LofCaption{\hv@cnta}}%
+ \ifx\@tempa\@empty
+ \caption{\clist_item:Nn\l_clist_Caption{\hv@cnta}}%
+ \else
+ \expandafter\caption\expandafter[\@tempa]{\clist_item:Nn\l_clist_Caption{\hv@cnta}}%
+ \fi
+ \edef\@tempa{\clist_item:Nn\l_clist_Label{\hv@cnta}}%
+ \ifx\@tempa\@empty
+ \else
+ \expandafter\label\expandafter{\clist_item:Nn\l_clist_Label{\hv@cnta}-cap}\fi
+ \advance\hv@cnta by \@ne
+ \ifnum\hv@cnta<\hv@cntb
+ \repeat
+ \endminipage}%
+}
+\def\getMultiObjectAndLabel{%
+ \global\sbox\hvObjectBox{\minipage{\linewidth}%
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \ifx\hvSet@objectPos\hv@Right\raggedleft\else
+ \ifx\hvSet@objectPos\hv@Left\raggedleft\else
+ \ifx\hvSet@objectPos\hv@Center\centering
+ \fi\fi\fi
+ \hv@cntb=\clist_count:N\l_clist_Type
+ \advance\hv@cntb by \@ne
+ \hv@cnta=1
+ \loop
+ \def\@temp{\clist_item:Nn\l_clist_Object{\hv@cnta}}%
+ \ifhv@objectFrame\frame{\@temp}\else\@temp\fi
+ \edef\@tempa{\clist_item:Nn\l_clist_Label{\hv@cnta}}%
+ \ifx\@tempa\@empty
+ \else
+ \refstepcounter{\@captype}%
+ \expandafter\label\expandafter{\clist_item:Nn\l_clist_Label{\hv@cnta}}%
+ \fi
+ \ifnum\hv@cnta<\clist_count:N\l_clist_Type\par\hv@vskip\fi
+ \advance\hv@cnta by \@ne
+ \ifnum\hv@cnta<\hv@cntb
+ \repeat
+ \endminipage}%
+}
+
+\def\getMultiSubCaptionAndLabel{%
+ \global\sbox\hvCaptionBox{\minipage{\linewidth}%
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \setlength\belowcaptionskip{5pt}%
+ \setlength\abovecaptionskip{0pt}%
+ \xdef\@captype{\clist_item:Nn\l_clist_Type{1}}% the same for all subfloats
+ \edef\@tempa{\clist_item:Nn\l_clist_LofCaption{1}}%
+ \ifx\@tempa\@empty
+ \caption{\clist_item:Nn\l_clist_Caption{1}}%
+ \else
+ \expandafter\caption\expandafter[\@tempa]{\clist_item:Nn\l_clist_Caption{1}}%
+ \fi
+ \edef\@tempa{\clist_item:Nn\l_clist_Label{1}}%
+ \ifx\@tempa\@empty\else\expandafter\label\expandafter{\clist_item:Nn\l_clist_Label{1}-cap}\fi
+ \endminipage}%
+}
+
+\def\getMultiSubObjectAndLabel{%
+ \global\sbox\hvObjectBox{\minipage{\linewidth}%
+ \ifx\relax\hv@subcaption@format\relax\else\captionsetup[sub]{\hv@subcaption@format}\fi
+ \ifx\hvSet@objectPos\hv@Right\raggedleft\else
+ \ifx\hvSet@objectPos\hv@Left\raggedleft\else
+ \ifx\hvSet@objectPos\hv@Center\centering
+ \fi\fi\fi
+ \hv@cntb=\clist_count:N\l_clist_Caption
+ \advance\hv@cntb by \@ne
+ \hv@cnta=2
+ \xdef\@captype{\clist_item:Nn\l_clist_Type{1}}% the same for all subfloats
+ \loop
+ \def\@temp{\clist_item:Nn\l_clist_Object{\hv@cnta}}%
+ \ifhv@objectFrame\frame{\@temp}\else\@temp\fi
+ \begingroup
+ \edef\@tempa{\clist_item:Nn\l_clist_LofCaption{\hv@cnta}}%
+ \ifx\@tempa\@empty
+ \subcaption{\clist_item:Nn\l_clist_Caption{\hv@cnta}}%
+ \else
+ \expandafter\subcaption\expandafter[\@tempa]{\clist_item:Nn\l_clist_Caption{\hv@cnta}}%
+ \fi
+ \edef\@tempa{\clist_item:Nn\l_clist_Label{\hv@cnta}}%
+ \ifx\@tempa\@empty
+ \else
+ \expandafter\label\expandafter{\clist_item:Nn\l_clist_Label{\hv@cnta}}%
+ \fi
+ \endgroup
+ \ifnum\hv@cnta<\clist_count:N\l_clist_Type\par\hv@vskip\fi
+ \advance\hv@cnta by \@ne
+ \ifnum\hv@cnta<\hv@cntb
+ \repeat
+ \edef\@tempa{\clist_item:Nn\l_clist_Label{1}}% the main label at the end
+ \ifx\@tempa\@empty
+ \else
+ \refstepcounter{\@captype}
+ \expandafter\label\expandafter{\@tempa}%
+ \fi
+ \endminipage}%
+}
+\ExplSyntaxOff
+
+\def\getSingleCaptionAndLabel{%
+ \global\sbox\hvCaptionBox{\minipage{\linewidth}%
+ \ifx\relax\hv@caption@format\relax\else\expandafter\captionsetup\expandafter{\hv@caption@format}\fi
+ \setlength\belowcaptionskip{5pt}%
+ \setlength\abovecaptionskip{0pt}%
+ \edef\@captype{\hv@floatType}%
+ \expandafter\ifx\expandafter\relax\hv@shortCap\relax
+ \caption{\hv@longCap}%
+ \else
+ \caption[\hv@shortCap]{\hv@longCap}%
+ \fi
+ \expandafter\ifx\expandafter\relax\hv@label\relax\else\label{\hv@label-cap}\fi
+ \endminipage}%
+}
+
+\def\set@caption@object{% first caption, then object
+ \ifhv@multiFloat
+ \getMultiCaptionAndLabel
+ \else
+ \ifhv@subFloat
+ \getMultiSubCaptionAndLabel
+ \else
+ \getSingleCaptionAndLabel
+ \fi
+ \fi
+ \edef\@captype{hv@p\hv@floatType}%
+ \ifhv@multiFloat
+ \getMultiObjectAndLabel
+ \else
+ \ifhv@subFloat
+ \getMultiSubObjectAndLabel
+ \else
+ \global\sbox\hvObjectBox{%
+ \refstepcounter{\@captype}%
+ \ifhv@objectFrame\frame{\hv@floatObject}\else\hv@floatObject\fi
+ \expandafter\ifx\expandafter\relax\hv@label\relax
+ \else
+ \expandafter\label\expandafter{\hv@label}%
+ \fi
+ }%
+ \fi
+ \fi
+}
+%
+\endinput