halloweenmath (6jan17)

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

7 files changed, 720 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/halloweenmath/00readme.txt b/Master/texmf-dist/doc/latex/halloweenmath/00readme.txt
new file mode 100644
index 00000000000..bbc4103480e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/halloweenmath/00readme.txt
@@ -0,0 +1,252 @@
+
+This is file `00readme.txt'.
+(Start your first tour of the halloweenmath package by reading this file.)
+
+This file is part of a work named "halloweenmath package".
+
+Copyright (C) 2017 by Gustavo MEZZETTI.
+
+The halloweenmath 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 2005/12/01 or later.
+
+The halloweenmath package has the LPPL maintenance status
+  "author-maintained".
+
+The file `manifest.txt' that comes along with this file specifies
+what the halloweenmath package consists of; more precisely, it explains
+how the locutions "Work" and "Compiled Work", used in the LaTeX Project
+Public License, are to be interpreted in the case of this work.
+
+This file, after giving a brief description of the halloweenmath
+package, explains how to install it and how to generate its--alas, still
+incomplete!--documentation.
+
+January 6, 2017 (vers. 0.01)
+
+
+
+CONTENTS
+========
+
+- A dozen lines description of the software
+- Installation in a snapshot
+- Checking the contents of the distribution
+- How to install the halloweenmath package
+- How to generate the documentation
+- The makefile
+
+
+
+A DOZEN LINES DESCRIPTION OF THE SOFTWARE
+=========================================
+
+The halloweenmath package originated from a question asked for enjoyment
+on TeX-LaTeX Stack Exchange <http://tex.stackexchange.com> by the user
+cfr (see <http://tex.stackexchange.com/q/336768/69818>); it defines a
+handful of commands for typesetting mathematical symbols of various
+kinds, ranging from "large" operators to extensible arrow-like relations
+and growing arrow-like math accents, that all draw from the classic
+Halloween-related iconography (pumpkins, witches, ghosts, cats, and so
+on) while being, at the same time, seamlessly integrated within the rest
+of the mathematics produced by (AmS-)LaTeX.
+
+
+
+INSTALLATION IN A SNAPSHOT
+==========================
+
+The halloweenmath package is distributed in the usual .dtx + .ins
+format.  The main file is `halloweenmath.dtx', with installation script
+`halloweenmath.ins'.  Do the usual things to install it and to generate
+the documentation.  If you don't know what the usual things are, read
+below.  Note that in order to generate the documentation you should do
+the following:
+
+latex; latex; makeindex (.idx); makeindex (.glo); latex; latex.
+
+
+
+CHECKING THE CONTENTS OF THE DISTRIBUTION
+=========================================
+
+Before installing the halloweenmath package and generating its
+documentation, it is a good idea to read the file `manifest.txt', which
+lists all the files that make up the distribution, to check that you
+don't lack any of them (in particular, that you have the file
+`manifest.txt' itself!).  If you do find that some files are missing,
+don't hesitate to complain to the distributor from whom you obtained the
+others: this person, company, or institution is infringing the copyright
+(actually, the copyleft) of the halloweenmath package.  Please remember,
+however, that in order to comply with the copyright a distributor is
+only requested to supply the files listed in `manifest.txt' under the
+title "MEANING OF THE TERM `Work'", but not those listed under "MEANING
+OF THE TERM `Compiled Work'".
+
+
+
+HOW TO INSTALL THE HALLOWEENMATH PACKAGE
+========================================
+
+Note that in many pre-packaged TeX distributions, like MikTeX and TeX
+Live, the halloweenmath package could be already installed, in which
+case you can use it straight away.
+
+If you need to install the halloweenmath package yourself, follow these
+steps (but also see the section titled "The makefile", below):
+
+1) Make sure that the files `halloweenmath.dtx' and `halloweenmath.ins'
+are placed in the same directory; below, we shall indicate this
+directory as "the current directory".
+
+2) Run LaTeX (or plain TeX) once on the file `halloweenmath.ins'.  This
+will generate, in the current directory, the following LaTeX input file:
+
+    halloweenmath.sty
+
+3) Move the file listed in 2) from the current directory to a LaTeX
+input directory--see b) and c) below.
+
+4) If you wish, delete the file `halloweenmath.log' to save disk space.
+
+Installation is now finished!  The following comments may be useful:
+
+a) The above listing of the files you need to move is also displayed on
+the terminal at the end of the run of the file `halloweenmath.ins'.
+
+b) The documentation of your TeX installation should tell you how to
+find the LaTeX input directory/ies, and probably also how to create new
+LaTeX input directories reserved to hold your private classes and
+packages.
+
+c) If you are not able to find the LaTeX input directories, or you are
+not allowed to modify them and cannot create your personal LaTeX input
+directories, do this: place all the files listed under 2) above in any
+directory of your choice (a newly created, empty directory would be the
+best choice, however); then put all the LaTeX source files that you want
+to typeset using the halloweenmath package in that same directory.  Of
+course, this solution becomes impractical if the number of such source
+files exceeds a dozen or so; but for a few files you can do this way, at
+least until you decide to finally learn how to create your private LaTeX
+input directories!  :-)
+
+d) You may also choose to install the halloweenmath package inside the
+main texmf tree of your TeX installation (as opposed to installing it
+inside a directory devoted to private classes and packages).  In this
+case, note that the _proposed_ TDS-compliant location for the
+halloweenmath package, that is, the directory inside which you should
+put all the files listed in 2), is
+
+    $TEXMF/tex/latex/halloweenmath/
+    
+The documentation, on the other hand, should be stored inside
+
+    $TEXMF/doc/latex/halloweenmath/
+
+Of course, in order to do so you must have appropriate access
+priviledges to the texmf tree of your site.
+
+
+
+HOW TO GENERATE THE DOCUMENTATION
+=================================
+
+A shortened form of the documentation, already typeset and packaged in
+PDF, is provided in the file `halloweenmath-doc.pdf' that you might have
+found on some sites (e.g., the CTAN sites).  This file, however, is not
+part of the halloweenmath package and distributors are not requested to
+include it among the distributed files.  Moreover, it does not contain
+any implementation notes (in which most users, though, are not at all
+interested).
+
+If the distributor from whom you obtained the halloweenmath package did
+not provide the file `halloweenmath-doc.pdf', or if you want the full
+documentation, complete with all the available implementation notes
+(but, alas, still unfinished for many respects), you can generate it
+following these steps (but also see the section titled "The makefile",
+below):
+
+1) Run LaTeX (_not_ plain TeX) _twice_ on the file `halloweenmath.dtx'.
+This, among other things, will generate the files `halloweenmath.idx'
+and `halloweenmath.glo' in the same directory as the file
+`halloweenmath.dtx'.
+
+2) Run MakeIndex on the file `halloweenmath.idx' obtained in 1), using
+the style file `gind.ist', which is part of the standard LaTeX
+distribution.
+
+3) Run MakeIndex on the file `halloweenmath.glo' obtained in 1), using
+the style file `gglo.ist', which is part of the standard LaTeX
+distribution, and specifying the file `halloweenmath.gls' as the output
+file.
+
+4) Run LaTeX _two_ more times on the file `halloweenmath.dtx'.
+
+5) If you wish, you can now delete the following files, to save disk
+space:
+
+    halloweenmath.aux
+    halloweenmath.glg
+    halloweenmath.glo
+    halloweenmath.gls
+    halloweenmath.hd
+    halloweenmath.idx
+    halloweenmath.ilg
+    halloweenmath.ind
+    halloweenmath.lof
+    halloweenmath.log
+    halloweenmath.out
+    halloweenmath.toc
+
+After step 4), you should get the documentation in DVI format in the
+file `halloweenmath.dvi', located in the same directory as
+`halloweenmath.dtx', with all indexes, table of contents, etc.
+correctly set.
+
+However, if you are neurotic (as I am) and have a fast computer, you
+could run LaTeX three or four times, instead of two, in step 1)...  :-)
+
+Other LaTeX typesetting engines should work in the same way, perhaps
+producing the output in a different format; for example, you may use
+pdflatex in place of LaTeX to obtain the documentation in PDF.
+
+
+
+THE MAKEFILE
+============
+
+A (quite trivial!)  makefile that "knows" how to produce the
+documentation is offered along with the halloweenmath package.  Although
+it is not a required part of the distribution (as per LPPL), you may
+find that some distributors supply it all the same (I hope the CTAN
+sites will do so).  With this makefile in the same directory as
+`halloweenmath.dtx', the shell command
+
+    make doc
+
+will take all the necessary actions to produce the full documentation
+(in PDF; the modifications you need to introduce into the makefile in
+order to obtain DVI output should be quite obvious, however).
+
+The same makefile can also be used to extract the "executable" package
+file: simply issue the command
+
+    make code
+
+at the shell prompt; whereas
+
+    make
+
+will _both_ extract the code _and_ typeset the documentation.  Type
+
+    make help
+
+for more information.
+
+
+Have fun with the halloweenmath package!
+
diff --git a/Master/texmf-dist/doc/latex/halloweenmath/Makefile b/Master/texmf-dist/doc/latex/halloweenmath/Makefile
new file mode 100644
index 00000000000..8292e7c8602
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/halloweenmath/Makefile
@@ -0,0 +1,132 @@
+# makefile
+#
+# 2017 Jan 06
+#
+# Macro definitions
+ROOT_NAME	= halloweenmath
+DTX_NAME	= $(ROOT_NAME).dtx
+INS_NAME	= $(ROOT_NAME).ins
+DOC_AUX_FIL	= $(ROOT_NAME).aux $(ROOT_NAME).log \
+				$(ROOT_NAME).glo $(ROOT_NAME).gls \
+				$(ROOT_NAME).idx $(ROOT_NAME).ind \
+				$(ROOT_NAME).ilg $(ROOT_NAME).glg \
+				$(ROOT_NAME).toc $(ROOT_NAME).lof \
+				$(ROOT_NAME).hd  $(ROOT_NAME).out
+DOCUM_FILE	= $(ROOT_NAME).pdf
+CODE_FILES	= $(ROOT_NAME).sty
+#
+LATEX		= pdflatex
+MAKEINDEX	= makeindex
+
+#
+define GEN_FAKE_INDEX
+	@echo '\\begin{theindex}' > $(ROOT_NAME).ind
+	@echo '\\end{theindex}'  >> $(ROOT_NAME).ind
+	@echo "Generating fake .ind file."
+endef
+#
+define GEN_FAKE_GLOSSARY
+	@echo '\\begin{theglossary}' > $(ROOT_NAME).gls
+	@echo '\\end{theglossary}'  >> $(ROOT_NAME).gls
+	@echo "Generating fake .gls file."
+endef
+
+
+
+.PHONY: default
+.PHONY: code doc
+.PHONY: clean cleandoc cleanaux cleancode cleanall
+.PHONY: help
+
+# Default target
+default: doc code
+
+# Generating the code
+################################################################
+#                                                              #
+#   PLEASE NOTE THAT THE INSTALLER SCRIPT IS EXECUTED WITH     #
+#       openout_any=r                                          #
+#                                                              #
+################################################################
+code:
+	openout_any=r tex $(INS_NAME)
+
+# Generating the documentation
+doc: $(DOCUM_FILE)
+
+$(DOCUM_FILE): $(DTX_NAME)
+# Hack for getting index and glossary in the toc since first run:
+	$(GEN_FAKE_INDEX)
+	$(GEN_FAKE_GLOSSARY)
+# We know how many runs are needed:
+	$(LATEX) $(DTX_NAME)
+	$(LATEX) $(DTX_NAME)
+	$(MAKEINDEX) -s gind.ist -t $(ROOT_NAME).ilg -o $(ROOT_NAME).ind \
+			$(ROOT_NAME).idx
+	$(MAKEINDEX) -s gglo.ist -t $(ROOT_NAME).glg -o $(ROOT_NAME).gls \
+			$(ROOT_NAME).glo
+	$(LATEX) $(DTX_NAME)
+	$(LATEX) $(DTX_NAME)
+# Hyperlinks in the indexes seem not to work properly without the
+# following additional run:
+	$(MAKEINDEX) -s gind.ist -t $(ROOT_NAME).ilg -o $(ROOT_NAME).ind \
+			$(ROOT_NAME).idx
+	$(MAKEINDEX) -s gglo.ist -t $(ROOT_NAME).glg -o $(ROOT_NAME).gls \
+			$(ROOT_NAME).glo
+	$(LATEX) $(DTX_NAME)
+
+# Cleaning up: command "make clean" defaults to "make cleanall"
+clean: cleanall
+
+# Cleaning the code files
+cleancode:
+	-rm $(CODE_FILES)
+
+# Cleaning the documentation files
+cleandoc: cleanaux
+	-rm $(DOCUM_FILE)
+
+# Cleanng just the auxiliary files used in producing the documentation
+cleanaux:
+	-rm $(DOC_AUX_FIL)
+
+# Cleaning up all the generated files
+cleanall: cleancode cleandoc
+
+# Giving help
+help:
+	@echo "Here is a list of the available commands:"
+	@echo
+	@echo "  make"
+	@echo "    Generate both the code and the documentation (see below)."
+	@echo
+	@echo "  make code"
+	@echo "    Generate the LaTeX sources for all the classes, packages,"
+	@echo "    definition files, etc. of the C.D.P. Bundle; these files go"
+	@echo "    into the LaTeX input directories."
+	@echo
+	@echo "  make doc"
+	@echo "    Generate the documentation (in PDF); the resulting PDF file"
+	@echo "    goes into the LaTeX documentation directories (the auxiliary"
+	@echo "    files may be discarded)."
+	@echo
+	@echo "  make clean"
+	@echo "  make cleanall"
+	@echo "    These two commands are synonyms; they remove all of the"
+	@echo "    generated files (both code and documentation)."
+	@echo
+	@echo "  make cleancode"
+	@echo "    Remove the LaTeX source files (the \"code files\")."
+	@echo
+	@echo "  make cleandoc"
+	@echo "    Remove the documentation, together with all the auxiliary"
+	@echo "    files used to generate it."
+	@echo
+	@echo "  make cleanaux"
+	@echo "    Remove only the auxiliary files used to generate the"
+	@echo "    documentation."
+	@echo
+	@echo "  make help"
+	@echo "    Print this help message."
+	@echo
+
diff --git a/Master/texmf-dist/doc/latex/halloweenmath/README b/Master/texmf-dist/doc/latex/halloweenmath/README
new file mode 100644
index 00000000000..26277efd6a5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/halloweenmath/README
@@ -0,0 +1,30 @@
+(Version indicator: 2017 Jan 06)
+
+The halloweenmath package originated from a question asked for enjoyment
+on TeX-LaTeX Stack Exchange <http://tex.stackexchange.com> by the user
+cfr (see <http://tex.stackexchange.com/q/336768/69818>); it defines a
+handful of commands for typesetting mathematical symbols of various
+kinds, ranging from "large" operators to extensible arrow-like relations
+and growing arrow-like math accents, that all draw from the classic
+Halloween-related iconography (pumpkins, witches, ghosts, cats, and so
+on) while being, at the same time, seamlessly integrated within the rest
+of the mathematics produced by (AmS-)LaTeX.
+
+The halloweenmath 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.
+
+For more information, read the following files:
+
+00readme.txt            --  start by reading this file
+halloweenmath-doc.pdf   --  overview of the halloweenmath package (PDF)
+halloweenexample.pdf    --  output produced by sample source file (PDF)
+
+Other files that make up the distribution are:
+
+manifest.txt        --  legal stuff
+halloweenmath.dtx   --  main source file
+halloweenmath.ins   --  installation script
+
+See the file `manifest.txt' for a more precise specification of what
+files constitutes a LPPL-compliant distribution.
diff --git a/Master/texmf-dist/doc/latex/halloweenmath/halloweenexample.pdf b/Master/texmf-dist/doc/latex/halloweenmath/halloweenexample.pdf
new file mode 100644
index 00000000000..91e55fad8b4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/halloweenmath/halloweenexample.pdf
diff --git a/Master/texmf-dist/doc/latex/halloweenmath/halloweenexample.tex b/Master/texmf-dist/doc/latex/halloweenmath/halloweenexample.tex
new file mode 100644
index 00000000000..d6e30050822
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/halloweenmath/halloweenexample.tex
@@ -0,0 +1,206 @@
+\documentclass[12pt,a4paper]{article}
+\usepackage[T1]{fontenc} % not necessary, but recommended
+\usepackage{halloweenmath}
+\usepackage{hyperref} % just for "\hypersetup"
+
+\title{Sample Halloween Math}
+\author{A.~U.~Thor}
+\date{January~6, 2017}
+
+\hypersetup{
+  pdftitle        = {Sample Halloween Math},
+  pdfauthor       = {A. U. Thor},
+  pdfsubject      = {Sample source file for the halloweenmath package},
+  pdfkeywords     = {Halloween, math, scary mathematical symbols},
+  pdfcreationdate = {D:20170106000000},
+  pdfmoddate      = {D:20170106000000}
+}
+
+
+
+\begin{document}
+
+\maketitle
+
+A reduction my students are likely to make:
+\[\mathwitch \frac{\sin x}{s} = x\,\mathrm{in}\]
+The same reduction as an in-line formula:
+\(\mathwitch \frac{\sin x}{s} = x\,\mathrm{in}\).
+
+Now with limits:
+\[
+    \mathwitch_{i=1}^{n} \frac
+        {\text{$i$-th magic term}}
+        {\text{$2^{i}$-th wizardry}}
+\]
+And repeated in-line: \( \mathwitch_{i=1}^{n} x_{i}y_{i} \).
+    
+The \texttt{bold} math version is honored:\mathversion{bold}
+\[
+    \mathwitch*
+        \genfrac{<}{>}{0pt}{}
+            {\textbf{something terribly}}{\textbf{complicated}}
+    = 0
+\]
+Compare it with \texttt{normal} math\mathversion{normal}:
+\[
+    \mathwitch*
+        \genfrac{<}{>}{0pt}{}
+            {\text{something terribly}}{\text{complicated}}
+    = 0
+\]
+In-line math comparison:
+{\boldmath $\mathwitch* f(x)$} versus $\mathwitch* f(x)$.
+
+There is also a left-facing witch:
+\[\reversemathwitch \frac{\sin x}{s} = x\,\mathrm{in}\]
+And here is the in-line version:
+\(\reversemathwitch \frac{\sin x}{s} = x\,\mathrm{in}\).
+
+Test for \verb|\dots|:
+\[
+    \mathwitch_{i_{1}=1}^{n_{1}} \dots \mathwitch_{i_{p}=1}^{n_{p}}
+    \frac
+        {\text{$i_{1}$-th magic factor}}
+        {\text{$2^{i_{1}}$-th wizardry}}
+    \pumpkin\dots\pumpkin
+    \frac
+        {\text{$i_{p}$-th magic factor}}
+        {\text{$2^{i_{p}}$-th wizardry}}
+\]
+And repeated in-line: \( \mathwitch\dots\mathwitch_{i=1}^{n} x_{i}y_{i} \).
+
+\bigbreak
+
+Now the pumpkins.  First the \texttt{bold} math version:\mathversion{bold}:
+\[ \bigoplus_{h=1}^{m}\bigpumpkin_{k=1}^{n} P_{h,k} \]
+Then the \texttt{normal} one\mathversion{normal}:
+\[ \bigoplus_{h=1}^{m}\bigpumpkin_{k=1}^{n} P_{h,k} \]
+In-line math comparison:
+{\boldmath \( \bigpumpkin_{i=1}^{n} P_{i} \neq \bigoplus_{i=1}^{n} P_{i} \)}
+versus \( \bigpumpkin_{i=1}^{n} P_{i} \neq \bigoplus_{i=1}^{n} P_{i} \).
+
+Close test: {\boldmath $\bigoplus$}$\bigoplus$.
+And against the pumpkins:
+{\boldmath $\bigpumpkin$}$\bigpumpkin\bigoplus${\boldmath $\bigoplus$}.
+
+In-line, but with \verb|\limits|:
+\( \bigoplus\limits_{h=1}^{m}\bigpumpkin\limits_{k=1}^{n} P_{h,k} \).
+
+Binary: \( x\pumpkin y \neq x\oplus y \).  And in display:
+\[ a\pumpkin\frac{x\pumpkin y}{x\oplus y}\otimes b \]
+Close test: {\boldmath $\oplus$}$\oplus$.
+And with the pumpkins too:
+{\boldmath $\pumpkin$}$\pumpkin\oplus${\boldmath $\oplus$}.
+
+In general,
+\[ \bigpumpkin_{i=1}^{n} P_{i} = P_{1}\pumpkin\dots\pumpkin P_{n} \]
+
+\begingroup
+
+\bfseries\boldmath
+
+The same in bold:
+\[ \bigpumpkin_{i=1}^{n} P_{i} = P_{1}\pumpkin\dots\pumpkin P_{n} \]
+
+\endgroup
+
+Other styles: \( \frac{x\pumpkin y}{2} \), exponent~$Z^{\pumpkin}$, 
+subscript~$W_{\!x\pumpkin y}$, double script \( 2^{t_{x\pumpkin y}} \).
+
+\bigbreak
+
+Clouds.  A hypothetical identity:
+\( \frac{\sin^{2}x + \cos^{2}x}{\cos^{2}x} = \mathcloud \).
+Now the same identity set in display:
+\[ \frac{\sin^{2}x + \cos^{2}x}{\cos^{2}x} = \mathcloud \]
+Now in smaller size: \( \frac{\sin x+\cos x}{\mathcloud} = 1 \).
+
+Specular clouds, \texttt{bold}\ldots\mathversion{bold}
+\[ \reversemathcloud \longleftrightarrow \mathcloud \]
+\ldots and in \texttt{normal} math.\mathversion{normal}
+\[ \reversemathcloud \longleftrightarrow \mathcloud \]
+In-line math comparison:
+{\boldmath \( \reversemathcloud \leftrightarrow \mathcloud \)}
+versus \( \reversemathcloud \leftrightarrow \mathcloud \).
+Abutting: {\boldmath $\mathcloud$}$\mathcloud$.
+
+\bigbreak
+
+Ghosts: \( \mathleftghost \mathghost \mathrightghost \mathghost \mathleftghost
+\mathghost \mathrightghost \).  Now with letters: \( H \mathghost H \mathghost h
+\mathghost ab \mathghost f \mathghost wxy \mathghost \), and also \(
+2\mathghost^{3} + 5\mathleftghost^{\!2}-3\mathrightghost_{i} =
+12\mathrightghost_{j}^{4} \).  Then, what about~$x^{2\mathghost}$ and \(
+z_{\!\mathrightghost+1} = z_{\!\mathrightghost}^{2} + z_{\mathghost} \)?
+
+In subscripts:
+\begin{align*}
+    F_{\mathghost+2} &= F_{\mathghost+1} + F_{\mathghost} \\
+    F_{\!\mathrightghost+2} &= F_{\!\mathrightghost+1} + F_{\!\mathrightghost}
+\end{align*}
+Another test: \( \mathghost | \mathrightghost | \mathghost | \mathleftghost |
+\mathghost | \mathrightghost | \mathghost | \mathleftghost | \mathghost \).  We
+should also try this: \( \mathrightghost \mathleftghost \mathrightghost
+\mathleftghost \).
+
+Extensible arrows:
+\begin{gather*}
+    A \xrightwitchonbroom[a\star f(t)]{x_{1}+\dots+x_{n}} B
+        \xrightwitchonbroom{x+z} C \xrightwitchonbroom{} D  \\
+    A \xrightwitchonbroom*[a\star f(t)]{x_{1}+\dots+x_{n}} B
+        \xrightwitchonbroom*{x+z} C \xrightwitchonbroom*{} D  \\
+    A \xleftwitchonbroom*[a\star f(t)]{x_{1}+\dots+x_{n}} B
+        \xleftwitchonbroom*{x+z} C \xleftwitchonbroom*{} D  \\
+    A \xleftwitchonbroom[a\star f(t)]{x_{1}+\dots+x_{n}} B
+        \xleftwitchonbroom{x+z} C \xleftwitchonbroom{} D
+\end{gather*}
+And \( \overrightwitchonbroom*{x_{1}+\dots+x_{n}}=0 \) versus \(
+\overrightwitchonbroom{x_{1}+\dots+x_{n}}=0 \); or \(
+\overleftwitchonbroom*{x_{1}+\dots+x_{n}}=0 \) versus \(
+\overleftwitchonbroom{x_{1}+\dots+x_{n}}=0 \).
+
+Hovering ghosts: \( \overrightswishingghost{x_{1}+\dots+x_{n}}=0 \).  You might
+wonder whether there is enough space left for the swishing ghost; let's try
+again: \( \overrightswishingghost{(x_{1}+\dots+x_{n})y}=0 \).  As you can see,
+there is enough room.  Lorem ipsum dolor sit amet consectetur adipisci elit.
+And \( \overrightswishingghost{\mathstrut} \) too.
+\begin{gather*}
+    A \xrightswishingghost[a\star f(t)]{x_{1}+\dots+x_{n}} B
+        \xrightswishingghost{x+z} C \xrightswishingghost{} D  \\
+    A \xleftswishingghost[a\star f(t)]{x_{1}+\dots+x_{n}} B
+        \xleftswishingghost{x+z} C \xleftswishingghost{} D
+\end{gather*}
+Another hovering ghost: \( \overleftswishingghost{x_{1}+\dots+x_{n}}=0 \)..
+Lorem ipsum dolor sit amet consectetur adipisci elit.  Ulla rutrum, vel sivi sit
+anismus oret, rubi sitiunt silvae.  Let's see how it looks like when the ghost
+hovers on a taller formula, as in \(
+\overrightswishingghost{H_{1}\oplus\dots\oplus H_{k}} \).  Mmmh, it's
+suboptimal, to say the least.\footnote{We'd better try \(
+\underleftswishingghost{y_{1}+\dots+y_{n}} \), too; well, this one looks good!}
+
+Under ``arrow-like'' symbols: \( \underleftswishingghost{x_{1}+\dots+x_{n}}=0 \)
+and \( \underrightswishingghost{x+y+z} \).  There are \(
+\underleftwitchonbroom*{x_{1}+\dots+x_{n}}=0 \) and \(
+\underrightwitchonbroom*{x+y+z} \) as well.
+
+\bigbreak
+
+A comparison between the ``standard'' and the ``script-style'' over\slash under
+extensible arrows:
+\begin{align*}
+    \overrightarrow{f_{1}+\dots+f_{n}}
+        &\neq\overscriptrightarrow{f_{1}+\dots+f_{n}}  \\
+    \overleftarrow{f_{1}+\dots+f_{n}}
+        &\neq\overscriptleftarrow{f_{1}+\dots+f_{n}}  \\
+    \overleftrightarrow{f_{1}+\dots+f_{n}}
+        &\neq\overscriptleftrightarrow{f_{1}+\dots+f_{n}}  \\
+    \underrightarrow{f_{1}+\dots+f_{n}}
+        &\neq\underscriptrightarrow{f_{1}+\dots+f_{n}}  \\
+    \underleftarrow{f_{1}+\dots+f_{n}}
+        &\neq\underscriptleftarrow{f_{1}+\dots+f_{n}}  \\
+    \underleftrightarrow{f_{1}+\dots+f_{n}}
+        &\neq\underscriptleftrightarrow{f_{1}+\dots+f_{n}}
+\end{align*}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/halloweenmath/halloweenmath-doc.pdf b/Master/texmf-dist/doc/latex/halloweenmath/halloweenmath-doc.pdf
new file mode 100644
index 00000000000..8bc4d0a6fa3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/halloweenmath/halloweenmath-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/halloweenmath/manifest.txt b/Master/texmf-dist/doc/latex/halloweenmath/manifest.txt
new file mode 100644
index 00000000000..74ae5fc5634
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/halloweenmath/manifest.txt
@@ -0,0 +1,100 @@
+
+This is file `manifest.txt'.
+
+This file is part of a work named "halloweenmath package".
+
+Copyright (C) 2017 by Gustavo MEZZETTI.
+
+The halloweenmath 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 2005/12/01 or later.
+
+The halloweenmath package has the LPPL maintenance status
+  "author-maintained".
+
+This file specifies what the halloweenmath package consists of; more
+precisely, it explains how the locutions "Work" and "Compiled Work",
+used in the LaTeX Project Public License, are to be interpreted in the
+case of this work.
+
+January 6, 2017 (vers. 0.01)
+
+
+
+MEANING OF THE TERM "Work"
+==========================
+
+In the case of the halloweenmath package, the "Work" is the collection
+of the following 4 files:
+
+00readme.txt        --  start by reading this file
+manifest.txt        --  the file you are reading now
+halloweenmath.dtx   --  main source file
+halloweenmath.ins   --  installation script
+
+If you have received the 4 files listed above, you possess an integral
+copy of the halloweenmath package.
+
+
+
+MEANING OF THE TERM "Compiled Work"
+===================================
+
+In the case of the halloweenmath package, a "Compiled Work" is the
+collection of:
+
+a) the following 2 files that are also part of the "Work" (see above):
+
+00readme.txt
+manifest.txt
+
+AND
+b) the following 2 files:
+
+halloweenmath.sty   --  the halloweenmath LaTeX package
+halloweenmath.dvi   --  full documentation in DVI format
+
+You may, at your option, substitute the file `halloweenmath.dvi' with
+either one (or both) of the following two files:
+
+halloweenmath.pdf       --  full documentation in PDF
+halloweenmath-doc.pdf   --  overview of the halloweenmath package (PDF)
+
+but at least one among the files `halloweenmath.dvi',
+`halloweenmath.pdf', and `halloweenmath-doc.pdf' must be included in a
+"Compiled Work" that you intend to distribute.  The file
+`halloweenmath.pdf' is obtained by submitting to the program pdflatex
+the file `halloweenmath.dtx', following the same steps as those
+explained in `00readme.txt' under the title "How to generate the
+documentation".
+
+
+
+ANCILLARY FILES
+===============
+
+The package of files distributed through the Comprehensive TeX Archive 
+Network (CTAN) includes also the following five files:
+
+README                  --  guide to directory contents
+halloweenmath-doc.pdf   --  overview of the halloweenmath package (PDF)
+halloweenexample.tex    --  example LaTeX source for this package
+halloweenexample.pdf    --  typeset version of the preceding item (PDF)
+Makefile                --  Makefile to generate code or documentation
+
+These five files are included only for convenience's sake and are _not_
+a required part of the halloweenmath package (of course you may, if you
+wish, include them in your distribution too).
+
+
+
+COMMENT
+=======
+
+Please remember that, in order to distribute a LPPL-compliant copy of
+the halloweenmath package, it suffices to distribute only the 4 files
+that constitute the "Work".