From a87f441c572f94f8b034b30dd26010049e469bfe Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Fri, 10 Jun 2016 23:21:30 +0000
Subject: he-she (7jun16)

git-svn-id: svn://tug.org/texlive/trunk@41359 c570f23f-e606-0410-a88d-b1316a301751
---
 Master/texmf-dist/doc/latex/he-she/he-she.tex | 109 ++++++++++++++++----------
 1 file changed, 66 insertions(+), 43 deletions(-)

(limited to 'Master/texmf-dist/doc/latex/he-she/he-she.tex')

diff --git a/Master/texmf-dist/doc/latex/he-she/he-she.tex b/Master/texmf-dist/doc/latex/he-she/he-she.tex
index 7168445150f..88db72a4163 100644
--- a/Master/texmf-dist/doc/latex/he-she/he-she.tex
+++ b/Master/texmf-dist/doc/latex/he-she/he-she.tex
@@ -1,16 +1,18 @@
+% !TEX TS-program = pdflatexmk
+
 \documentclass[11pt]{article}
 \title{\textbf{The \textsf{he-she} package}}
 \author{\textbf{Alan Munn}\\Department of Linguistics and Languages\\Michigan State University\\\texttt{\href{mailto:amunn@msu.edu}{amunn@msu.edu}}}
-\date{Version 1.1\\March 4, 2013}
+\date{Version 1.3\\June 6, 2016}
 \usepackage[T1]{fontenc}
-\usepackage[margin=.7in]{geometry}
+\usepackage[margin=1in,includefoot]{geometry}
 \usepackage{titling}
 \usepackage[utf8]{inputenc}
 \usepackage{array, booktabs, multicol, fancyhdr, xspace,tabularx}
 \usepackage{enumitem}
 \usepackage{fancyvrb,listings,url}
 \usepackage[sf,compact]{titlesec}
-\usepackage[para]{he-she}
+\usepackage[]{he-she}
 \usepackage{gb4e}
 \usepackage[colorlinks=true]{hyperref}
 \noautomath
@@ -38,6 +40,8 @@
     showstringspaces=false,
     breaklines=true,
     breakautoindent=true,
+    breakindent=1em,
+    xrightmargin=2.5em,
     captionpos=t
     language=TeX
 }
@@ -83,7 +87,7 @@ If you are trying to write truly gender-neutral text, then generic constructs li
 
 One option that some seem to have adopted is to switch genders every time a generic pronoun is required so that the first instance of a generic would be continued with \emph{he} and the second by \emph{she}, and so on throughout a text.
 
-It's debatable whether this is in fact a good strategy, and the present author in no way endorses it, but it was fun to write the resultant package.  So, should you wish to adopt the strategy, and be in need of an automatic way to do it (which makes sense, since otherwise it would be hard to keep track of the switches) the present package is for you.
+It's debatable whether this is in fact a good strategy, and I in no way endorse it, but it was fun to write the resultant package.  So, should you wish to adopt the strategy, and be in need of an automatic way to do it (which makes sense, since otherwise it would be hard to keep track of the switches) the present package is for you.
 \section{Package Options}
 There are three package options, two serious, and one comic.
 \begin{center}
@@ -100,32 +104,38 @@ There are three package options, two serious, and one comic.
 
 
 \section{User commands}
