censor (25jun13)

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

3 files changed, 35 insertions, 6 deletions

diff --git a/Master/texmf-dist/doc/latex/censor/README b/Master/texmf-dist/doc/latex/censor/README
index 414d772f144..e3107c94233 100644
--- a/Master/texmf-dist/doc/latex/censor/README
+++ b/Master/texmf-dist/doc/latex/censor/README
@@ -1,4 +1,4 @@
-CENSOR
+The censor package
 
 This package provides simple tools for creating redacted documents with
 blacked-out text.  It's tools are useful both for creating documents in
@@ -7,8 +7,7 @@ environment) as well as in an unrestricted environment (for eventual
 transfer and completion in the restricted environment).
 
 As of V2.0, the ability to blackout larger blocks of text is available,
-up to a whole paragraph simply, and even across paragraph boundaries
-(with a small modification required to your text).
+up to a whole paragraph simply, and even across paragraph boundaries.
 
 V2.1 tries to minimize formatting discrepancies (i.e., text spacing)
 between the redacted and unredacted versions of the document.
@@ -20,3 +19,7 @@ etc.
 V3.1 gives unrestricted use of \par in arguments to \blackout.  Also,
 \xblackout introduced to give interword blacking not offered by
 \blackout.
+
+V3.2 allows control over the characteristics (depth and height) of the
+censor blackout rule.  It also gives additional control on how to handle
+the censoring of periods.
diff --git a/Master/texmf-dist/doc/latex/censor/censor.pdf b/Master/texmf-dist/doc/latex/censor/censor.pdf
index 0e6b1081145..e846a0a2578 100644
--- a/Master/texmf-dist/doc/latex/censor/censor.pdf
+++ b/Master/texmf-dist/doc/latex/censor/censor.pdf
diff --git a/Master/texmf-dist/doc/latex/censor/censor.tex b/Master/texmf-dist/doc/latex/censor/censor.tex
index 09870223b16..50ee40bfc31 100644
--- a/Master/texmf-dist/doc/latex/censor/censor.tex
+++ b/Master/texmf-dist/doc/latex/censor/censor.tex
@@ -13,8 +13,8 @@
 \small \rule{0in}{1em}Tools for Producing Redacted Documents\\
 \large \rule{0in}{2em} Steven B. Segletes\\
 steven.b.segletes.civ@mail.mil\\
-\rule{0em}{2em}2013/05/02\\
-v3.10
+\rule{0em}{2em}\today\\
+v\censorversionnumber
 \end{center}
 
 \section{Introduction}
@@ -525,7 +525,30 @@ It is not envisioned that the \verb|\blackout| or \verb|\xblackout|
 commands, discussed in the prior section, are used in this mode, where
 the source file is in an unsecure environment.
 
-\clearpage
+\section{Censor Marks}
+
+The censor (blacking) mark is a \verb|\rule| which has a depth
+\(-\)0.3ex (\textit{i.e.}, below the baseline), and a height of 2.1ex,
+by default.  The characteristics of that rule may be changed by setting
+the following two lengths.
+
+\itshape
+\verb|   \censorruledepth=|length\\
+\verb|   \censorruleheight=|length
+\upshape
+
+In addition, it was mentioned that periods are not censored, so as to
+preserve the ability of \LaTeX{} to produce censored output of
+\textit{identical} spacing to the uncensored output.  If, however, the
+preservation of space is not essential, and the user does not wish to
+have periods appear in the censored output, the definition
+\verb|\censordot|, by default
+
+\verb|   \def\censordot{.}|
+
+can be redefined as a blank space, as a null character, or something
+else, at the users' discretion.
+
 \section{Summary \& Miscellany}
 
 The complete set of commands available to the \textsf{censor} package,
@@ -542,6 +565,9 @@ height mult.\tt\}\{\it depth mult.\tt\}\\
               only\upshape)\\
 \verb|   \StopCensoring|\\
 \verb|   \RestartCensoring|\\
+\verb|   \censorruledepth=|\it length\\
+\verb|   \censorruleheight=|length\\
+\verb|   \def\censordot{.| \upshape or \it character\tt\}\\
 ~\\}
 The star ({\tt*}) version of the commands is envisioned when the source
 document is being created in an unsecure environment, whereas, the