pdflatexpicscale (23jan17)

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

5 files changed, 58 insertions, 7 deletions

diff --git a/Master/texmf-dist/doc/support/pdflatexpicscale/README b/Master/texmf-dist/doc/support/pdflatexpicscale/README
index 97d31c5d27a..5d3cd905086 100644
--- a/Master/texmf-dist/doc/support/pdflatexpicscale/README
+++ b/Master/texmf-dist/doc/support/pdflatexpicscale/README
@@ -2,6 +2,10 @@ pdflatexpicscale is software to scale pictures down
 to a target resolution before creating a PDF document
 with PdfLaTeX.
 
+*Version*
+2017-01-23
+For version details check pdflatexpicscale.pdf.
+
 *Requirements*
 Perl and ImageMagick have to be installed.
 
diff --git a/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.pdf b/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.pdf
index 2719a546c7a..47c7d9354d7 100644
--- a/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.pdf
+++ b/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.pdf
diff --git a/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.tex b/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.tex
index ce15238676b..323d09c7d1c 100644
--- a/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.tex
+++ b/Master/texmf-dist/doc/support/pdflatexpicscale/pdflatexpicscale.tex
@@ -1,10 +1,11 @@
 \documentclass[10pt,a4paper]{article}
 \usepackage{hologo} % used for LuaTeX, PdfTeX and PdfLaTeX logos
 \usepackage{graphicx}
+\usepackage{textcomp}
 \usepackage{url}
 \title{pdflatexpicscale}
 \author{Peter Willadt\footnote{willadt at t-online.de}}
-\date{2016-08-02}
+\date{2017-01-23} %version #version
 \begin{document}
 \maketitle
 
@@ -25,7 +26,31 @@ and there may be situations where you need e.g. low-res pictures for the web
 and high-res pictures for print. When there are requirements that force the
 size of images in our document to change, the fun will probably be gone.
 
-Hopefully TUGboat will accept an article accompanying this description. 
+There is an article in TUGboat (\url{%
+  https://www.tug.org/members/TUGboat/tb37-3/tb117willadt.pdf}) accompanying
+this package, for now (january, 2017) it is only available to TUG members; a
+public release will follow at the beginning of 2018, as with all TUGboat
+articles. 
+
+
+\subsection{Similiar Work/Prior Art}
+
+There have been prior attempts to do similiar things. I found
+\texttt{degrade.sty}\footnote{see
+  \url{http://mirror.ctan.org/graphics/degrade}} 
+ and an equivalent con\TeX t module, there are at least two threads on
+ stackexchange\footnote{see
+   \texttt{http://tex.stackexchange.com/questions/14429/\\
+pdftex-reduce-pdf-size-reduce-image-quality}
+and 
+\texttt{http://tex.stackexchange.com/\\questions/2198/how-to-create-small-pdf-files-for-the-internet}}
+ and there had been, as
+I have learned, some work by Axel Berger and others, posted 2011-03-31 on
+\texttt{de.comp.text.tex}. 
+
+But what motivated me most to find something better than scaling pictures
+individually was seeing that Adobe InDesign\textregistered\ does
+scale graphics according to the output intent.
 
 \section{Installation}
 
@@ -272,7 +297,12 @@ version of the \LaTeX\ project public license.
 \section{Bugs, Improvements, and Changes}
 
 Please submit bug reports to the package author (me). I will be glad to make
-the package better.
+the package better.\label{bugs}
+
+The file version dates of all the files in this package shall be kept
+consistent, even if only one of the files changes. pdflatexpicscale.pl,
+however, has also a version number. This number will only be changed when
+there are functional changes to pdflatexpicscale.pl. 
 
 \subsection{Changelog}
 
@@ -288,4 +318,14 @@ in the log file.
 called without arguments. Added the argument \texttt{--help}, both due to
 suggestions by Karl Berry (thanks a lot).
 
+\paragraph{2016-12-12} Section on similiar work and prior art added (on request).
+
+\paragraph{2017-01-22} Added url of TUGboat article.
+
+\paragraph{2017-01-23} Fixed inconsistent version numbers and changed the url
+of degrade.sty on recommendation of CTAN board. Added text on versioning at
+the beginning of section~\ref{bugs}. Thanks a lot to the always quick action
+and helpful and polite hints.
+
+% for file version please see line 8
 \end{document}
diff --git a/Master/texmf-dist/doc/support/pdflatexpicscale/testprinter.ps b/Master/texmf-dist/doc/support/pdflatexpicscale/testprinter.ps
index e6e17254a0b..a60b0baf6e0 100644
--- a/Master/texmf-dist/doc/support/pdflatexpicscale/testprinter.ps
+++ b/Master/texmf-dist/doc/support/pdflatexpicscale/testprinter.ps
@@ -1,6 +1,8 @@
 %!PS
 % Halftone testing inspired by PS by Example P. 544 ff
 % Willadt 2016-07-27
+% version 2017-01-23  #version %version
+% for information on usage and changes see pdflatexpicscale.pdf
 /prozente 20 string def
 
 /Palatino-Roman findfont
diff --git a/Master/texmf-dist/scripts/pdflatexpicscale/pdflatexpicscale.pl b/Master/texmf-dist/scripts/pdflatexpicscale/pdflatexpicscale.pl
index b37516de7e8..9062e68b233 100755
--- a/Master/texmf-dist/scripts/pdflatexpicscale/pdflatexpicscale.pl
+++ b/Master/texmf-dist/scripts/pdflatexpicscale/pdflatexpicscale.pl
@@ -1,15 +1,20 @@
 #!/usr/bin/perl -w
 # Scale pictures to be included into a LaTeX generated PDF file.
-# version 0.2 written by peter willadt 
-# contact willadt at t-online.de
+# written by peter willadt 
+# contact: willadt at t-online.de
 # this software is subject to the LaTeX project public license.
 # changes:
 # 2016-07-27 first public release
 # 2016-08-02 changed regex to prevent problem with long filenames
 # 2016-08-02 changed > to gt (shame on me)
 # 2016-10-20 corrected behaviour when program gets called without arguments
-# (shame on me, again)
+#            (shame on me, again)
 # 2016-10-20 added undocumented switch --help to show usage.
+# 2017-01-23 Updated documentation (see pdflatexpicscale.tex), 
+#            and corrected version number 
+#            Please note: version numbers will be updated to keep sync
+#            with the documentation, even when the perl code does not change.
+#
 use strict;
 use File::Basename;
 use File::Spec;
@@ -17,7 +22,7 @@ use File::Copy;
 use Getopt::Long;
 
 my $version = '0.3';
-my $versiondate = '2016-10-20';
+my $versiondate = '2017-01-23';           #version %version
 my $showversion;
 
 my $verbose;