swfigure (11oct20)

git-svn-id: svn://tug.org/texlive/trunk@56637 c570f23f-e606-0410-a88d-b1316a301751

9 files changed, 479 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/swfigure/HSfakeimage.jpg b/Master/texmf-dist/doc/latex/swfigure/HSfakeimage.jpg
new file mode 100644
index 00000000000..47d8bb8d943
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/HSfakeimage.jpg
diff --git a/Master/texmf-dist/doc/latex/swfigure/NFfakeimage.jpg b/Master/texmf-dist/doc/latex/swfigure/NFfakeimage.jpg
new file mode 100644
index 00000000000..098557cd2f9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/NFfakeimage.jpg
diff --git a/Master/texmf-dist/doc/latex/swfigure/README.txt b/Master/texmf-dist/doc/latex/swfigure/README.txt
new file mode 100644
index 00000000000..702eefb35da
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/README.txt
@@ -0,0 +1,45 @@
+%%
+%% This is file `README.txt',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% swfigure.dtx  (with options: `readme')
+%% 
+%%   Copyright (C)  2020 Claudio Beccari  all rights reserved.
+%%   License information appended
+%% 
+
+File README.txt for package swfigure
+        [2020-10-11 v.0.9.07 Managing large and spread wide figures]
+This bundle contains file the swfigure.dtx and README.txt files.
+
+This file README.txt contains the licence, the status, and some 
+general information. Save both in a .../source/latex/swfigure 
+folder either in the main TeX system tree or in your personal 
+tree.
+
+This swfigure.dtx file is a self extracting documented one.
+Run pdfLaTeX at least twice on this file in order to get all 
+references correct, and you obtain the swfigure.pdf and the 
+swfigure.sty files. After extraction move the .sty file to 
+the .../tex/latex/swfigure folder, and move the .pdf file to 
+the .../doc/latex/swfigure folder. From the original folder
+.../source/latex/swfigure move all files, except the .dtx and 
+the .txt files, to the bin.
+
+The author disclaims any liability from every possible inconvenience 
+deriving from the use of this software; you use it at your own risk.
+
+%% 
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%% 
+%% This work is "maintained"
+%% 
+%% This work consists of files swfigure.dtx and READEME.txt, and the derived
+%% files swfigure.sty and swfigure.pdf
+%% 
+%%
+%% End of file `README.txt'.
diff --git a/Master/texmf-dist/doc/latex/swfigure/RFfakeimage.jpg b/Master/texmf-dist/doc/latex/swfigure/RFfakeimage.jpg
new file mode 100644
index 00000000000..be547643e96
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/RFfakeimage.jpg
diff --git a/Master/texmf-dist/doc/latex/swfigure/SWfakeImage.jpg b/Master/texmf-dist/doc/latex/swfigure/SWfakeImage.jpg
new file mode 100644
index 00000000000..bd247babebe
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/SWfakeImage.jpg
diff --git a/Master/texmf-dist/doc/latex/swfigure/VSfakeimage.jpg b/Master/texmf-dist/doc/latex/swfigure/VSfakeimage.jpg
new file mode 100644
index 00000000000..71e5ee0473e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/VSfakeimage.jpg
diff --git a/Master/texmf-dist/doc/latex/swfigure/swfigure-examples.pdf b/Master/texmf-dist/doc/latex/swfigure/swfigure-examples.pdf
new file mode 100644
index 00000000000..5ef68cb2cea
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/swfigure-examples.pdf
diff --git a/Master/texmf-dist/doc/latex/swfigure/swfigure-examples.tex b/Master/texmf-dist/doc/latex/swfigure/swfigure-examples.tex
new file mode 100644
index 00000000000..17513fdd2f8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/swfigure-examples.tex
@@ -0,0 +1,434 @@
+% !TEX encoding = UTF-8 Unicode
+% !TEX TS-program = pdflatex
+\documentclass[twoside,notitlepage]{report}\errorcontextlines=100
+\usepackage[utf8]{inputenc}
+\usepackage{lmodern,textcomp,multicol,enumitem,mflogo,xcolor,fancyvrb}
+\usepackage{swfigure}
+
+\providecommand*\diff{\mathop{}\!\mathrm{d}}
+\providecommand\cs{}
+  \renewcommand\cs[1]{\normalfont{\texttt{\char92#1}}}
+\providecommand\meta{}
+  \renewcommand\meta[1]{{\normalfont\textlangle\textit{#1}\textrangle}}
+\providecommand\marg{}
+  \renewcommand\marg[1]{\texttt{\{\meta{#1}\}}}
+\providecommand\Marg{}
+  \renewcommand\Marg[1]{\texttt{\{#1\}}}
+\providecommand\oarg{}
+  \renewcommand\oarg[1]{\texttt{[\meta{#1}]}}
+\providecommand\Oarg{}
+  \renewcommand\Oarg[1]{\texttt{[#1]}}
+\providecommand\aarg{}
+  \renewcommand\aarg[1]{\texttt{<\meta{#1}>}}
+\providecommand\Aarg{}
+  \renewcommand\Aarg[1]{\texttt{<#1>}}
+\providecommand\parg{}
+  \renewcommand\parg[1]{\texttt{(\meta{#1})}}
+\providecommand\Parg{}
+  \renewcommand\Parg[1]{\texttt{(#1)}}
+\providecommand\pack{}
+  \renewcommand\pack[1]{\textsf{#1}}
+\providecommand\eTeX{}
+  \renewcommand\eTeX{\lower0.5ex\hbox{$\varepsilon\!$}\TeX}
+\providecommand\file{}
+  \renewcommand\file[1]{{\normalfont\sffamily\slshape#1}}
+
+\newbox\SWsynt
+
+\newenvironment{medaglione}%
+{\par\medskip\fboxrule=0.8pt\fboxsep6pt\relax
+\begin{lrbox}{\SWsynt}\minipage{\dimexpr\linewidth-2\fboxsep-2\fboxrule}}%
+{\endminipage\end{lrbox}\noindent\fbox{\box\SWsynt}\par\medskip}
+
+\newenvironment{ttsyntax}{\medaglione\raggedright\ttfamily\obeylines}{\endmedaglione}
+
+\providecommand\setfontsize{}
+\DeclareRobustCommand\setfontsize[2][1.2]{%
+\linespread{#1}\fontsize{#2}{#2}\selectfont}
+
+
+\makeatletter
+\providecommand\GetFileInfo[1]{%
+  \def\filename{#1}%
+  \def\@tempb##1 v.##2 ##3\relax##4\relax{%
+    \def\filedate{##1}%
+    \def\fileversion{##2}%
+    \def\fileinfo{##3}}%
+  \edef\@tempa{\csname ver@#1\endcsname}%
+  \expandafter\@tempb\@tempa\relax? ? \relax\relax}
+
+\counterwithout{section}{chapter}
+
+\begin{document}
+\GetFileInfo{swfigure.sty}
+\title{The \pack{swfigure} package --- Usage examples}
+\author{Claudio Beccari\thanks{Email: \texttt{claudio dot beccari at gmail dot com}}}
+\date{Version \fileversion~---~ Last revised \filedate}
+\maketitle
+
+\begin{abstract}
+Managing large images is not that straightforward to do. Package \pack{swfigure} was initially created to handle such large figures that required a whole spread to display them; the package initial letters SW are the acronym of Spread Wide. While developing this package, other display modes were introduced, so that with a single user command it is possible to display a large image in five different modes, that are to be chosen according to the figure aspect ratio, and the page design of the document.
+This package works pretty well with two side printed documents with a symmetrical page design, i.e. with the same dimension for the inner margins and, respectively, the outer margins. The documented \TeX\ file that describes the software does not have a symmetrical design, therefore this second file is necessary in order to show some examples.
+\end{abstract}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Introduction}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+Please, before going on reading, set your PDF viewer so that it displays two pages at time, and with the even numbered pages on the left. Only with these settings you can see the spread wide images. Some viewers display the facing pages with a little gap between them; if you don't have available a viewer that avoids this gap, simply imagine that the gap did not exist.
+
+As far as we can say, we know that Preview.app on Macs does not use any gap. Okular on Linux does not use any gap, but traces a thin black line were the facing pages join. Adobe Reader for Windows and other platforms, has several settings for displaying two pages at a time, but only one eliminates the gap while displaying the even numbered page on the left. 
+
+It is possible to see a spread wide figure in the next two pages; a fake figure is displayed and you see that the crossing of the diagonal and medial lines takes place exactly on the spine. It was composed with the following command:
+\begin{flushleft}\ttfamily\obeylines
+\cs{DFimage}Oarg{SW}\Marg{SWfakeimage}\Marg{A Spread Wide fake image}\Oarg{fig:SWfake}
+\end{flushleft}
+
+\DFimage[SW]{SWfakeimage}{A spread wide fake image}[fig:SWfake]
+
+Other examples are shown in the following pages; the filling text is a generic text, not actually a non sense fake Latin wording such as that provided by the \pack{lipsum} package, but it is taken form package \pack{kantlipsum} where sentences appear as plain English, although we doubt that Emmanuel Kant wrote those very texts. 
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{The user macro}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The only user macro defined by this pckge has the following syntax:
+\begin{ttsyntax}
+\cs{DFimage}\oarg{display mode}\marg{image file name}\oarg{lof entry}\%
+\qquad\marg{caption}\oarg{label}\parg{height correction}\aarg{line correction}
+\end{ttsyntax}
+The arguments are described in detail in the twin document \file{swfigure.pdf}. We shortly repeat their meanings.
+\begin{description}[noitemsep]
+%
+\item[\meta{display mode}] See below the various display modes.
+%
+\item[\meta{image file name}] is the name, optionally without extension, of the graphics file that contains the image; remember that the \LaTeX\ dependent typesetting engines accept graphics files in the formats described by the extensions \texttt{.pdf}, \texttt{.eps}, \texttt{.jpg}, \texttt{.png}, and few other less known formats.
+%
+\item[\meta{lof entry}] is a short phrase that shortens the figure caption. In practice it is the optional argument of the \cs{caption} command.
+%
+\item[\meta{caption}] is the caption text, in practice the mandatory argument of the \cs{caption} command.
+%
+\item[\meta{label}] is the argument of the \cs{label} command; it is evident that if this optional argument is not specified, the figure cannot be referenced with the usual commands \cs{ref}, \cs{pageref}, and other similar ones.
+%
+\item[\meta{height correction}] is an optional argument with a preset value of 0.8, it reduces the image height by that value, in order to assure that the figure has enough space for the image and its caption; if captions are not “narrative” (too many sentences) the value of 0.8 should be suited in most cases; the user, while revising the document drafts might decide to use a different value, of course always not greater than~1. This correction may be used with some display modes that concern only one page, not a full spread.
+%
+\item[\meta{line correction}] This optional integer number may correct the number of lines of the indention of the wrapping text around a tall and slim figure.
+%
+\end{description}
+
+We stress the first optional argument meaning, whose default value is \texttt{SW}. It specifies the \meta{display mode}.
+\begin{description}[noitemsep]
+%
+\item[\texttt{SW}] is the acronym that specifies the \meta{display mode} for a  Spread Wide figure; it consists into a full spread, without any text, and with its caption typeset in the external margin of the odd numbered page in a vertical fashion. Since this display mode needs to start on an even page, the user should carefully find the proper place where to insert the user macro \cs{DGimage} (named as “steering” macro, since it decides which large figure style to use), because it starts a new page and possibly inserts a blank page if the new one is odd numbered.
+%
+\item[\texttt{HS}] refers to a Horizontal Slim image, that requires a spread wide display mode, such that the first of the facing pages is an even numbered one, and with some text beneath both half images; since the caption is under the right half, the space occupied by this part of the image is higher than that in the facing page, it is necessary to equalise these vertical spaces, and the specific code takes care of this constraint. Also in this case the user should carefully chose the place where to insert the steering macro.
+%
+\item[\texttt{VS}] This case refers to a Vertical Slim image. this situation requires a really slim image, so that if its “height over width” ratio (its aspect ratio) si smaller than~2, the macro does not insert anything, except a message in its place, that informs the user about the cause of this refusal and suggests other display modes. The procedure is based on the use of the \pack{wrapfig} functionalities; this package has several limitations that the user should check in its documentation. Nevertheless, if there is enough “normal” text available to wrap the figure, the result is quite good. There are two parameters to fine tune the wrapped image with its caption: the \meta{height correction} and the \meta{line correction}.
+%
+\item[\texttt{NF}] This display mode is the Normal Figure \LaTeX\ kernel mode; the floating figure is floated to a “floats only” page; since it contains a large image this is a reasonable solution; if the caption is pretty lengthy, the \meta{height correction} comes handy to fine tune the space necessary to the caption.
+%
+\item[\texttt{RF}] This fifth display mode refers to the Rotated Figure obtainable by means of the \pack{lscape} package; here the package is not used, but a direct rotation is performed by the macro. Again the \meta{height correction} optional value may be useful in order to leave more or less space to the caption; if the latter is pretty wordy, a smaller value of the preset 0.8 value mai be chosen, while for a single line caption a slightly higher value may be convenient.
+%
+\end{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{A \texttt{HS} example}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+On pages~\pageref{fig:HSfake} and the preceding one there is an example of a horizontal slim image.
+
+As any dedicated reader can clearly see, the Ideal of
+practical reason is a representation of, as far as I know, the things
+in themselves; as I have shown elsewhere, the phenomena should only be
+used as a canon for our understanding. The paralogisms of practical
+reason are what first give rise to the architectonic of practical
+reason. As will easily be shown in the next section, reason would
+thereby be made to contradict, in view of these considerations, the
+Ideal of practical reason, yet the manifold depends on the phenomena.
+Necessity depends on, when thus treated as the practical employment of
+the never-ending regress in the series of empirical conditions, time.
+Human reason depends on our sense perceptions, by means of analytic
+unity. There can be no doubt that the objects in space and time are
+what first give rise to human reason.
+
+\DFimage[HS]{HSfakeimage}{A Horizontal Slim fake image}[fig:HSfake]
+
+Let us suppose that the noumena have nothing to do
+with necessity, since knowledge of the Categories is a
+posteriori. Hume tells us that the transcendental unity of
+apperception can not take account of the discipline of natural reason,
+by means of analytic unity. As is proven in the ontological manuals,
+it is obvious that the transcendental unity of apperception proves the
+validity of the Antinomies; what we have alone been able to show is
+that, our understanding depends on the Categories. It remains a
+mystery why the Ideal stands in need of reason. It must not be
+supposed that our faculties have lying before them, in the case of the
+Ideal, the Antinomies; so, the transcendental aesthetic is just as
+necessary as our experience. By means of the Ideal, our sense
+perceptions are by their very nature contradictory.
+
+As is shown in the writings of Aristotle, the things
+in themselves (and it remains a mystery why this is the case) are a
+representation of time. Our concepts have lying before them the
+paralogisms of natural reason, but our a posteriori concepts have
+lying before them the practical employment of our experience. Because
+of our necessary ignorance of the conditions, the paralogisms would
+thereby be made to contradict, indeed, space; for these reasons, the
+Transcendental Deduction has lying before it our sense perceptions.
+(Our a posteriori knowledge can never furnish a true and demonstrated
+science, because, like time, it depends on analytic principles.) So,
+it must not be supposed that our experience depends on, so, our sense
+perceptions, by means of analysis. Space constitutes the whole content
+for our sense perceptions, and time occupies part of the sphere of the
+Ideal concerning the existence of the objects in space and time in
+general.
+
+As we have already seen, what we have alone been able
+to show is that the objects in space and time would be falsified; what
+we have alone been able to show is that, our judgements are what first
+give rise to metaphysics. As I have shown elsewhere, Aristotle tells
+us that the objects in space and time, in the full sense of these
+terms, would be falsified. Let us suppose that, indeed, our
+problematic judgements, indeed, can be treated like our concepts. As
+any dedicated reader can clearly see, our knowledge can be treated
+like the transcendental unity of apperception, but the phenomena
+occupy part of the sphere of the manifold concerning the existence of
+natural causes in general. Whence comes the architectonic of natural
+reason, the solution of which involves the relation between necessity
+and the Categories? Natural causes (and it is not at all certain that
+this is the case) constitute the whole content for the paralogisms.
+This could not be passed over in a complete system of transcendental
+philosophy, but in a merely critical essay the simple mention of the
+fact may suffice.
+
+Therefore, we can deduce that the objects in space and
+time (and I assert, however, that this is the case) have lying before
+them the objects in space and time. Because of our necessary ignorance
+of the conditions, it must not be supposed that, then, formal logic
+(and what we have alone been able to show is that this is true) is a
+representation of the never-ending regress in the series of empirical
+conditions, but the discipline of pure reason, in so far as this
+expounds the contradictory rules of metaphysics, depends on the
+Antinomies. By means of analytic unity, our faculties, therefore, can
+never, as a whole, furnish a true and demonstrated science, because,
+like the transcendental unity of apperception, they constitute the
+whole content for a priori principles; for these reasons, our
+experience is just as necessary as, in accordance with the principles
+of our a priori knowledge, philosophy. The objects in space and time
+abstract from all content of knowledge. Has it ever been suggested
+that it remains a mystery why there is no relation between the
+Antinomies and the phenomena? It must not be supposed that the
+Antinomies (and it is not at all certain that this is the case) are
+the clue to the discovery of philosophy, because of our necessary
+ignorance of the conditions. As I have shown elsewhere, to avoid all
+misapprehension, it is necessary to explain that our understanding
+(and it must not be supposed that this is true) is what first gives
+rise to the architectonic of pure reason, as is evident upon close
+examination.
+
+\DFimage[VS]{VSfakeimage}{A Vertical Slim fake image}[fig:VSfake](0.7)<2>
+The things in themselves are what first give rise to
+reason, as is proven in the ontological manuals. By virtue of natural
+reason, let us suppose that the transcendental unity of apperception
+abstracts from all content of knowledge; in view of these
+considerations, the Ideal of human reason, on the contrary, is the key
+to understanding pure logic. Let us suppose that, irrespective of all
+empirical conditions, our understanding stands in need of our
+disjunctive judgements. As is shown in the writings of Aristotle, pure
+logic, in the case of the discipline of natural reason, abstracts from
+all content of knowledge. Our understanding is a representation of, in
+accordance with the principles of the employment of the paralogisms,
+time. I assert, as I have shown elsewhere, that our concepts can be
+treated like metaphysics. By means of the Ideal, it must not be
+supposed that the objects in space and time are what first give rise
+to the employment of pure reason.
+
+\DFimage[NF]{NFfakeimage}{A large Normal Figure fake image}[fig:NFfake]
+
+As is evident upon close examination, to avoid all
+misapprehension, it is necessary to explain that, on the contrary, the
+never-ending regress in the series of empirical conditions is a
+representation of our inductive judgements, yet the things in
+themselves prove the validity of, on the contrary, the Categories.  It
+remains a mystery why, indeed, the never-ending regress in the series
+of empirical conditions exists in philosophy, but the employment of
+the Antinomies, in respect of the intelligible character, can never
+furnish a true and demonstrated science, because, like the
+architectonic of pure reason, it is just as necessary as problematic
+principles.  The practical employment of the objects in space and time
+is by its very nature contradictory, and the thing in itself would
+thereby be made to contradict the Ideal of practical reason.  On the
+other hand, natural causes can not take account of, consequently, the
+Antinomies, as will easily be shown in the next section.
+Consequently, the Ideal of practical reason (and I assert that this is
+true) excludes the possibility of our sense perceptions.  Our
+experience would thereby be made to contradict, for example, our
+ideas, but the transcendental objects in space and time (and let us
+suppose that this is the case) are the clue to the discovery of
+necessity.  But the proof of this is a task from which we can here be
+absolved.
+
+\DFimage[RF]{RFfakeimage}{A large Rotated Figure fake image}[fig:RFfake]
+
+As any dedicated reader can clearly see, the Ideal of
+practical reason is a representation of, as far as I know, the things
+in themselves; as I have shown elsewhere, the phenomena should only be
+used as a canon for our understanding. The paralogisms of practical
+reason are what first give rise to the architectonic of practical
+reason. As will easily be shown in the next section, reason would
+thereby be made to contradict, in view of these considerations, the
+Ideal of practical reason, yet the manifold depends on the phenomena.
+Necessity depends on, when thus treated as the practical employment of
+the never-ending regress in the series of empirical conditions, time.
+Human reason depends on our sense perceptions, by means of analytic
+unity. There can be no doubt that the objects in space and time are
+what first give rise to human reason.
+
+Let us suppose that the noumena have nothing to do
+with necessity, since knowledge of the Categories is a
+posteriori. Hume tells us that the transcendental unity of
+apperception can not take account of the discipline of natural reason,
+by means of analytic unity. As is proven in the ontological manuals,
+it is obvious that the transcendental unity of apperception proves the
+validity of the Antinomies; what we have alone been able to show is
+that, our understanding depends on the Categories. It remains a
+mystery why the Ideal stands in need of reason. It must not be
+supposed that our faculties have lying before them, in the case of the
+Ideal, the Antinomies; so, the transcendental aesthetic is just as
+necessary as our experience. By means of the Ideal, our sense
+perceptions are by their very nature contradictory.
+
+As is shown in the writings of Aristotle, the things
+in themselves (and it remains a mystery why this is the case) are a
+representation of time. Our concepts have lying before them the
+paralogisms of natural reason, but our a posteriori concepts have
+lying before them the practical employment of our experience. Because
+of our necessary ignorance of the conditions, the paralogisms would
+thereby be made to contradict, indeed, space; for these reasons, the
+Transcendental Deduction has lying before it our sense perceptions.
+(Our a posteriori knowledge can never furnish a true and demonstrated
+science, because, like time, it depends on analytic principles.) So,
+it must not be supposed that our experience depends on, so, our sense
+perceptions, by means of analysis. Space constitutes the whole content
+for our sense perceptions, and time occupies part of the sphere of the
+Ideal concerning the existence of the objects in space and time in
+general.
+
+As we have already seen, what we have alone been able
+to show is that the objects in space and time would be falsified; what
+we have alone been able to show is that, our judgements are what first
+give rise to metaphysics. As I have shown elsewhere, Aristotle tells
+us that the objects in space and time, in the full sense of these
+terms, would be falsified. Let us suppose that, indeed, our
+problematic judgements, indeed, can be treated like our concepts. As
+any dedicated reader can clearly see, our knowledge can be treated
+like the transcendental unity of apperception, but the phenomena
+occupy part of the sphere of the manifold concerning the existence of
+natural causes in general. Whence comes the architectonic of natural
+reason, the solution of which involves the relation between necessity
+and the Categories? Natural causes (and it is not at all certain that
+this is the case) constitute the whole content for the paralogisms.
+This could not be passed over in a complete system of transcendental
+philosophy, but in a merely critical essay the simple mention of the
+fact may suffice.
+
+Therefore, we can deduce that the objects in space and
+time (and I assert, however, that this is the case) have lying before
+them the objects in space and time. Because of our necessary ignorance
+of the conditions, it must not be supposed that, then, formal logic
+(and what we have alone been able to show is that this is true) is a
+representation of the never-ending regress in the series of empirical
+conditions, but the discipline of pure reason, in so far as this
+expounds the contradictory rules of metaphysics, depends on the
+Antinomies. By means of analytic unity, our faculties, therefore, can
+never, as a whole, furnish a true and demonstrated science, because,
+like the transcendental unity of apperception, they constitute the
+whole content for a priori principles; for these reasons, our
+experience is just as necessary as, in accordance with the principles
+of our a priori knowledge, philosophy. The objects in space and time
+abstract from all content of knowledge. Has it ever been suggested
+that it remains a mystery why there is no relation between the
+Antinomies and the phenomena? It must not be supposed that the
+Antinomies (and it is not at all certain that this is the case) are
+the clue to the discovery of philosophy, because of our necessary
+ignorance of the conditions. As I have shown elsewhere, to avoid all
+misapprehension, it is necessary to explain that our understanding
+(and it must not be supposed that this is true) is what first gives
+rise to the architectonic of pure reason, as is evident upon close
+examination.
+
+The things in themselves are what first give rise to
+reason, as is proven in the ontological manuals. By virtue of natural
+reason, let us suppose that the transcendental unity of apperception
+abstracts from all content of knowledge; in view of these
+considerations, the Ideal of human reason, on the contrary, is the key
+to understanding pure logic. Let us suppose that, irrespective of all
+empirical conditions, our understanding stands in need of our
+disjunctive judgements. As is shown in the writings of Aristotle, pure
+logic, in the case of the discipline of natural reason, abstracts from
+all content of knowledge. Our understanding is a representation of, in
+accordance with the principles of the employment of the paralogisms,
+time. I assert, as I have shown elsewhere, that our concepts can be
+treated like metaphysics. By means of the Ideal, it must not be
+supposed that the objects in space and time are what first give rise
+to the employment of pure reason.
+
+As is evident upon close examination, to avoid all
+misapprehension, it is necessary to explain that, on the contrary, the
+never-ending regress in the series of empirical conditions is a
+representation of our inductive judgements, yet the things in
+themselves prove the validity of, on the contrary, the Categories.  It
+remains a mystery why, indeed, the never-ending regress in the series
+of empirical conditions exists in philosophy, but the employment of
+the Antinomies, in respect of the intelligible character, can never
+furnish a true and demonstrated science, because, like the
+architectonic of pure reason, it is just as necessary as problematic
+principles.  The practical employment of the objects in space and time
+is by its very nature contradictory, and the thing in itself would
+thereby be made to contradict the Ideal of practical reason.  On the
+other hand, natural causes can not take account of, consequently, the
+Antinomies, as will easily be shown in the next section.
+Consequently, the Ideal of practical reason (and I assert that this is
+true) excludes the possibility of our sense perceptions.  Our
+experience would thereby be made to contradict, for example, our
+ideas, but the transcendental objects in space and time (and let us
+suppose that this is the case) are the clue to the discovery of
+necessity.  But the proof of this is a task from which we can here be
+absolved.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Used commands}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+The various large fake images have been inserted with the following commands:
+\begin{itemize}[noitemsep]
+%
+\item figure~\ref{fig:SWfake}
+\begin{Verbatim}[fontsize=\setfontsize{9.7}]
+\DFimage[SW]{SWfakeimage}{A Spread Wide fake image}[fig:SWfake]
+\end{Verbatim}
+%
+\item figure~\ref{fig:HSfake}
+\begin{Verbatim}[fontsize=\setfontsize{9}]
+\DFimage[HS]{HSfakeimage}{A Horizonta Slim fake image}[fig:HSfake]
+\end{Verbatim}
+%
+\item figure~\ref{fig:VSfake}
+\begin{Verbatim}[fontsize=\setfontsize{8}]
+\DFimage[VS]{VSfakeimage}{A Vertical Slim fake image}[fig:VSfake](0.7)<2>
+\end{Verbatim}
+%
+\item figure~\ref{fig:NFfake}
+\begin{Verbatim}
+\DFimage[NF]{NFfakeimage}{A large Normal Figure fake image}%
+    [fig:NFfake]
+\end{Verbatim}
+%
+\item figure~\ref{fig:RFfake}
+\begin{Verbatim}
+\DFimage[RF]{RFfakeimage}{A large Rotated Figure fake image}%
+    [fig:RFfake]
+\end{Verbatim}
+\end{itemize}
+%
+\listoffigures
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/swfigure/swfigure.pdf b/Master/texmf-dist/doc/latex/swfigure/swfigure.pdf
new file mode 100644
index 00000000000..5e3fad2b04f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/swfigure/swfigure.pdf