3 files changed, 58 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/latex/phonrule/README b/Master/texmf-dist/doc/latex/phonrule/README
index 5dc36c9d5dd..5dcc5af6467 100644
--- a/Master/texmf-dist/doc/latex/phonrule/README
+++ b/Master/texmf-dist/doc/latex/phonrule/README
@@ -1,4 +1,4 @@
-PhonRule.sty
+PhonRule.sty v1.0.0
 
 (c) Stefano Coretta
 
diff --git a/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.pdf b/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.pdf
index 724b68f9aa6..aad7c096072 100644
--- a/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.pdf
+++ b/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.tex b/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.tex
index 6555a192e23..cf1e3aada51 100644
--- a/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.tex
+++ b/Master/texmf-dist/doc/latex/phonrule/phonrule-doc.tex
@@ -8,10 +8,7 @@
 \usepackage{phonrule}
 \usepackage{gb4e}
 
-\usepackage{natbib}
-	\setcitestyle{aysep={},notesep={:}}
-
-\title{The \texttt{phonrule} package}
+\title{The \texttt{phonrule} package (v1.0.0)}
 \author{Stefano Coretta \\ \texttt{stefano.coretta@me.com}}
 
 \reversemarginpar
@@ -20,7 +17,7 @@
 \maketitle
 
 \section{Purpose}
-This packages provides macros for typesetting phonological rules like those in Sound Pattern of English \citep{chomsky1968sound}.
+This packages provides macros for typesetting phonological rules like those in \textit{Sound Pattern of English} (Chomsky, Noam \& Morris Halle. 1968. \textit{The sound pattern of English}. New York, Evanston, and London: Harper \& Row).
 
 \section{Usage}
 \begin{quote}
@@ -55,8 +52,8 @@ The commands \verb+\phonl+, \verb+\phonr+ and \verb+\phonb+ add a place holder l
 \begin{exe}
 \ex
 	\begin{xlist}
-	\ex \verb+\phonl{k}{t}{t}+
-	\ex \phonl{z}{r}{}
+	\ex \verb+\phonl{k}{c}{i}+
+	\ex \phonl{k}{tʃ}{i}
 	\end{xlist}
 \ex
 	\begin{xlist}
@@ -70,54 +67,86 @@ The commands \verb+\phonl+, \verb+\phonr+ and \verb+\phonb+ add a place holder l
 	\end{xlist}
 \end{exe}
 
-The \verb+\oneof+ environment provides the possibility to compile several context, one per line, enclosed in curly brackets. You need to use a \verb+\mbox+.
+The \verb+\oneof+ command provides the possibility to compile several contexts, one per line, embraced by the left curly bracket. You need to use a \verb+\mbox+.
 
 \begin{exe}
 \ex
 \begin{verbatim}
 \phonc{t}{ts}{
-\begin{oneof}
-\placehold \mbox{i} \\
-\placehold \mbox{u}
-\end{oneof}
+\oneof{
+\phold \mbox{i} \\
+\phold \mbox{u}}
 }
 \end{verbatim}
 \ex \phonc{t}{ts}{
-\begin{oneof}
-\placehold \mbox{i} \\
-\placehold \mbox{u}
-\end{oneof}
-}
+\oneof{
+\phold \mbox{i} \\
+\phold \mbox{u}}}
 \end{exe}
 
-\verb+\placehold+ typeset a place holder line with spaces before and after. The \verb+\phonfeat+ environment allows you to insert feature specifications:
+The \verb+\phonfeat+ command allows you to insert feature specifications:
 
 \begin{exe}
 \ex
 \begin{verbatim}
 \phonc{t}{ts}{\phold 
-\begin{phonfeat}
+\phonfeat{
 \mbox{–consonantal} \\
 \mbox{+high} \\
-\mbox{+front}
-\end{phonfeat}
+\mbox{+front}}
 }
 \end{verbatim}
 \ex \phonc{t}{ts}{\phold 
-\begin{phonfeat}
+\phonfeat{
 \mbox{– consonantal} \\
 \mbox{+high} \\
-\mbox{+front}
-\end{phonfeat}
-}
+\mbox{+front}}}
 \end{exe}
 
-\verb+\phold+ typeset a place holder line without spaces. The environments \verb+\oneofnest+ and \verb+\phonfeatnest+ allows one-of environments (inside curly brackets) and feature specifications (inside square brackets) to be nested inside a \verb+\oneof+ environment.
+\verb+\phold+ typesets a place holder line. You can nest \verb|oneof| and \verb|phonfeat| commands for complex rules.
 
+\begin{exe}
+\ex
+\begin{verbatim}
+\phonc{x}{y}{\oneof{
+	\phold \mbox{z} \\
+	\phonfeat{
+	+\mbox{feature x} \\
+	-\mbox{feature y}} \phold}}
+\end{verbatim}
+\ex \phonc{x}{y}{\oneof{
+	\ \phold \mbox{z} \\ \\
+	\phonfeat{
+	\mbox{+feature x} \\
+	\mbox{-feature y}} \phold}}
+\end{exe}
 
+You can use \verb|\env|, \verb|\envl|, \verb|\envr|, \verb|\envb| for rules with more than one output: these command typeset only the different outputs with their respective environments.
 
+\begin{exe}
+\ex
+\begin{verbatim}
+\phon{x}{\oneof{
+	\envr{w}{\mbox{z}} \\
+	\envl{v}{\phonfeat{
+	+\mbox{feature x} \\
+	-\mbox{feature y}}}}}
+\end{verbatim}
+\ex \phon{x}{\oneof{
+	\envr{\mbox{w}}{\mbox{z}} \\
+	\envl{\mbox{v}}{\phonfeat{
+	+\mbox{feature x} \\
+	-\mbox{feature y}}}}}
+\end{exe}
 
-\bibliography{linguistics}
-\bibliographystyle{unified}
+\section{Changelog}
+\subsection{v1.0.0}
+\begin{itemize}
+\item new definition of commands with \verb|\ensuremath|
+\item change of environments to commands
+\item definition of new commands \verb|\env| for personalized outputs
+\item updated place holder to 1.5ex length, -1.5pt vertical position
+\item updated curly brackets to only left in \verb|\oneof| command
+\end{itemize}
 
 \end{document}
 \ No newline at end of file