summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pst-vowel
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-01-30 00:34:49 +0000
committerKarl Berry <karl@freefriends.org>2012-01-30 00:34:49 +0000
commitfb3894caf2806710304dbf85c1eeb3afda95d0f2 (patch)
tree6267311947b08a6fec90f934312045193f7a1156 /Master/texmf-dist/doc/latex/pst-vowel
parent421e415aa7b668faf5825b5c982e5e1e54d7ba38 (diff)
pst-vowel (28jan12)
git-svn-id: svn://tug.org/texlive/trunk@25228 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/pst-vowel')
-rw-r--r--Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.pdfbin91658 -> 92135 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.tex34
2 files changed, 17 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.pdf b/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.pdf
index ea95cfe79ae..46685dd1f40 100644
--- a/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.pdf
+++ b/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.tex b/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.tex
index c39c58dc360..ab151fb4108 100644
--- a/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.tex
+++ b/Master/texmf-dist/doc/latex/pst-vowel/pst-vowel.tex
@@ -9,26 +9,26 @@
\usepackage{enumitem}
\begin{document}
\newcommand\bs{\textbackslash}
+\newcommand{\pkg}[1]{\texttt{#1}}
\begin{center}
-{\Large\bfseries The pst-vowel package}
+{\Large\bfseries The \pkg{pst-vowel} package}
\vspace{.5in}
\large Alan Munn\\Michigan State University\\\texttt{amunn@msu.edu}
\bigskip
-April 24, 2008
+April 24, 2009
\end{center}
-
\section{Introduction}
-Rei Fukui's vowel.sty package (distributed as part of the TIPA package) provides a simple way of drawing vowel charts. It very nicely places vowels at either cardinal positions or in arbitrarily placed locations on a variety of differently shaped vowel charts.
+Rei Fukui's \pkg{vowel.sty} package (distributed as part of the TIPA package) provides a simple way of drawing vowel charts. It very nicely places vowels at either cardinal positions or in arbitrarily placed locations on a variety of differently shaped vowel charts.
-One thing that the package lacks is a way to show diphthongs on the chart by relating two vowels on the chart with a (labelled) arrow. Such arrows can also be put to good effect to show chain shifts in sociolinguistics. The present package addresses this issue by adding a set of predefined nodes corresponding to the cardinal positions, and allowing the user to specify explicit node labels for non-cardinal vowels. These nodes can then be referenced with pstricks commands to connect them with arrows.
+One thing that the package lacks is a way to show diphthongs on the chart by relating two vowels on the chart with a (labelled) arrow. Such arrows can also be put to good effect to show chain shifts in sociolinguistics. The present package addresses this issue by adding a set of predefined nodes corresponding to the cardinal positions, and allowing the user to specify explicit node labels for non-cardinal vowels. These nodes can then be referenced with PSTricks commands to connect them with arrows.
-This documentation describes only the differences between the original vowel.sty and pst\-vowel.sty. I assume that the reader is familiar with vowel.sty commands; see the documentation for vowel.sty for more details.
+This documentation describes only the differences between the original \pkg{vowel.sty} and \pkg{pst\-vowel.sty}. I assume that the reader is familiar with \pkg{vowel.sty} commands; see the documentation for \pkg{vowel.sty} for more details.
\section{Requirements}
-Since the package depends on pstricks, any documents using it must be compiled with latex+dvips and not with pdflatex. It can, however be used with xelatex using the (default) xdvipdfmx driver. Please note that this package changes certain commands in vowel.sty, and thus vowel charts created using vowel.sty may need to be modified to work correctly with pst-vowel.sty.
+Since the package depends on \pkg{pstricks}, any documents using it must be compiled with latex+dvips and not with pdflatex. It can, however be used with xelatex using the (default) xdvipdfmx driver. Please note that this package changes certain commands in \pkg{vowel.sty}, and thus vowel charts created using \pkg{vowel.sty} may need to be modified to work correctly with \pkg{pst-vowel.sty}.
\section{Cardinal vowels}
For the cardinal vowels, (defined here as any vowel placed with the \texttt{\bs putcvowel} command) the package defines 16 nodes, v1 \ldots v16 which correspond to each of the 16 cardinal positions on the vowel chart. A node is created whenever a vowel is placed at that place on the chart using the \texttt{\bs putcvowel} command. These nodes can then be referred to with \texttt{\bs ncline}, \texttt{\bs ncarc} or \texttt{\bs nccurve} commands to connect them together. Note that the \texttt{\bs putcvowel} command identifies the vowel position simply by a number; reference to the \emph{node} corresponding to that vowel is with the node label v1, v2, etc. Here is an example:
@@ -56,7 +56,7 @@ For the cardinal vowels, (defined here as any vowel placed with the \texttt{\bs
\ncarc{<-}{v8}{v15}
\end{tabular}
-The vowel.sty cardinal vowel commands are unchanged in pst-vowel.sty. Vowels can be placed to the left and right of a dot at the vowel position as usual. In this case, the node is defined at the dot:
+The \pkg{vowel.sty} cardinal vowel commands are unchanged in \pkg{pst-vowel.sty}. Vowels can be placed to the left and right of a dot at the vowel position as usual. In this case, the node is defined at the dot:
\begin{tabular}{m{3.5in}m{1in}}
\begin{Verbatim}[fontsize=\small]
@@ -84,9 +84,9 @@ The vowel.sty cardinal vowel commands are unchanged in pst-vowel.sty. Vowels can
\ncline{->}{v15}{v8}
\end{tabular}
\section{Non-cardinal vowels}\label{sec:arb}
-For vowels placed at non-cardinal positions using the vowel.sty command \texttt{\bs putvowel}, an extra argument must be provided with the label for that node in pst-vowel.sty. Thus, the \texttt{\bs putvowel} command has the following syntax, where \emph{x} and \emph{y} are horizontal and vertical distances (as in vowel.sty) and \emph{node} is the node label.
+For vowels placed at non-cardinal positions using the \pkg{vowel.sty} command \texttt{\bs putvowel}, an extra argument must be provided with the label for that node in \pkg{pst-vowel.sty}. Thus, the \texttt{\bs putvowel} command has the following syntax, where \emph{x} and \emph{y} are horizontal and vertical distances (as in \pkg{vowel.sty}) and \emph{node} is the node label.
\begin{itemize}
-\item[] \texttt{\bs putvowel$[$l|r$]$\{x\}\{y\}\{node\}}
+\item[] \texttt{\bs putvowel$[$l|r$]$\{vowel\}\{x\}\{y\}\{node\}}
\end{itemize}
It is usually prudent to make sure that these node labels are NOT v1 \ldots v16, since this could lead to duplicate node labels if used in conjunction with cardinal vowels. Duplicate labels will not throw an error, but may cause unexpected results. Here is an example:
@@ -112,7 +112,7 @@ It is usually prudent to make sure that these node labels are NOT v1 \ldots v16,
\ncline{->}{v15}{node2}
\end{tabular}
\section{Labelling arrows}
-Arrows can be labelled using the pstricks \texttt{\bs n\{a|b|c\}put} commands. Here is an example:
+Arrows can be labelled using the \pkg{pstricks} \texttt{\bs n\{a|b|c\}put} commands. Here is an example:
\begin{tabular}{m{3.75in}m{1in}}
\begin{Verbatim}[fontsize=\small]
@@ -142,7 +142,7 @@ Arrows can be labelled using the pstricks \texttt{\bs n\{a|b|c\}put} commands. H
\section{Tricks and Pitfalls}
\subsection{Tricks}
\begin{itemize}
-\item Vowels can be enclosed in boxes of various shapes by using pstricks framing commands such as \texttt{\bs psframebox}, \texttt{\bs pscirclebox}, \texttt{\bs pstribox}, and \texttt{\bs psovalbox}, when the vowel is placed. See the pstricks documentation for more possibilities and box parameters.
+\item Vowels can be enclosed in boxes of various shapes by using \pkg{pstricks} framing commands such as \texttt{\bs psframebox}, \texttt{\bs pscirclebox}, \texttt{\bs pstribox}, and \texttt{\bs psovalbox}, when the vowel is placed. See the \pkg{pstricks} documentation for more possibilities and box parameters.
\begin{tabular}{m{3.75in}m{1in}}
\begin{Verbatim}[fontsize=\small]
@@ -191,7 +191,7 @@ Arrows can be labelled using the pstricks \texttt{\bs n\{a|b|c\}put} commands. H
\end{itemize}
\subsection{Pitfalls}
\begin{itemize}[listparindent=\parindent, itemsep=\baselineskip,parsep=0pt]
-\item Labelling lines with pstricks can be frustrating at times, because of the way it determines directions relative to a line. Here is a simple illustration of the problem:
+\item Labelling lines with \pkg{pstricks} can be frustrating at times, because of the way it determines directions relative to a line. Here is a simple illustration of the problem:
\begin{tabular}{m{1.5in}m{1.5in}m{1.5in}}
\begin{Verbatim}[fontsize=\small]
@@ -266,14 +266,14 @@ Of course, when the second node is to the \emph{right} of the first node, as in
\end{itemize}
\section{Limitations}
-There are two limitations to the package: one is that it relies on pstricks, which requires compilation with latex+dvips rather than pdflatex. It can, however, be used with xelatex. (The extent to which this is a limitation depends on how much one requires features special to pdflatex.)
+There are two limitations to the package: one is that it relies on \pkg{pstricks}, which requires compilation with latex+dvips rather than pdflatex. It can, however, be used with xelatex. (The extent to which this is a limitation depends on how much one requires features special to pdflatex.)
-The second limitation is that because it redefines the original \texttt{\bs putvowel} command, it is not compatible with vowel charts originally created with vowel.sty using that command. For such documents, any uses of \texttt{\bs putvowel} will need to include the extra node argument as described in section \ref{sec:arb} above. Vowel charts created using only the \texttt{\bs putcvowel} command will work with pst-vowel without modification.
+The second limitation is that because it redefines the original \texttt{\bs putvowel} command, it is not compatible with vowel charts originally created with \pkg{vowel.sty} using that command. For such documents, any uses of \texttt{\bs putvowel} will need to include the extra node argument as described in section \ref{sec:arb} above. Vowel charts created using only the \texttt{\bs putcvowel} command will work with \pkg{pst-vowel} without modification.
\section{Disclaimer and Acknowledgements}
\subsection{Disclaimer}
All the vowel charts presented in this document are for illustration purposes only. The author is not a phonetician, and bears no responsibility for how realistic or correct the example charts are.
-The documentation here is not intended to be a replacement of the vowel.sty documentation, and especially not a replacement of the pstricks documentation. Some familiarity with both is assumed, although there are enough examples in the text to get you started.
+The documentation here is not intended to be a replacement of the \pkg{vowel.sty} documentation, and especially not a replacement of the \pkg{pstricks} documentation. Some familiarity with both is assumed, although there are enough examples in the text to get you started.
\subsection{Acknowledgements}
-I would like to thank Rei Fukui for creating the original vowel.sty upon which this package is based. Thanks also to Yoshinari Fujino for inadvertently getting me to write the package itself and providing extremely helpful comments on the documentation (including pointing out the inaccuracies which give rise to the disclaimer above!)
+I would like to thank Rei Fukui for creating the original \pkg{vowel.sty} upon which this package is based. Thanks also to Yoshinari Fujino for inadvertently getting me to write the package itself and providing extremely helpful comments on the documentation (including pointing out the inaccuracies which give rise to the disclaimer above!)
\end{document}