summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/he-she
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/he-she
Initial commit
Diffstat (limited to 'macros/latex/contrib/he-she')
-rw-r--r--macros/latex/contrib/he-she/README26
-rw-r--r--macros/latex/contrib/he-she/he-she.pdfbin0 -> 207497 bytes
-rw-r--r--macros/latex/contrib/he-she/he-she.sty404
-rw-r--r--macros/latex/contrib/he-she/he-she.tex243
4 files changed, 673 insertions, 0 deletions
diff --git a/macros/latex/contrib/he-she/README b/macros/latex/contrib/he-she/README
new file mode 100644
index 0000000000..f6c7ff33f7
--- /dev/null
+++ b/macros/latex/contrib/he-she/README
@@ -0,0 +1,26 @@
+This package implements a version of semi-automatic pronoun switching
+for writing gender-neutral (and possibly annoying) prose. The basic code
+is due to Josef (no last name) and Martin Scharrer on
+http://tex.stackexchange.com/questions/10787/
+
+Modified to handle anaphoric reference to the current gender plus all
+three case forms in both uppercase and lowercase. Includes an option to
+flag to turn off xspace, and a silly option for replacing all pronouns
+with 'they/them/their'.
+
+Copyright 2011,2013, 2016 by Alan Munn
+
+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
+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.
+
+This package has the LPPL maintenance status `maintained'.
+
+The Current Maintainer of this package is Alan Munn.
+
+This package consists of the file he-she.sty and documentation files
+he-she.tex and he-she.pdf
+
+Version 1.3 2016/06/06
diff --git a/macros/latex/contrib/he-she/he-she.pdf b/macros/latex/contrib/he-she/he-she.pdf
new file mode 100644
index 0000000000..6da8764241
--- /dev/null
+++ b/macros/latex/contrib/he-she/he-she.pdf
Binary files differ
diff --git a/macros/latex/contrib/he-she/he-she.sty b/macros/latex/contrib/he-she/he-she.sty
new file mode 100644
index 0000000000..93100aa1f7
--- /dev/null
+++ b/macros/latex/contrib/he-she/he-she.sty
@@ -0,0 +1,404 @@
+% This package implements a version of semi-automatic pronoun switching for writing
+% gender-neutral (and possibly annoying) prose.
+% The basic code is due to Josef (no last name) and Martin Scharrer on
+% http://tex.stackexchange.com/questions/10787/
+%
+% Modified to handle anaphoric reference to the current gender plus
+% all three case forms in both uppercase and lowercase.
+% Includes an option to flag to turn off xspace, and a silly option for replacing
+% all pronouns with 'they/them/their'.
+%
+% Copyright 2011, 2013, 2016 by Alan Munn
+%
+% 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 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.
+%
+% This package has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this package is Alan Munn.
+%
+% This package consists of the file he-she.sty and documentation files
+% he-she.tex and he-she.pdf
+%
+% Option noxspace
+%
+% xspace can cause problems if the macro is e.g. enclosed in other markup such
+% as \emph{}. The noxspace option turns off the xspace and forces users to
+% insert a following space using "\ " explicitly. Default is to enable xspace.
+%
+% With the default option, the \xspace can be suppressed with the \xspacefalse
+% command as needed.
+%
+% Option they
+%
+% When you get tired of of alternating genders, you can switch to
+% this option, which will replace all of the relevant pronouns with the third
+% person plural pronoun form ('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.)
+%
+% Version history
+% Version 1.0 2011/02/13 Initial release.
+% Version 1.1 2013/03/04 Added [para] option and reflexive forms.
+% Version 1.1b 2013/06/11 Fixed bug with [para] option (thanks to Enrico Gregorio)
+% Version 1.2 2016/05/25 Added \hishers, \hers and \hiss commands
+% (thanks to Mike Sabin for the feature request)
+% Version 1.3 2016/06/06 Added a \setgender command to make choosing the gender more user friendly.
+% Documentation rewritten to reflect this change. All internal macros have now been prefixed with HS@
+% User level access to the booleans is now through \setgender although the old booleans are emulated
+% for backwards compatibility.
+% (thanks to Sefarin James for the feature request)
+%
+\ProvidesPackage{he-she}[2016/06/06 Semi-automatic pronoun switching with anaphora v1.3]
+\RequirePackage{xspace}
+\newif\ifxspace\xspacetrue
+\newif\ifHS@they\HS@theyfalse
+\newif\ifHS@para
+\DeclareOption{noxspace}{\xspacefalse}
+\DeclareOption{they}{%
+ \HS@theytrue
+ \PackageWarning{he-she}{*** WARNING: Use of option `\CurrentOption` will screw up subject/verb agreement for most nominative pronouns. It is only present for for its comic value! USE AT YOUR OWN RISK! ***}
+}
+%
+\DeclareOption{para}{
+ \HS@paratrue
+ \PackageWarning{he-she}{*** WARNING: Use the `\CurrentOption` at your own risk. With this option you should use *only* the anaphoric versions of the pronouns in your text. ***}}
+%
+\DeclareOption*{%
+ \PackageWarning{he-she}{Unknown option `\CurrentOption`}%
+}
+\ProcessOptions
+% toggle for changing the gender
+\newif\ifHS@he\HS@hetrue
+
+% macro to get first character of a token
+\def\HS@getfirst#1{\HS@fstx#1\empty\empty}
+\def\HS@fstx#1#2\empty{%
+ \edef\HS@fst{#1}}
+
+% macros for comparison
+\def\HS@Masc{M}
+\def\HS@masc{m}
+\def\HS@Fem{F}
+\def\HS@fem{f}
+
+% command to set gender (takes Male/M Female/F etc. or lowercase version of each)
+% expands argument first to allow it to be a macro
+\newcommand\setgender[1]{%
+\edef\next{\noexpand\HS@setgender{#1}}\next}
+\newcommand\HS@setgender[1]{%
+\HS@getfirst{#1}
+\ifx\HS@fst\HS@Masc \global\HS@hefalse
+ \else
+ \ifx\HS@fst\HS@masc \global\HS@hefalse
+ \else
+ \ifx\HS@fst\HS@Fem \global\HS@hetrue
+ \else
+ \ifx\HS@fst\HS@fem \global\HS@hetrue
+ \else
+ \global\HS@hetrue
+ \PackageWarning{he-she}{Invalid value for gender. Using Masculine}
+ \fi
+ \fi
+ \fi
+ \fi
+}
+
+%
+%
+\ifHS@para%
+ \RequirePackage{everyhook}
+ \PushPreHook{par}{\makebox[0pt][0pt]{\xspacefalse\heshe}}
+\fi
+\ifHS@they
+% Implement the (somewhat useless) 'they' option
+%
+\newcommand*{\heshe}{they\ifxspace\xspace\fi}
+\newcommand*{\Heshe}{They\ifxspace\xspace\fi}
+\newcommand*{\himher}{them\ifxspace\xspace\fi}
+\newcommand*{\himherself}{themselves\ifxspace\xspace\fi}
+\newcommand*{\Himher}{Them\ifxspace\xspace\fi}
+\newcommand*{\Himherself}{Themselves\ifxspace\xspace\fi}
+\newcommand*{\hisher}{their\ifxspace\xspace\fi}
+\newcommand*{\hishers}{theirs\ifxspace\xspace\fi}
+\newcommand*{\Hisher}{Their\ifxspace\xspace\fi}
+\newcommand*{\Hishers}{Theirs\ifxspace\xspace\fi}
+\newcommand*{\he}{they\ifxspace\xspace\fi}
+\newcommand*{\He}{They\ifxspace\xspace\fi}
+\newcommand*{\him}{them\ifxspace\xspace\fi}
+\newcommand*{\himself}{themselves\ifxspace\xspace\fi}
+\newcommand*{\Him}{Them\ifxspace\xspace\fi}
+\newcommand*{\Himself}{Themselves\ifxspace\xspace\fi}
+\newcommand*{\his}{their\ifxspace\xspace\fi}
+\newcommand*{\hiss}{theirs\ifxspace\xspace\fi}
+\newcommand*{\His}{Their\ifxspace\xspace\fi}
+\newcommand*{\Hiss}{Theirs\ifxspace\xspace\fi}
+%
+\else
+%
+% Lowercase versions:
+%
+% Nominative lowercase switching form \heshe
+\newcommand*{\heshe}{%
+ \leavevmode
+ \ifHS@he
+ he%
+ \global\HS@hefalse%
+ \else
+ she%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Nominative lowercase anaphoric form \he
+\newcommand*\he{%
+ \leavevmode
+ \ifHS@he
+ she%
+ \else
+ he%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Accusative lowercase switching form \himher
+\newcommand*\himher{%
+ \leavevmode
+ \ifHS@he
+ him%
+ \global\HS@hefalse%
+ \else
+ her%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}%
+% Lowercase switching reflexive form \himherself
+%
+\newcommand*\himherself{%
+ \leavevmode
+ \ifHS@he
+ herself%
+ \else
+ himself%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Accusative lowercase anaphoric form \him
+\newcommand*\him{%
+ \leavevmode
+ \ifHS@he
+ her%
+ \else
+ him%
+ \fi
+ \ifxspace\xspace\fi
+}
+% Lowercase anaphoric reflexive form \himself
+%
+\newcommand*\himself{%
+ \leavevmode
+ \ifHS@he
+ herself%
+ \else
+ himself%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Genitive lowercase switching form \hisher
+\newcommand*\hisher{%
+ \leavevmode
+ \ifHS@he
+ his%
+ \global\HS@hefalse%
+ \else
+ her%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Genitive lowercase anaphoric form \his
+\newcommand*\his{%
+ \leavevmode
+ \ifHS@he
+ her%
+ \else
+ his%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Genitive null NP form ('The car is his/hers')
+% Genitive lowercase switching form \hishers
+\newcommand*\hishers{%
+ \leavevmode
+ \ifHS@he
+ his%
+ \global\HS@hefalse%
+ \else
+ hers%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Genitive lowercase anaphoric form \hiss
+\newcommand*\hiss{%
+ \leavevmode
+ \ifHS@he
+ hers%
+ \else
+ his%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Uppercase versions:
+%
+% Nominative uppercase switching form \Heshe
+\newcommand*{\Heshe}{%
+ \leavevmode
+ \ifHS@he
+ He%
+ \global\HS@hefalse%
+ \else
+ She%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Nominative uppercase anaphoric form \He
+\newcommand*\He{%
+ \leavevmode
+ \ifHS@he
+ She%
+ \else
+ He%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Accusative uppercase switching form \Himher
+\newcommand*\Himher{%
+ \leavevmode
+ \ifHS@he
+ Him%
+ \global\HS@hefalse%
+ \else
+ Her%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}%
+
+% Uppercase switching reflexive form \Himherself
+%
+\newcommand*\Himherself{%
+ \leavevmode
+ \ifHS@he
+ Herself%
+ \else
+ Himself%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Accusative uppercase anaphoric form \Him
+\newcommand*\Him{%
+ \leavevmode
+ \ifHS@he
+ Her%
+ \else
+ Him%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Uppercase anaphoric reflexive form \Himself
+%
+\newcommand*\Himself{%
+ \leavevmode
+ \ifHS@he
+ Herself%
+ \else
+ Himself%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Genitive uppercase switching form \Hisher
+\newcommand*\Hisher{%
+ \leavevmode
+ \ifHS@he
+ His%
+ \global\HS@hefalse%
+ \else
+ Her%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Genitive uppercase anaphoric form \His
+\newcommand*\His{%
+ \leavevmode
+ \ifHS@he
+ Her%
+ \else
+ His%
+ \fi
+ \ifxspace\xspace\fi
+}
+% Genitive null NP form ('The car is his/hers')
+% Genitive uppercase switching form \Hishers
+\newcommand*\Hishers{%
+ \leavevmode
+ \ifHS@he
+ His%
+ \global\HS@hefalse%
+ \else
+ Hers%
+ \global\HS@hetrue%
+ \fi
+ \ifxspace\xspace\fi
+}
+%
+% Genitive uppercase anaphoric form \Hiss
+\newcommand*\Hiss{%
+ \leavevmode
+ \ifHS@he
+ Hers%
+ \else
+ His%
+ \fi
+ \ifxspace\xspace\fi
+}
+\fi
+% Define synonyms
+\let\she\he
+\let\She\He
+\let\her\him
+\let\herself\himself
+\let\Her\Him
+\let\Herself\Himself
+\let\hir\his
+\let\Hir\His
+\let\hers\hiss
+\let\Hers\Hiss
+% These for backward compatibility to previous versions
+\newcommand*\hetrue{\setgender{F}}
+\newcommand*\hefalse{\setgender{M}}
+\endinput \ No newline at end of file
diff --git a/macros/latex/contrib/he-she/he-she.tex b/macros/latex/contrib/he-she/he-she.tex
new file mode 100644
index 0000000000..88db72a416
--- /dev/null
+++ b/macros/latex/contrib/he-she/he-she.tex
@@ -0,0 +1,243 @@
+% !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.3\\June 6, 2016}
+\usepackage[T1]{fontenc}
+\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[]{he-she}
+\usepackage{gb4e}
+\usepackage[colorlinks=true]{hyperref}
+\noautomath
+
+
+\DefineShortVerb{\|}
+\newcommand*\bs{\textbackslash}
+
+\IfFileExists{luximono.sty}%
+{%
+ \usepackage[scaled]{luximono}%
+}
+{%
+ \IfFileExists{beramono.sty}%
+ {%
+ \usepackage[scaled]{beramono}%
+ }{}
+}
+
+
+\lstset{%
+ basicstyle=\ttfamily\small,
+ commentstyle=\itshape\ttfamily\small,
+ showspaces=false,
+ showstringspaces=false,
+ breaklines=true,
+ breakautoindent=true,
+ breakindent=1em,
+ xrightmargin=2.5em,
+ captionpos=t
+ language=TeX
+}
+
+\newcommand*{\pkg}[1]{\texttt{#1}\xspace}
+\setitemize[1]{label={}}
+\setitemize[2]{label={}}
+\setdescription{font={\normalfont}}
+\setlength{\droptitle}{-1in}
+
+\lhead{}
+\chead{}
+\rhead{}
+\lfoot{\emph{}}
+\cfoot{\thepage}
+\rfoot{}
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0pt}
+\pagestyle{fancy}
+
+
+\begin{document}
+\maketitle
+\thispagestyle{empty}
+\renewcommand{\abstractname}{\sffamily Abstract}
+
+\abstract{\noindent\begin{quote}This is a package to produce ``gender neutral'' text by allowing one to alternate use of the masculine and feminine genders within a text. It is not really intended to be taken too seriously (although it works) but it was fun to think about how one would do this automatically. Some comments about using the package in practice are given at the end.\end{quote}}
+\section{Introduction}
+This package arose out of a question asked on the StackExchange website: \href{http://tex.stackexchange.com/questions/10787/}{Alternate he / she in text}. The question asked how easy it would be to automatically alternate masculine and feminine pronouns. A couple of almost identical solutions were proposed by Martin Scharrer and someone named Josef. It became clear to me that the simple solution really wasn't enough, since you don't want to switch pronouns all the time, but also require anaphora to an existing switched pronoun. This package is the result of that discussion.
+\section{Background}
+If you are trying to write truly gender-neutral text, then generic constructs like (\ref{1}) prescriptively require you to use either the masculine pronoun (\ref{he}) (which today sounds very stuffy) or the somewhat awful-looking \emph{he or she} (\ref{heshe}) or even worse \emph{s/he} (\ref{she}). Or you can try to reverse the male-only trend and use only the feminine pronoun as a replacement for (\ref{he}), as in (\ref{she-only}). With any luck the use of the gender neutral \emph{they} (as in (\ref{they1})) will become more acceptable to editors, but until then, people who don't like either of the other options are stuck.
+
+\begin{exe}
+\ex\label{1}
+\begin{xlist}
+\ex When a student registers, he receives an ID card.\label{he}
+\ex When a student registers, he or she receives an ID card.\label{heshe}
+\ex When a student registers, s/he receives an ID card.\label{she}
+\ex When a student register, she receives an ID card.\label{she-only}
+\ex When a student registers, they receive an ID card.\label{they1}
+\end{xlist}
+\end{exe}
+
+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 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}
+\begin{tabularx}{.8\textwidth}{>{\ttfamily}lX}
+\toprule
+\multicolumn{1}{c}{\textbf{Option name}} & \multicolumn{1}{l}{\textbf{Description}}\\
+\midrule
+{[noxspace]} & Disable the use of \pkg{\bs xspace}\\
+{[para]} & Automatically switch the gender every paragraph\\
+{[they]} & Replace all pronouns with the gender neutral \emph{they/them/their}. This is not really a practical option, but is included for comic purposes. (See usage notes below.)\\
+\bottomrule
+\end{tabularx}
+\end{center}
+
+
+\section{User commands}
+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
+
+\noindent
+\begin{tabularx}{.9\textwidth}{>{\ttfamily}l>{\ttfamily}lX}
+\toprule
+\normalfont\textbf{Command} & \normalfont\textbf{Synonym} &\textbf{Description}\\
+\midrule
+{\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
+
+\section{Comments on practical usage}
+\subsection{Use of the switching and anaphoric forms}
+To see why two systems are needed, consider the following continuation of the example in (\ref{1}). If we implemented this by replacing each pronoun with a switching version, the result would be (\ref{switched}), which is ridiculous. Instead, we need subsequent pronouns to be anaphoric to the current gender state, as in (\ref{anaphoric}).
+
+\begin{exe}
+\ex\label{2}
+\begin{xlist}
+\ex \hefalse When a student registers, \heshe receives an ID card. \Heshe also must go to the advising office so that an advisor can verify \hisher schedule with \himher.\label{switched}
+\ex When a student registers, \heshe receives an ID card. \He also must go to the advising office so that an advisor can verify \his schedule with \him.\label{anaphoric}
+\end{xlist}
+\end{exe}
+
+Using the package, the code that produces the two examples in (\ref{2}) is given in (\ref{code}):
+
+\begin{exe}
+\ex\label{code}
+\begin{xlist}
+\ex
+\begin{lstlisting}
+When a student registers, \heshe receives an ID card. \Heshe also must go to the advising office so that an advisor can verify \hisher schedule with \himher.
+\end{lstlisting}
+\sn
+\vskip-2em
+\ex
+\begin{lstlisting}
+When a student registers, \heshe receives an ID card. \He also must go to the advising office so that an advisor can verify \his schedule with \him.
+\end{lstlisting}
+\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 (|\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 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}
+\newcommand*\mymacro[1]{#1\relax}
+I will see \mymacro{\himher}.
+\end{lstlisting}
+\ex I will see \mymacro{\himher}.\hfill(Extra space incorrectly inserted.)
+\ex\begin{lstlisting}
+\newcommand*\mymacro[1]{\xspacefalse#1\relax}
+I will see \mymacro{\himher}.
+\end{lstlisting}
+\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}
+\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{booleansa}
+\begin{xlist}
+\ex \begin{lstlisting}
+\setgender{F} \Heshe will leave.
+\end{lstlisting}
+\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}
+\setgender{F} \He will leave.
+\end{lstlisting}
+\ex \setgender{F} \He will leave.\hfill(Since gender is set to F the anaphoric pronoun is also F)
+\end{xlist}
+\end{exe}
+
+
+\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 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/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}
+\ex\label{they}
+\begin{xlist}
+\ex \begin{lstlisting}
+If someone thinks \heshe is sick \he should go to a doctor immediately. When \he goes to the the doctor, \heshe can figure out the problem.
+\end{lstlisting}
+\ex If someone thinks they is sick they should go to a doctor immediately. When they goes to the the doctor, they can figure out the problem.
+\end{xlist}
+\end{exe}
+\section{Bugs}
+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