-The user commands are quite simple: for each pronoun case form (nominative, accusative, and genitive) there is a switching version and an anaphoric version. In the accusative, there is also a reflexive form.\footnote{In most normal use the reflexive form will only be used in its anaphoric form. I'll leave it as an exercise to the reader to figure out why; linguists in particular may have a use for the switching form, however.}  Each of these has both an uppercase version and a lowercase version. The anaphoric forms can be of either gender, just to keep everyone happy. (But since the feminine accusative and genitive forms (\emph{her}) are identical, the feminine genitive macro is \pkg{\bs hir}.) There are also a couple of flags that may be of use.\bigskip
+The user commands are quite simple: for each pronoun case form (nominative, accusative, and genitive determiner and genitive pronominal) there is a switching version and an anaphoric version. In the accusative, there is also a reflexive form.\footnote{In most normal use the reflexive form will only be used in its anaphoric form. I'll leave it as an exercise to the reader to figure out why; linguists in particular may have a use for the switching form, however.}  Each of these has both an uppercase version and a lowercase version. The anaphoric forms can be of either gender, just to keep everyone happy. Since the feminine accusative and genitive determiner forms (\emph{her}) are identical, the feminine genitive determiner macro is |\hir|. And since the masculine genitive pronominal form is the same as the determiner form, the masculine genitive pronominal form is |\hiss|.  There are also a couple of flags that may be of use.\bigskip
 
-\begin{tabularx}{.8\textwidth}{>{\ttfamily}lX}
+\noindent
+\begin{tabularx}{.9\textwidth}{>{\ttfamily}l>{\ttfamily}lX}
 \toprule
-\normalfont\textbf{Command} & \textbf{Description}\\
+\normalfont\textbf{Command} & \normalfont\textbf{Synonym} &\textbf{Description}\\
 \midrule
-{\bs heshe} &  Outputs either \emph{he} or \emph{she} and switches gender.\\
-{\bs he} &  Anaphoric \emph{he} or \emph{she} according to the current gender state.\\
-{\bs himher} &  \emph{him} or \emph{her} switch.\\
-{\bs himherself} & \emph{himself} or \emph{herself} switch\\
-{\bs him} &  \emph{him} or \emph{her} anaphoric.\\
-{\bs himself} & \emph{himself} or \emph{herself} anaphoric.\\
-{\bs hisher} &  \emph{his} or \emph{her} switch.\\
-{\bs his} &  \emph{his} or \emph{her} anaphoric.\\
-{\bs Heshe} &  Uppercase version.\\
-{\bs Himher} &  Uppercase version.\\
-{\bs Himherself} & Uppercase version.\\
-{\bs Hisher} &  Uppercase version.\\
-{\bs He} &  Uppercase version.\\
-{\bs Him} &  Uppercase version.\\
-{\bs Himself} & Uppercase version.\\
-{\bs His} &  Uppercase version.\\
-{\bs she,\bs her,\bs herself, \bs hir} & synonyms for the anaphoric pronouns.\\
-{\bs She,\bs Her, \bs Herself, \bs Hir} & uppercase synonyms for the anaphoric pronouns.\\
-{\bs xspacefalse} &  turn off the use of \texttt{\bs xspace}.\\
-{\bs hetrue,\bs hefalse} &  switches current gender state.\\
+{\bs heshe} &  & Outputs either \emph{he} or \emph{she} and switches gender.\\
+{\bs he} & {\bs she} & Anaphoric \emph{he} or \emph{she} according to the current gender state.\\
+{\bs himher} & & \emph{him} or \emph{her} switch.\\
+{\bs him} &   {\bs her} & \emph{him} or \emph{her} anaphoric.\\
+{\bs himherself} & & \emph{himself} or \emph{herself} switch\\
+{\bs himself} & {\bs herself} & \emph{himself} or \emph{herself} anaphoric.\\
+{\bs hisher} & & \emph{his} or \emph{her} switch.\\
+{\bs his} & {\bs hir} & \emph{his} or \emph{her} anaphoric.\\
+{\bs hishers} & & \emph{his} or \emph{hers} switch.\\
+{\bs hiss} & {\bs hers } & \emph{his} or \emph{hers} anaphoric.\\
+{\bs Heshe} & &  Uppercase version.\\
+{\bs Himher} & &  Uppercase version.\\
+{\bs Himherself} & & Uppercase version.\\
+{\bs Hisher} & &  Uppercase version.\\
+{\bs Hishers} & & Uppercase version.\\
+{\bs He} & {\bs She} &  Uppercase version.\\
+{\bs Him} & {\bs Her} &  Uppercase version.\\
+{\bs Himself} & {\bs Herself} & Uppercase version.\\
+{\bs His} & {\bs Hir} &  Uppercase version.\\
+{\bs Hiss} & {\bs Hers} & Uppercase version.\\
+%{\bs she,\bs her,\bs herself, \bs hers} & synonyms for the anaphoric pronouns.\\
+%{\bs She,\bs Her, \bs Herself, \bs Hers} & uppercase synonyms for the anaphoric pronouns.\\
+{\bs xspacefalse} & & turn off the use of \texttt{\bs xspace}.\\
+%{\bs hetrue,\bs hefalse} & & switches current gender state.\\
+{\bs setgender\{\}} & & takes one argument: Male/Masculine/M, Female/Feminine/F to set the current gender state.\\
 \bottomrule
 \end{tabularx}\bigskip
 
@@ -159,51 +169,63 @@ When a student registers, \heshe receives an ID card. \He also must go to the ad
 \end{xlist}
 \end{exe}
 
-In the first example, the switching version is used throughout, yielding the gibberish of (\ref{switched}). In the second example the first instance of the pronoun uses the switching version (\pkg{\bs heshe}) (here assuming it has been already used once), but subsequent anaphoric references to the current gender are preserved using the anaphoric versions (\pkg{\bs he,\bs his} or \pkg{\bs his}).
+In the first example, the switching version is used throughout, yielding the gibberish of (\ref{switched}). In the second example the first instance of the pronoun uses the switching version (|\heshe|) (here assuming it has been already used once), but subsequent anaphoric references to the current gender are preserved using the anaphoric versions (|\he,\him|, |\his| or |\hiss|).
 
 \subsection{Use of the \pkg{xspace} package}
 By default, the package uses the \pkg{xspace} package to insert a space automatically after the pronoun. The \pkg{xspace} package automatically checks for following punctuation and suppresses the space in these cases.  However, it's not perfect, and some users might prefer not to have the space inserted automatically.  They can do this by using the \pkg{[noxspace]} option.
 
-If you are using the default settings, and encounter problems (for example, using a pronoun macro as the argument to another macro such as \pkg{\bs emph} or \pkg{\bs textbf}) will pose problems) you can temporarily suppress the insertion of the space using the boolean \pkg{\bs xspacefalse}. The examples below illustrate this.
+If you are using the default settings, and encounter problems (for example, using a pronoun macro as the argument to another macro which ends in |\relax| will pose problems, as will punctuation that \pkg{xspace} doesn't know about) you can temporarily suppress the insertion of the space using the boolean |\xspacefalse|. The examples below illustrate this.
 
+\newcommand*\mymacro[1]{#1\relax}
 \begin{exe}
 \ex\label{xspaces}
 \begin{xlist}
 \ex \begin{lstlisting}
-\emph{\Heshe} will leave.
+\newcommand*\mymacro[1]{#1\relax}
+I will see \mymacro{\himher}.
 \end{lstlisting}
-\ex \emph{\Heshe} will leave.\hfill(Extra space incorrectly inserted.)
+\ex I will see \mymacro{\himher}.\hfill(Extra space incorrectly inserted.)
 \ex\begin{lstlisting}
-\emph{\xspacefalse\Heshe} will leave.
+\newcommand*\mymacro[1]{\xspacefalse#1\relax}
+I will see \mymacro{\himher}.
 \end{lstlisting}
-\ex \emph{\hetrue\xspacefalse\Heshe} will leave.\hfill(Extra space suppressed.)
+\def\mymacro#1{\xspacefalse#1\relax}
+\ex I will see \mymacro{\himher}.\hfill(Extra space suppressed.)
 \end{xlist}
 \end{exe}
 \subsection{Manually switching the gender state}
-The booleans \pkg{\bs hetrue} and \pkg{\bs hefalse} can be used anywhere to manually change the current gender. The first use of a switching pronoun inserts a masculine pronoun and then changes the gender to feminine by setting \pkg{\bs hefalse}. This means that for an anaphoric pronoun, the form is the opposite gender to the current state of the boolean.  This is best shown by some examples:
+\sloppy For some purposes it might be useful to set the gender manually.  For this there is the |\setgender{}| command. This command takes one argument which can be any version of |Male/Female/Masculine/Feminine/M/F|. Using the manual method might actually be practical in some cases.  For example, you could set the state at the beginning of a chapter and then just use the anaphoric version of the pronouns for all generic pronouns throughout the chapter.  This might be a less annoying strategy than switching pronouns constantly throughout a chapter. Another possible use for this method would be for form letters which have text which must be personalized for the gender of the addressee.
+
+Here are some examples.  In (\ref{booleansa}) we see the gender set to F and then a switching version of the pronoun is used. This switches the gender to M.  In (\ref{booleansb}), the gender is set to F and then a anaphoric pronoun is used, and its gender is also F.\footnote{This command replaces direct manipulation of the state-switching boolean which was present in older versions. Documents using these direct manipulations will still work, however.}
+
 
 \begin{exe}
-\ex\label{booleans}
+\ex\label{booleansa}
 \begin{xlist}
 \ex \begin{lstlisting}
-\Heshe will leave.
+\setgender{F} \Heshe will leave.
 \end{lstlisting}
-\ex \hefalse\Heshe will leave.\hfill(Boolean state: \pkg{\bs hetrue })
+\ex \setgender{F}\Heshe will leave.\hfill(Since gender is set to F, the switched pronoun is M)
+\end{xlist}
+\end{exe}
+\begin{exe}
+\ex\label{booleansb}
+\begin{xlist}
 \ex\begin{lstlisting}
-\hefalse \He will leave.
+\setgender{F} \He will leave.
 \end{lstlisting}
-\ex \hefalse \He will leave.\hfill(Because of \pkg{\bs hefalse} the anaphoric pronoun is masculine)
+\ex \setgender{F} \He will leave.\hfill(Since gender is set to F the anaphoric pronoun is also F)
 \end{xlist}
 \end{exe}
 
-Using the manual method might actually be practical in some cases.  For example, you could set the state at the beginning of a chapter and then just use the anaphoric version of the pronouns for all generic pronouns throughout the chapter.  This might be a less annoying strategy than switching pronouns constantly throughout a chapter.
+
 \section{The \pkg{[para]} option}
 For some purposes it may be useful to have the genders switch every paragraph.  In this case you may use the \pkg{[para]} option.  With this option, every new paragraph resets the gender.  In this case, as with the per chapter example just discussed, \emph{only} the anaphoric versions of the pronouns should be used in the running text. This option was added in response to another  \href{http://tex.stackexchange.com/q/100108/2693}{Stack Exchange question}.
 
 \section{The \pkg{[they]} option}
-When you get tired of the silliness of alternating genders, you can switch to
+When you get tired of alternating genders, you can switch to
 this option, which will replace all of the relevant pronouns with the third
-person plural pronoun form (\emph{they/them/their}).  Note that for the nominative
+person plural pronoun form (\emph{they/them/their/theirs}).  Note that for the nominative
 this will cause your document to produce ungrammatical text, since there is 
 no way to fix the subject/verb agreement. As a result, this is probably not intended to be a robust alternative! You have been warned! (And you will be if you use it too.) Here is a sample:
 \begin{exe}
@@ -216,5 +238,6 @@ If someone thinks \heshe is sick \he should go to a doctor immediately. When \he
 \end{xlist}
 \end{exe}
 \section{Bugs}
-Feel free to report bugs if you find some. Given the low utility of the whole package, they may or may not be addressed. (Although if you really find the package useful, please let me know.)  The same goes for feature requests.
+Feel free to report bugs if you find some. I will try to address them as time permits. Also,  if you really find the package useful, please let me know.  The same goes for feature requests.
+
 \end{document}
\ No newline at end of file
-- 
cgit v1.2.3

