bestpapers (25oct15)

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

6 files changed, 531 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/Makefile b/Master/texmf-dist/doc/bibtex/bestpapers/Makefile
new file mode 100644
index 00000000000..23f39b480de
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/Makefile
@@ -0,0 +1,35 @@
+PACKAGE = bestpapers
+
+TEX = bestpapers-guide.tex
+
+PDF = ${TEX:%.tex=%.pdf}
+
+all:  ${PDF}
+
+%.pdf:  %.tex bestpapers.bst tex.bib
+	pdflatex $*
+	- bibtex tex
+	- bibtex typography
+	pdflatex $*
+	pdflatex $*
+	while ( grep -q 'may have changed' $*.log) \
+	do pdflatex $<; done
+
+clean:
+	$(RM)  *.log *.aux \
+	*.cfg *.glo *.idx *.toc \
+	*.ilg *.ind *.out *.lof \
+	*.lot *.bbl *.blg *.gls \
+	*.dvi *.ps *.thm *.tgz *.zip
+
+distclean: clean
+	$(RM) $(PDF)
+
+archive: all clean
+	cd ..; \
+	tar -czvf $(PACKAGE)/$(PACKAGE).tgz --exclude '*~' --exclude '*.tgz' --exclude '*.zip'  --exclude CVS $(PACKAGE); \
+	cd $(PACKAGE)
+
+zip: all clean
+	cd ..; $(RM) $(PACKAGE).zip; \
+	zip -r  $(PACKAGE).zip $(PACKAGE)/* -x '*~' -x '*.tgz' -x '*.zip' -x '*CVS*'
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/README b/Master/texmf-dist/doc/bibtex/bestpapers/README
new file mode 100644
index 00000000000..683da6adcc0
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/README
@@ -0,0 +1,16 @@
+		    Bestpapers bibliography style
+			    Boris Veytsman
+			     Version 1.0
+
+Many people preparing their resumes find the requirement ``please list
+five (or six, or ten) papers authored by you''.  The same requirement
+is often stated for reports prepared by professional teams.  The
+creation of such lists may be a cumbersome task. Even more difficult
+is to support the lists over the time, when one adds new papers.  The
+style bestpapers.bst is intended to make this task simpler.  It is
+based on the idea that it is easier to score than to sort: we can
+assign a score to a paper, and then let the computer to select the
+papers with highest scores.
+
+This work was commissioned by Consumer Financial Protection Bureau,
+United States Treasury.  This package is in the public domain
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf
new file mode 100644
index 00000000000..a7d09b42283
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.pdf
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex
new file mode 100644
index 00000000000..d46e690a0fd
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/bestpapers-guide.tex
@@ -0,0 +1,158 @@
+\documentclass{article}
+\usepackage[numbers]{natbib}
+\usepackage{hyperref,alltt}
+\usepackage[resetlabels]{multibib}
+\newcommand{\BibTeX}{\textsc{Bib}\TeX}
+\newcites{tex}{Books and articles about \TeX}
+\newcites{typography}{Books and articles about typography}
+\begin{document}
+
+\title{User Guide for \texttt{bestpapers.bst} Bibliography Style}
+\author{Boris Veytsman\thanks{This work was commissioned by Consumer
+    Financial Protection Bureau, United States Treasury.  This file
+    and the package are in the public domain}}
+\date{October 2014}
+\maketitle
+
+\section{Introduction}
+\label{sec:intro}
+
+
+
+Many people preparing their r\'esum\'es find the requirement ``please
+list five (or six, or ten) papers authored by you''.  The same
+requirement is often stated for reports prepared by professional
+teams.  The creation of such lists may be a cumbersome task. Even more
+difficult is to support the lists over the time, when one adds new
+papers.  The style \texttt{bestpapers.bst} is intended to make this task
+simpler.  It is based on the idea that it is easier to score than to
+sort: we can assign a score to a paper, and then let the computer to
+select the papers with highest scores.
+
+\section{Simple Usage}
+\label{sec:simple}
+
+The use of the package is simple.  We assume that you keep all your
+publications in a \BibTeX\ file (or files).  Then,
+\begin{enumerate}
+\item Add to each bibliographic entry in the file the field
+  \begin{alltt}
+    score = \itshape SCORE
+  \end{alltt}
+  where \texttt{\itshape SCORE} is an non-negative integer.  The
+  higher the score is, the more you think about the paper.  Since only
+  the relation between scores matter, you may limit yourself to scores
+  between, say, $0$ and $100$.  An absent score is equivalent to
+  \texttt{score=0}.
+\item Add to the preamble of your r\'esum\'e
+\begin{verbatim}
+\usepackage[numbers]{natbib}
+\end{verbatim}
+  and to the document itself
+\begin{verbatim}
+\renewcommand{\refname}{My Best Works}
+\nocite{*}
+\bibliography{myworks}
+\bibliographystyle{bestpapers}
+\end{verbatim}
+\item You document will get the list of five~best works, sorted by
+  decreasing scores.
+\end{enumerate}
+
+
+\section{Customization}
+\label{sec:custom}
+
+
+Sometimes you need to change the number of best papers displayed.  
+The package introduces a new entry type \verb|@SETUP| with the
+field \verb|max.best.papers|, for example,
+\begin{verbatim}
+@SETUP{setup,
+  max.best.papers = 6,
+}
+\end{verbatim}
+
+Normally the score of the papers is not printed.  However, for debug
+purposes you can change this: just define the command
+\verb|\PrintScore|, for example
+\begin{verbatim}
+\newcommand{\PrintScore}[1]{Score: #1}
+\end{verbatim}
+
+\section{Bibexport}
+\label{sec:bibexport}
+
+Sometimes you need to extract your best works from \texttt{.bib} files
+rather than typeset the list of them.  You can use for this the
+program \textsl{bibexport} (\url{http://www.ctan.org/pkg/bibexport}), a
+handy tool for the manipulation of \BibTeX\ databases.  The package
+provides the style \texttt{bestpapers-export.bst} intended for this
+task.  
+
+To extract the best works from the files \texttt{myworks.bib} and
+\texttt{ourworks.bib}  into the file \texttt{result.bib},
+\begin{enumerate}
+\item Create the file \texttt{extract.aux} with the following content:
+\begin{verbatim}
+\citation{*}
+\bibdata{myworks,ourworks}
+\bibstyle{bestpapers-export}
+\end{verbatim}
+
+\item If necessary, add to any of these files \texttt{@SETUP} entry as
+  described in Section~\ref{sec:custom}.
+\item Run
+\begin{verbatim}
+bibexport -b bestpapers-export -o result.bib export.aux
+\end{verbatim}
+
+\end{enumerate}
+
+
+\section{Multiple Bibliographies}
+\label{sec:multiple}
+
+
+
+Sometimes you need to have collective report and provide several
+best papers for each person in the group.  The package
+\texttt{multibib} allows you to do this:
+\begin{verbatim}
+\usepackage{multibib}
+\newcites{chico,harpo,groucho,zeppo}{Chico's Papers,%
+                                     Harpo's Papers,%
+                                     Groucho's Papers,%
+                                     Zeppo's Papers}
+...
+\nocitechico{*}
+\bibliographychico{chico.bib}
+\bibliographystylechico{bestpapers}
+
+\nociteharpo{*}
+\bibliographyharpo{harpo.bib}
+\bibliographystyleharpo{bestpapers}
+
+\nocitegroucho{*}
+\bibliographygroucho{groucho.bib}
+\bibliographystylegroucho{bestpapers}
+
+\nocitezeppo{*}
+\bibliographyzeppo{zeppo.bib}
+\bibliographystylezeppo{bestpapers}
+\end{verbatim}
+
+Note that you may want to use \texttt{resetlabels} option of the
+\texttt{multibib} package if you want all the lists to start from~1.
+
+An example of this usage is the source code of this file, which lists
+6~books about \TeX\ and 5~books about typography separately.  
+
+\nocitetex{*}
+\nocitetypography{*}
+\bibliographytex{tex}
+\bibliographystyletex{bestpapers}
+\bibliographytypography{typography}
+\bibliographystyletypography{bestpapers}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/tex.bib b/Master/texmf-dist/doc/bibtex/bestpapers/tex.bib
new file mode 100644
index 00000000000..ab277df5ab7
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/tex.bib
@@ -0,0 +1,108 @@
+@SETUP{setup,
+  score = 0,
+  max.best.papers = 6,
+}
+
+
+@BOOK{Lamport94,
+  author = {Leslie Lamport},
+  year = 1994,
+  title = {{\LaTeX}: a Document Preparation System},
+  edition = {Second},
+  publisher = {Addison-Wesley Publishing Company},
+  address = {Reading, MA},
+  note = {Illustrations by Duane Bibby},
+  score = 10,
+}
+
+@Manual{MI,
+  author = {P. Cheng and M. A. Harrison},
+  title = {Index Preparation and Processing},
+  year =  1988,
+  month = {October},
+  note = {\url{http://mirrors.ctan.org/indexing/makeindex/paper}},
+  score = 5,
+}
+
+
+@Misc{TeXFAQ,
+  author =       {{UK \TeX{} Users Group}},
+  title =	 {{UK} List of {\TeX} Frequently Asked Questions},
+  year =         2008,
+  howpublished = {\url{http://www.tex.ac.uk/cgi-bin/texfaq2html}},
+  score =        4,
+}
+
+
+@manual{lshort,
+  author =        {Tobias Oetiker and Hubert Partl and Irene Hyna and
+                   Elisabeth Schlegl},
+  month =         {April},
+  note =          {\url{http://mirrors.ctan.org/info/lshort}},
+  title =         {The Not So Short Introduction to \LaTeXe{}, Or
+                   \LaTeXe{} in 174 Minutes},
+  year =          {2011},
+  score =         5,
+}
+
+@Book{Mittelbach04:LaTeXCompanion,
+  author =	 {Frank Mittelbach and Michel Goossens and Johannes Braams 
+                  and David Carlisle and Chris Rowley},
+  title = 	 {The \LaTeX{} Companion},
+  publisher = 	 {Addison-Wesley Professional},
+  year = 	 2004,
+  series =	 {Addison-Wesley Series on Tools and Techniques 
+                  for Computer Typesetting},
+  address =	 {Boston},
+  score =        8,
+}
+
+
+@Book{Goossens97:LateXGraphicsCompanion,
+  author =	 {Michel Goossens and Sebastian Rahtz and Frank Mittelbach},
+  title = 	 { The \LaTeX{} Graphics Companion: 
+                   Illustrating Documents With \TeX{} and {PostScript}},
+  chapter = 	 {},
+  publisher = 	 {Addison-Wesley},
+  year = 	 1997,
+  series =	 {Addison-Wesley Series on Tools and Techniques 
+                  for Computer Typesetting},
+  address =	 {Reading, MA},
+  score  =       7,
+}
+
+@Book{Goossens99:LaTeXWebCompanion,
+  author =	 {Michael Goossens and Sebastian Rahtz and
+                 Eitan M. Gurari and Ross Moore and Robert S. Sutor},
+  title = 	 {The \LaTeX{} Web Companion: 
+                  Integrating \TeX{}, {HTML}, and {XML}},
+  publisher = 	 {Addison Wesley Longman},
+  year = 	 1999,
+  series =	 {Addison-Wesley Series on Tools and Techniques 
+                  for Computer Typesetting},
+  address =	 {Reading, MA},
+  score =        7,
+}
+
+@Book{Knuth94:TheTeXbook,
+  author =	 {Knuth, Donald Ervin},
+  title = 	 {The \TeX book},
+  publisher = 	 {Addison-Wesley Publishing Company},
+  year = 	 1994,
+  series =	 {Computers \& Typesetting A},
+  address =	 {Reading, MA},
+  note  =        {Illustrations by Duane Bibby},
+  score =        20
+}
+
+
+@Manual{instr-l,
+  title = 	 {Instructions for Preparation of Papers and
+                  Monographs, {AMS\LaTeX}},
+  organization = {American Mathematical Society},
+  month =	 {August},
+  year =	 2004,
+  note =	 {\url{http://mirrors.ctan.org/macros/latex/required/amslatex/classes/instr-l.pdf}},
+  score =        4,
+}
+
diff --git a/Master/texmf-dist/doc/bibtex/bestpapers/typography.bib b/Master/texmf-dist/doc/bibtex/bestpapers/typography.bib
new file mode 100644
index 00000000000..a96304cfdf8
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bestpapers/typography.bib
@@ -0,0 +1,214 @@
+@Book{Tufte03:PowerPoint,
+  author =	 {Edward R. Tufte},
+  title = 	 {The Cognitive Style of {Power Point}},
+  publisher = 	 {Graphics Press LLC},
+  year = 	 2003,
+  address =	 {Cheshire, CT},
+  score =        10
+}
+
+
+@Book{Gill:Typography,
+  author =	 {Eric Gill},
+  title = 	 {An Essay on Typography.  With a new 
+                  introduction by Cristopher Skelton},
+  publisher = 	 {David R. Godine},
+  year = 	 2007,
+  address =	 {Boston},
+  score =        12
+}
+
+
+@Article{Brumberger03a,
+  author = 	 {Brumberger, Eva R.},
+  title = 	 {The Rhetoric of Typography: The Persona of Typeface and 
+                  Text},
+  journal = 	 {Technical Communication},
+  year = 	 2003,
+  volume = 	 50,
+  number = 	 2,
+  pages = 	 {206--223},
+  score =        12,
+  annote = {Practitioners typically agree that typefaces have
+personas, and they often suggest specific personas for specific
+typefaces, but these guidelines rely on craftlore rather than on
+empirical evidence. Research on typography has focused primarily on
+readability and legibility issues; there have been few studies
+investigating the personas of typefaces. There is a clear gap in the
+research. With the increased flexibility in design that comes with
+more sophisticated desktop publishing technology, with an ongoing
+shift from printed to electronic documents, and with a growing
+emphasis on visual communication, this gap is becoming increasingly
+important to the field of technical communication. The studies
+discussed here provide strong empirical support for the notion that
+readers ascribe personality attributes both to typefaces and to text
+passages. The data provide a foundation for investigation of the
+interactions between typeface and text persona.}  }
+
+
+@Article{Brumberger03b,
+  author = 	 {Brumberger, Eva R.},
+  title = 	 {The Rhetoric of Typography: The Awareness and 
+                  Impact of Typeface Appropriateness},
+  journal = 	 {Technical Communication},
+  year = 	 2003,
+  volume = 	 50,
+  number = 	 2,
+  pages = 	 {224--231},
+  score =        8,
+  annote = {Technical communicators have an emerging body of research
+  in visual rhetoric on which to build our practice, but little of
+  that work has focused on the rhetorical role of typography. The
+  majority of studies focused on typography have examined instead its
+  role in readability and legibility. A handful of studies have
+  investigated typeface persona, exploring the notion that typefaces
+  carry with them a message distinct from that of the verbal text that
+  they represent, and an additional few have investigated the issue of
+  typeface suitability. The studies presented here extend this
+  discussion by investigating whether clashes in typeface and text
+  persona affect readers\u2019 perceptions of the text.}  }
+
+
+
+@Article{Brumberger04,
+  author = 	 {Brumberger, Eva},
+  title = 	 {The Rhetoric of Typography: Effects on Reading 
+                  Time, Reading Comprehension, and Perceptions of 
+                  Ethos},
+  journal = 	 {Technical Communication},
+  year = 	 2004,
+  volume = 	 51,
+  number = 	 1,
+  pages = 	 {13--24},
+  score =        9,
+  annote = 	 {Asserts that typography has not occupied a
+                  significant role in discussions of visual rhetoric.
+                  Extends those discussions by investigating whether
+                  typeface persona shapes readers' interactions with a
+                  document.}
+}
+
+@Book{Bartram04,
+  author =	 {Alan Bartram},
+  title = 	 {Bauhaus, Modernism and the Illustrated Book},
+  publisher = 	 {Yale University Press},
+  year = 	 2004,
+  address =	 {New Haven, CT},
+  score =        14,
+}
+
+@Book{Tschichold91:FormBook,
+  author =	 {Jan Tschichold},
+  editor =	 {Robert Bringhurst},
+  title = 	 {The Form of the Book.  
+                  Essays on the Morality of Good Design},
+  publisher = 	 {Hartley \& Marks},
+  year = 	 1991,
+  address =	 {Point Roberts, Washington},
+  score =        25
+}
+
+
+
+@book{bringhurst2004elements,
+  title={The Elements of Typographic Style},
+  author={Bringhurst, Robert},
+  isbn={9780881792065},
+  lccn={2004053913},
+  year={2004},
+  publisher={Hartley \& Marks, Publishers},
+  address = {Vancouver, BC, Canada},
+  score = 22,
+}
+
+
+@Book{Tschichold98:NewTypography,
+  author =	 {Jan Tschichold},
+  title = 	 {The New Typography},
+  publisher = 	 {University of California Press},
+  year = 	 1998,
+  address =	 {Berkeley and Los Angelos, CA},
+  score =        24,
+}
+
+@Article{Legge11,
+  author = 	 {Gordon E. Legge and Charles A. Bigelow},
+  title = 	 {Does Print Size Matter for Reading? 
+                  {A} Review of Findings
+                  from Vision Science and Typography},
+  journal = 	 {J. Vision},
+  year = 	 2011,
+  volume =	 {11(5)},
+  number =	 8,
+  pages =	 {1--22},
+  score =        23,
+  annote =	 {The size and shape of printed symbols determine the
+legibility of text. In this paper, we focus on print size because of
+its crucial role in understanding reading performance and its
+significance in the history and contemporary practice of
+typography. We present evidence supporting the hypothesis that the
+distribution of print sizes in historical and contemporary
+publications falls within the psychophysically defined range of fluent
+print sizeVthe range over which text can be read at maximum speed. The
+fluent range extends over a factor of 10 in angular print size
+(x-height) from approximately 0.2- to 2-.  Assuming a standard reading
+distance of 40 cm (16 inches), the corresponding physical x-heights
+are 1.4 mm (4 points) and 14 mm (40 points). We provide new data on
+the distributions of print sizes in published books and newspapers and
+in typefounders' specimens, and consider factors influencing these
+distributions. We discuss theoretical concepts from vision science
+concerning visual size coding that help inform our understanding of
+historical and modern typographical practices.  While economic,
+social, technological, and artistic factors influence type design and
+selection, we conclude that properties of human visual processing play
+a dominant role in constraining the distribution of print sizes in
+common use.  } }
+
+@Book{Spiekermann02,
+  author =	 {Erik Spiekermann and E. M. Ginger},
+  title = 	 {Stop Stealing Sheep \& Find Out How Type Works},
+  publisher = 	 {Adobe Press},
+  year = 	 2002,
+  address =	 {Berkeley, CA},
+  edition =	 {Second},
+  score =        16,
+  ISBN =         {978-0201703399}
+}
+
+@InProceedings{Morris02,
+  author = 	 {Morris, R. A. and Aquilante, K. and Yager, D. and 
+                  Bigelow, C.},
+  title = 	 {Serifs Slow {RSVP} Reading At Very Small Sizes But Don't 
+                  Matter At Larger Sizes},
+  booktitle =	 {SID 2002, San Jose, CA: Digest of Technical Papers},
+  pages =	 {244--247},
+  year =	 2002,
+  score =        19,
+  organization = {The Society for Information Display},
+  annote = {Morris, Aquilante, Yager and Bigelow (2002) did find an
+effect of serifs on reading speed, unlike Arditi and Cho. These
+investigators used specially designed versions of the Lucida typeface
+family (Bigelow and Holmes Inc., San Jose, CA), one with serifs and
+one without serifs. Although typical serif and sans-serif fonts differ
+in a variety of attributes, the specially designed Lucida fonts were
+almost identical, apart from the presence or absence of
+serifs. According to Morris et al: "the designers produced a seriffed
+and sans-serif pair whose underlying forms are identical in stem
+weights, character widths, character spacing and fitting, and
+modulation of thick to thin. The only difference is the presence or
+absence of serifs, and the slight increase of black area in the
+seriffed variant." The investigators used the rapid serial visual
+presentation (RSVP) method to measure reading speed for the two font
+variants. For a small print size of 12 min-arc (probably near the
+critical print size, Section 3.2), reading speed was about 20% faster
+for the sans-serif font, but there was no difference in reading speed
+at a larger print size of 48 min-arc} }
+
+@book{Jaspert:TypefacesEncyclopaedia,
+  title={The Encyclop\ae dia of Typefaces},
+  author={Jaspert, W. P. and Berry, W. T. and Johnson, A. F.},
+  year= 2009,
+  publisher={Cassell},
+  edition = {55th Anniversary},
+  address = {London}
+}