summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/theoremref
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/theoremref
Initial commit
Diffstat (limited to 'macros/latex/contrib/theoremref')
-rw-r--r--macros/latex/contrib/theoremref/COPYING340
-rw-r--r--macros/latex/contrib/theoremref/README8
-rw-r--r--macros/latex/contrib/theoremref/theoremref-doc.pdfbin0 -> 351316 bytes
-rw-r--r--macros/latex/contrib/theoremref/theoremref-doc.tex190
-rw-r--r--macros/latex/contrib/theoremref/theoremref.sty230
5 files changed, 768 insertions, 0 deletions
diff --git a/macros/latex/contrib/theoremref/COPYING b/macros/latex/contrib/theoremref/COPYING
new file mode 100644
index 0000000000..623b6258a1
--- /dev/null
+++ b/macros/latex/contrib/theoremref/COPYING
@@ -0,0 +1,340 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users. This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it. (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+ To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have. You must make sure that they, too, receive or can get the
+source code. And you must show them these terms so they know their
+rights.
+
+ We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+ Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software. If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+ Finally, any free program is threatened constantly by software
+patents. We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary. To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ GNU GENERAL PUBLIC LICENSE
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License. The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+ 1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+ 2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) You must cause the modified files to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in
+ whole or in part contains or is derived from the Program or any
+ part thereof, to be licensed as a whole at no charge to all third
+ parties under the terms of this License.
+
+ c) If the modified program normally reads commands interactively
+ when run, you must cause it, when started running for such
+ interactive use in the most ordinary way, to print or display an
+ announcement including an appropriate copyright notice and a
+ notice that there is no warranty (or else, saying that you provide
+ a warranty) and that users may redistribute the program under
+ these conditions, and telling the user how to view a copy of this
+ License. (Exception: if the Program itself is interactive but
+ does not normally print such an announcement, your work based on
+ the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable
+ source code, which must be distributed under the terms of Sections
+ 1 and 2 above on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three
+ years, to give any third party, for a charge no more than your
+ cost of physically performing source distribution, a complete
+ machine-readable copy of the corresponding source code, to be
+ distributed under the terms of Sections 1 and 2 above on a medium
+ customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer
+ to distribute corresponding source code. (This alternative is
+ allowed only for noncommercial distribution and only if you
+ received the program in object code or executable form with such
+ an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it. For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable. However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+ 5. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Program or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+ 6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+ 7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all. For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded. In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+ 9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation. If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+ 10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission. For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this. Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+ NO WARRANTY
+
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) year name of author
+ Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary. Here is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ <signature of Ty Coon>, 1 April 1989
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Library General
+Public License instead of this License.
diff --git a/macros/latex/contrib/theoremref/README b/macros/latex/contrib/theoremref/README
new file mode 100644
index 0000000000..0c08aba597
--- /dev/null
+++ b/macros/latex/contrib/theoremref/README
@@ -0,0 +1,8 @@
+The theoremref package provides variants of the \label and \ref
+commands for theorem-like environments, capable of automatically
+typesetting references including the theorem name (apart from the theorem
+number). This comes handy if you do not feel like manually checking
+and fixing every \ref command in your file whenever you need to change
+a Lemma to a Proposition or Theorem or vice versa.
+
+The package is dually licensed as LPPL or GPL.
diff --git a/macros/latex/contrib/theoremref/theoremref-doc.pdf b/macros/latex/contrib/theoremref/theoremref-doc.pdf
new file mode 100644
index 0000000000..3aa0159bc0
--- /dev/null
+++ b/macros/latex/contrib/theoremref/theoremref-doc.pdf
Binary files differ
diff --git a/macros/latex/contrib/theoremref/theoremref-doc.tex b/macros/latex/contrib/theoremref/theoremref-doc.tex
new file mode 100644
index 0000000000..e460266827
--- /dev/null
+++ b/macros/latex/contrib/theoremref/theoremref-doc.tex
@@ -0,0 +1,190 @@
+\documentclass[pagesize=auto]{scrartcl}
+
+% Many thanks to whoever generated this documentation file. --E.J.
+
+\usepackage{fixltx2e}
+\usepackage{etex}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage[utf8]{inputenc}
+\usepackage{microtype}
+\usepackage{hyperref}
+
+\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}
+\newcommand*{\pkg}[1]{\textsf{#1}}
+\newcommand*{\cs}[1]{\texttt{\textbackslash#1}}
+\makeatletter
+\newcommand*{\cmd}[1]{\cs{\expandafter\@gobble\string#1}}
+\makeatother
+\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle}
+\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}}
+
+\addtokomafont{title}{\rmfamily}
+
+\title{The \pkg{theoremref} package}
+\author{Emil Jeřábek\thanks{\mail{jerabek@math.spam.cz} (replace \texttt{spam} with \texttt{cas})}}
+\date{2013/05/22}
+
+
+\begin{document}
+
+\maketitle
+
+
+\section{Introduction}
+
+So, you are writting up your math paper or thesis. There is the
+all-important Lemma~3.14 referenced from a dozen places throughout
+the paper, but you have just realized that its proof requires another
+lemma which should go before Lemma~3.14, hence all the references to
+Lemma~3.14 have to shift to Lemma~3.15. Now that's quite simple to do:
+you just insert the new lemma, and \LaTeX\ relabels the references for you
+behind the scenes. Good.
+
+Then you decide that Lemma~3.15 is, in fact, so important that you
+better call it a Theorem rather than just a Lemma, hence all the
+references to Lemma~3.15 should change to Theorem 3.15. Now that's
+quite simple to do: you just replace the name of the theorem
+environment of~3.15, and \LaTeX\ relabels the references for you behind
+the scenes\dots\ uhhh, except that it does not, actually. You have to go
+through the paper and manually change every occurrence of
+\verb|Lemma~\ref{main}| to \verb|Theorem~\ref{main}|. Your editor software may
+help with automatic text replacement, but that's no good by itself,
+you unfortunately still have to watch out for cases like
+\verb|Lemmas \ref{baz-quux} and~\ref{main}|. Needless to say, the whole business
+is rather error-prone, and very annoying, especially if you later
+decide that 3.15 is, after all, a Lemma, with the prospect of changing
+all those references back again.
+
+The \pkg{theoremref} package is designed to fill this gap in the \LaTeX\ %
+automatic reference system. It provides variants of the \cmd{\label} and
+\cmd{\ref} commands which automatically supply the correct theorem
+environment name into a reference, thus avoiding all the hassle
+described above.
+
+
+\section{Basic usage}
+
+\renewcommand*{\labelenumi}{(\theenumi)}
+\begin{enumerate}
+\item Put \verb|\usepackage{theoremref}| anywhere in the document preamble.
+ \pagebreak[2]
+
+\item For each theorem which you intend to use in the new system, declare
+ its label by \cmd{\thlabel}\marg{foobar}. For example,
+%
+\begin{verbatim}
+ \begin{Lem}\thlabel{exact}
+ Every projective formula is exact.
+ \end{Lem}
+\end{verbatim}
+
+\item There are three commands available for producing references to
+ your theorems: \cmd{\ref}\marg{foo} gives the number, as usual;
+ \cmd{\thref}\marg{foo} gives the theorem name followed by number; and
+ \cmd{\thnameref}\marg{foo} gives just the theorem name. Example:
+
+ \begin{tabular}{l@{ $\to$ }l@{}}
+ \verb|\ref{exact}| & \verb|5.7.7| \\
+ \verb|\thref{exact}| & \verb|Lemma~5.7.7| \\
+ \verb|\thnameref{exact}| & \verb|Lemma|
+ \end{tabular}
+
+ The \cmd{\thref} command can handle an arbitrary number of arguments,
+ separated by commas:
+
+ \begin{tabular}{l@{ $\to$ }l@{}}
+ \verb|\thref{exact,zorn,main}| & \verb|Lemmas 5.7.7 and~2.1.5 and Theorem~6.6.4|
+ \end{tabular}
+\end{enumerate}
+
+
+\section{Options}
+
+\begin{itemize}
+\item \verb|\usepackage[lowercase]{theoremref}| will set your theorem
+ references in lowercase, e.\,g., ``lemma 5.7.7''. Note that there is
+ no provision for capitalization at the beginning of a sentence.
+
+\item \sloppy \verb|\usepackage[reftex]{theoremref}| provides an alternative
+ interface to the main commands: you can say \cmd{\th}\cmd{\label}\marg{foo} and
+ \cmd{\th}\cmd{\ref}\marg{foo} instead of \cmd{\thlabel}\marg{foo} and \cmd{\thref}\marg{foo}.
+ The effect is that the labelling and referencing commands are
+ correctly recognized as such by the Emacs reftex package (and,
+ presumably, other similar editing tools).
+\end{itemize}
+
+\fussy
+
+
+\section{Caveats}
+
+\begin{itemize}
+\item The \cmd{\thlabel} command reuses the slot for page number in the \texttt{.aux}
+ file. This should do no harm, as the latter is generally useless, I've
+ never seen anybody refer to a numbered theorem by its page number. But
+ to be on the safe side, here's an explicit warning: if you declare \meta{foo}
+ by \cmd{\thlabel}\marg{foo}, you cannot use \cmd{\pageref}\marg{foo} to get its page
+ number (it will actually give the theorem name). If you absolutely
+ need both, you can declare two labels for the same theorem:
+ \cmd{\label}\marg{foo-page}\cmd{\thlabel}\marg{foo-name}.
+
+\item If \cmd{\thref}\marg{bar} gives you a cryptic result like ``12 3.15''
+ instead of the theorem name, you probably forgot to use \cmd{\thlabel}
+ instead of \cmd{\label} (see the previous point for explanation). Note
+ that after you switch from one to the other, you may need to \TeX\ the
+ file twice in order for the change to propagate to the \texttt{.aux} file and
+ back.
+
+\item The new referencing commands only work for theorem environments
+ declared using the \cmd{\newtheorem} command. You \emph{cannot} use them for
+ e.\,g.\ tables, figures, equations, sections, and other environments.
+
+\item The implementation depends on some internals of the theorem
+ typesetting macros. It is compatible with the \pkg{theorem} and
+ \pkg{amsthm} packages, as well as the default theorem system in base
+ \LaTeX. It may fail for other theorem-like packages.
+
+ The package is compatible with \pkg{hyperref}, but not with other
+ packages that change the syntax of \cmd{\newlabel} commands written
+ to the \texttt{.aux} file.
+\end{itemize}
+
+\section{History}
+
+\begin{itemize}
+\item 2008-05-13: Initial public release.
+\item 2013-05-22: Added support for hyperref.
+\end{itemize}
+
+\section{License}
+
+The \pkg{theoremref} package is dually licensed under GPL or LPPL at your
+option:
+
+Copyright © 2008, 2013 Emil Jeřábek
+
+This package may be distributed and/or modified under the
+conditions of the \LaTeX\ Project Public License, either version 1.3
+of this license or (at your option) any later version.
+The latest version of this license is in
+\url{http://www.latex-project.org/lppl.txt}
+and version~1.3 or later is part of all distributions of \LaTeX\ %
+version~2003/12/01 or later.
+
+This package is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version~2 of the License, or
+(at your option) any later version.
+
+This package is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+\end{document}
diff --git a/macros/latex/contrib/theoremref/theoremref.sty b/macros/latex/contrib/theoremref/theoremref.sty
new file mode 100644
index 0000000000..c7d56e3f6a
--- /dev/null
+++ b/macros/latex/contrib/theoremref/theoremref.sty
@@ -0,0 +1,230 @@
+% see the bottom of the file for a description and usage notes
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{theoremref}
+ [2013/05/22 References with automatic theorem names]
+
+\def\thmref@lc#1{#1}
+\DeclareOption{lowercase}{\let\thmref@lc\lowercase}
+\DeclareOption{reftex}
+ {\def\thmref@th#1{\csname th\expandafter\@gobble\string#1\endcsname}}
+\ProcessOptions\relax
+
+%hook in \@thm to get the name
+\def\thmref@newthm#1#2{\thmref@lc{\def\thmref@currname{#2}}%
+ \thmref@oldthm{#1}{#2}}
+\def\thmref@amsthm#1#2#3{\thmref@lc{\def\thmref@currname{#3}}%
+ \thmref@oldthm{#1}{#2}{#3}}
+
+%\let\thnameref\pageref fails miserably when the ref is undefined
+\DeclareRobustCommand\thnameref[1]
+ {\expandafter\thmref@setref\csname r@#1\endcsname}
+\def\thmref@setref#1{\ifx#1\relax?THM?\else\expandafter\@secondoftwo#1\fi}
+\def\thmref@sethyp#1{\ifx#1\relax?THM?\else\expandafter\@secondoffive#1\fi}
+
+%hacked version of \label from the kernel
+\DeclareRobustCommand\thlabel[1]{\@bsphack
+ \protected@write\@auxout{}%
+ {\string\newlabel{#1}{{\@currentlabel}{\thmref@currname}}}%
+ \@esphack}
+
+%... or from hyperref/nameref.sty
+\def\thlabel@hyperref#1{%
+ \@bsphack
+ \begingroup
+ \let\label\@gobble
+ \def\ref{\protect\ref}%
+ \edef\@currentlabstr{%
+ \expandafter\strip@prefix\meaning\@currentlabelname
+ }%
+ \protected@write\@auxout{}{%
+ \string\newlabel{#1}{%
+ {\@currentlabel}%
+ {\thmref@currname}% <--
+ {\expandafter\strip@period\@currentlabstr\relax.\relax\@@@}%
+ {\@currentHref}{}%
+ }%
+ }%
+ \endgroup
+ \@esphack
+}
+
+\newif\ifthmref@comma \newif\ifthmref@final \newcount\thmref@num
+\DeclareRobustCommand\thref[1]{\let\thmref@last\empty \let\thmref@stack\empty
+ \let\thmref@head\empty \thmref@commafalse \thmref@finalfalse
+ \thmref@doref#1,,}
+\def\thmref@doref#1,{%
+ \ifx,#1,\ifthmref@comma\ifthmref@final,\fi\space and \fi
+ \thmref@commafalse \expandafter\thmref@flush
+ \else\edef\thmref@this{\thnameref{#1}}%
+ \ifx\thmref@this\thmref@last
+ \let\do\relax \edef\thmref@stack{\thmref@stack\do{\thmref@head}}%
+ \else \thmref@flush \let\thmref@last\thmref@this \fi
+ \def\thmref@head{#1}\expandafter\thmref@doref\fi}
+\def\thmref@flush{%
+ \ifx\thmref@last\empty\else
+ \ifthmref@comma, \thmref@finaltrue\fi \thmref@commatrue
+ \thmref@last \ifx\thmref@stack\empty\else s\fi \thmref@num 0
+ \let\do\thmref@one \thmref@stack
+ \ifcase\thmref@num\or\space and\else\thmref@finaltrue, and\fi
+ ~$\ref{\thmref@head}$\let\thmref@stack\empty\fi}
+\def\thmref@one#1{\ifnum\thmref@num>0,\fi
+ \space$\ref{#1}$\advance\thmref@num 1\relax}
+
+\AtBeginDocument{\thmref@setup}
+\def\thmref@setup{%
+ \let\thmref@oldthm\@thm
+ \@ifpackageloaded{amsthm}{\let\@thm\thmref@amsthm}%
+ {\let\@thm\thmref@newthm}%
+ \@ifpackageloaded{hyperref}{%
+ \expandafter\let\csname thlabel\space\endcsname\thlabel@hyperref
+ \let\thmref@setref\thmref@sethyp
+ }\relax
+ \ifx\thmref@th\@undefined\else\let\th\thmref@th\fi%
+}
+
+\endinput
+
+package: theoremref
+
+author: Emil Je\v{r}\'abek <jerabek@math.spam.cz> (replace spam with cas)
+
+
+INTRODUCTION
+
+So, you are writting up your math paper or thesis. There is the
+all-important Lemma 3.14 referenced from a dozen places throughout
+the paper, but you have just realized that its proof requires another
+lemma which should go before Lemma 3.14, hence all the references to
+Lemma 3.14 have to shift to Lemma 3.15. Now that's quite simple to do:
+you just insert the new lemma, and LaTeX relabels the references for you
+behind the scenes. Good.
+
+Then you decide that Lemma 3.15 is, in fact, so important that you
+better call it a Theorem rather than just a Lemma, hence all the
+references to Lemma 3.15 should change to Theorem 3.15. Now that's
+quite simple to do: you just replace the name of the theorem
+environment of 3.15, and LaTeX relabels the references for you behind
+the scenes... uhhh, except that it does not, actually. You have to go
+through the paper and manually change every occurrence of
+``Lemma~\ref{main}'' to ``Theorem~\ref{main}''. Your editor software may
+help with automatic text replacement, but that's no good by itself,
+you unfortunately still have to watch out for cases like ``Lemmas
+\ref{baz-quux} and~\ref{main}''. Needless to say, the whole business
+is rather error-prone, and very annoying, especially if you later
+decide that 3.15 is, after all, a Lemma, with the prospect of changing
+all those references back again.
+
+The theoremref package is designed to fill this gap in the LaTeX
+automatic reference system. It provides variants of the \label and
+\ref commands which automatically supply the correct theorem
+environment name into a reference, thus avoiding all the hassle
+described above.
+
+
+BASIC USAGE
+
+(1) Put ``\usepackage{theoremref}'' anywhere in the document preamble.
+
+(2) For each theorem which you intend to use in the new system, declare
+ its label by ``\thlabel{foobar}''. For example,
+
+ \begin{Lem}\thlabel{exact}
+ Every projective formula is exact.
+ \end{Lem}
+
+(3) There are three commands available for producing references to
+ your theorems: ``\ref{foo}'' gives the number, as usual;
+ ``\thref{foo}'' gives the theorem name followed by number; and
+ ``\thnameref{foo}'' gives just the theorem name. Example:
+
+ \ref{exact} -> 5.7.7
+ \thref{exact} -> Lemma~5.7.7
+ \thnameref{exact} -> Lemma
+
+ The \thref command can handle an arbitrary number of arguments,
+ separated by commas:
+
+ \thref{exact,zorn,main} -> Lemmas 5.7.7 and~2.1.5 and Theorem~6.6.4
+
+
+OPTIONS
+
+- ``\usepackage[lowercase]{theoremref}'' will set your theorem
+ references in lowercase, e.g., ``lemma 5.7.7''. Note that there is
+ no provision for capitalization at the beginning of a sentence.
+
+- ``\usepackage[reftex]{theoremref}'' provides an alternative
+ interface to the main commands: you can say ``\th\label{foo}'' and
+ ``\th\ref{foo}'' instead of ``\thlabel{foo}'' and ``\thref{foo}''.
+ The effect is that the labelling and referencing commands are
+ correctly recognized as such by the Emacs reftex package (and,
+ presumably, other similar editing tools).
+
+
+CAVEATS
+
+- The \thlabel command reuses the slot for page number in the .aux
+ file. This should do no harm, as the latter is generally useless, I've
+ never seen anybody refer to a numbered theorem by its page number. But
+ to be on the safe side, here's an explicit warning: if you declare foo
+ by ``\thlabel{foo}'', you cannot use ``\pageref{foo}'' to get its page
+ number (it will actually give the theorem name). If you absolutely
+ need both, you can declare two labels for the same theorem:
+ ``\label{foo-page}\thlabel{foo-name}''.
+
+- If ``\thref{bar}'' gives you a cryptic result like ``12 3.15''
+ instead of the theorem name, you probably forgot to use ``\thlabel''
+ instead of ``\label'' (see the previous point for explanation). Note
+ that after you switch from one to the other, you may need to TeX the
+ file twice in order for the change to propagate to the .aux file and
+ back.
+
+- The new referencing commands only work for theorem environments
+ declared using the ``\newtheorem'' command. You *cannot* use them for
+ e.g. tables, figures, equations, sections, and other environments.
+
+- The implementation depends on some internals of the theorem
+ typesetting macros. It is compatible with the ``theorem'' and
+ ``amsthm'' packages, as well as the default theorem system in base
+ LaTeX. It may fail for other theorem-like packages.
+
+ The package is compatible with ``hyperref'', but not with other
+ packages that change the syntax of ``\newlabel'' commands written
+ to the aux file.
+
+
+HISTORY
+
+2008-05-13: Initial public release.
+2013-05-22: Added support for hyperref.
+
+
+LICENSE
+
+The theoremref package is dually licensed under GPL or LPPL at your
+option:
+
+Copyright (C) 2008, 2013 Emil Je\v{r}\'abek
+
+This package may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.3
+of this license or (at your option) any later version.
+The latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+and version 1.3 or later is part of all distributions of LaTeX
+version 2003/12/01 or later.
+
+This package is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This package is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+