fitbox (17aug15)

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

7 files changed, 114 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/fitbox/Makefile b/Master/texmf-dist/doc/latex/fitbox/Makefile
new file mode 100644
index 00000000000..d5bc79b993f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fitbox/Makefile
@@ -0,0 +1,61 @@
+#
+#
+# This file is in public domain
+#
+# $Id: Makefile,v 1.2 2015-02-27 22:01:15 boris Exp $
+#
+
+PACKAGE=fitbox
+SAMPLES = sample.tex
+
+all:  $(PACKAGE).pdf ${SAMPLES:%.tex=%.pdf} 
+
+%.pdf:  %.dtx   $(PACKAGE).sty
+	pdflatex $<
+	- bibtex $*
+	pdflatex $<
+	- makeindex -s gind.ist -o $*.ind $*.idx
+	- makeindex -s gglo.ist -o $*.gls $*.glo
+	pdflatex $<
+	while ( grep -q '^LaTeX Warning: Label(s) may have changed' $*.log) \
+	do pdflatex $<; done
+
+
+
+
+%.sty:   %.ins %.dtx  
+	pdflatex $<
+
+%.pdf:  %.tex $(PACKAGE).sty
+	pdflatex $*
+	-bibtex $*
+	pdflatex $*
+	while ( grep -q '^LaTeX Warning: Label(s) may have changed' $*.log) \
+	do pdflatex $*; done
+
+
+.PRECIOUS:  $(PACKAGE).cfg $(PACKAGE).sty
+
+
+clean:
+	$(RM)  $(PACKAGE).sty *.log *.aux \
+	*.cfg *.glo *.idx *.toc \
+	*.ilg *.ind *.out *.lof \
+	*.lot *.bbl *.blg *.gls *.hd \
+	*.dvi *.ps *.tgz *.zip *.brf
+
+veryclean: clean
+	$(RM) $(PACKAGE).pdf ${SAMPLES:%.tex=%.pdf} 
+
+distclean: veryclean
+
+#
+# Archive for the distribution. Includes typeset documentation
+#
+archive:  all clean
+	tar -czvf $(PACKAGE).tgz -C .. --exclude '*~' --exclude '*.tgz' --exclude CVS $(PACKAGE)
+
+zip:  all clean
+	${MAKE} $(PACKAGE).sty
+	$(RM) *.log
+	zip -r  $(PACKAGE).zip * -x '*~' -x '*.tgz' -x '*.zip' -x CVS -x 'CVS/*'
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/fitbox/README b/Master/texmf-dist/doc/latex/fitbox/README
new file mode 100644
index 00000000000..48232ed90eb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fitbox/README
@@ -0,0 +1,7 @@
+			Fit graphics on a page
+			    Boris Veytsman
+
+The fitbox package allows a box (usually an \includegraphics box) to
+fit on the page.  It scales the box to the maximal allowed size within
+the user-set limits. If there there is not enough space on the page,
+the box is moved to the next one.
diff --git a/Master/texmf-dist/doc/latex/fitbox/fitbox.bib b/Master/texmf-dist/doc/latex/fitbox/fitbox.bib
new file mode 100644
index 00000000000..8e3f9e1727f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fitbox/fitbox.bib
@@ -0,0 +1,6 @@
+@misc{TeXFAQ,
+  author =        {{UK \TeX{} Users Group}},
+  howpublished =  {\url{http://www.tex.ac.uk/cgi-bin/texfaq2html}},
+  title =         {{UK} List of {\TeX} Frequently Asked Questions},
+  year =          {2015},
+}
diff --git a/Master/texmf-dist/doc/latex/fitbox/fitbox.pdf b/Master/texmf-dist/doc/latex/fitbox/fitbox.pdf
new file mode 100644
index 00000000000..995ff4f73e1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fitbox/fitbox.pdf
diff --git a/Master/texmf-dist/doc/latex/fitbox/sample.pdf b/Master/texmf-dist/doc/latex/fitbox/sample.pdf
new file mode 100644
index 00000000000..8a3f6e5ab42
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fitbox/sample.pdf
diff --git a/Master/texmf-dist/doc/latex/fitbox/sample.tex b/Master/texmf-dist/doc/latex/fitbox/sample.tex
new file mode 100644
index 00000000000..ea8c2b60ad3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fitbox/sample.tex
@@ -0,0 +1,40 @@
+\documentclass{article}
+\usepackage{graphicx}
+\usepackage{fitbox}
+\begin{document}
+
+We start from an image at maximal size:
+
+{\centering\fitbox{\includegraphics{vitruvian}}\par}
+
+Now it is resized.  Here we allow down to 50\% of scale:
+
+{\centering\fitbox[minheight=0.5\fitboxnatheight,
+  minwidth=0.5\fitboxnatwidth]{\includegraphics{vitruvian}}\par}
+
+
+
+
+Now we make the figure smaller:
+
+{\centering\fitbox[maxwidth=\fitboxnatwidth, 
+  maxheight=\fitboxnatwidth]{\includegraphics{vitruvian}}\par}
+
+{\centering\fitbox[maxwidth=\fitboxnatwidth, 
+  maxheight=\fitboxnatwidth]{\includegraphics{vitruvian}}\par}
+
+
+
+We leave some space, so the full size figure would not fit anymore:
+
+{\centering\fitbox{\includegraphics{vitruvian}}\par}
+
+The figure is now on the next page.  Let us leave some space under the
+next figure:
+
+{\centering\fitbox[minheight=0.5\fitboxnatheight,
+  minwidth=0.5\fitboxnatwidth, 
+  belowboxspace=\baselineskip]{\includegraphics{vitruvian}}\par}
+We left some space for a caption.
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/fitbox/vitruvian.jpg b/Master/texmf-dist/doc/latex/fitbox/vitruvian.jpg
new file mode 100644
index 00000000000..406573b7d0e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fitbox/vitruvian.jpg