X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=hacks%2Fxmatrix.man;h=ee40725d3038b645ae31d664d7af2c3d6d079faa;hb=c1b9b55ad8d59dc05ef55e316aebf5863e7dfa56;hp=4f8bc1d1f6413323d7783d935c64665cd49b7df5;hpb=96bdd7cf6ea60c418a76921acaf0e34d6f5be930;p=xscreensaver

diff --git a/hacks/xmatrix.man b/hacks/xmatrix.man
index 4f8bc1d1..ee40725d 100644
--- a/hacks/xmatrix.man
+++ b/hacks/xmatrix.man
@@ -1,3 +1,16 @@
+.de EX		\"Begin example
+.ne 5
+.if n .sp 1
+.if t .sp .5
+.nf
+.in +.5i
+..
+.de EE
+.fi
+.in -.5i
+.if n .sp 1
+.if t .sp .5
+..
 .TH XScreenSaver 1 "30-Oct-99" "X Version 11"
 .SH NAME
 xmatrix - simulates the computer displays from the movie
@@ -10,14 +23,16 @@ xmatrix - simulates the computer displays from the movie
 [\-top | \-bottom | \-both]
 [\-small | \-large]
 [\-trace]
+[\-mode \fImode\fP]
 [\-phone \fInumber\fP]
+[\-fps]
 .SH DESCRIPTION
 The \fIxmatrix\fP program draws dropping characters similar to what
 is seen on the computer monitors in the Wachowski brothers' film,
 "The Matrix".  
 
 Also see
-.BR glmatrix (1)
+.BR glmatrix (MANSUFFIX)
 for a 3D rendering of the similar effect that appeared in the title
 sequence of the movie.
 .SH OPTIONS
@@ -64,28 +79,49 @@ switch to both-mode.
 These options specify the sizes of the characters.  The default
 is \fB\-large\fP.
 .TP 8
-.B \-trace
+.B \-mode trace
 Start off with a representation of a phone number being traced.  
 When the number is finally found, display The Matrix as usual.
+This is the default.
 .TP 8
 .B \-phone\fP \fInumber\fP
 The phone number to trace, if \fB\-trace\fP is specified.
 .TP 8
-.B \-crack
+.B \-mode crack
 Start off by shutting down the power grid.
 .TP 8
-.B \-binary\fP
+.B \-mode binary
 Instead of displaying Matrix glyphs, only display ones and zeros.
 .TP 8
-.B \-hexadecimal\fP
+.B \-mode hexadecimal
 Instead of displaying Matrix glyphs, display hexadecimal digits.
 .TP 8
-.B \-dna\fP
+.B \-mode dna
 Instead of displaying Matrix glyphs, display genetic code
 (guanine, adenine, thymine, and cytosine.)
 .TP 8
-.B \-knock\-knock\fP
-Produce some messages at random times.
+.B \-mode ascii
+Instead of displaying Matrix glyphs, display random ASCII characters.
+.TP 8
+.B \-mode pipe
+Instead of displaying random characters, display the output of a subprocess,
+as ASCII.
+.TP 8
+.B \-program \fIsh-command\fP
+The command to run to generate the text to display.  This option may
+be any string acceptable to /bin/sh.  The program will be run at the
+end of a pty or pipe, and any characters that it prints to
+\fIstdout\fP will be placed in the feeders for xmatrix. If the program
+exits, it will be launched again after xmatrix has processed all the
+text it produced.
+
+For example:
+.EX
+xmatrix -program 'echo Hello World'
+xmatrix -ascii -program 'ps -eo comm | rev'
+xmatrix -program 'od -txC -w6 /dev/random'
+xmatrix -program 'cat /dev/random'
+.EE
 .SH ENVIRONMENT
 .PP
 .TP 8
@@ -96,7 +132,7 @@ to get the default host and display number.
 to get the name of a resource file that overrides the global resources
 stored in the RESOURCE_MANAGER property.
 .SH SEE ALSO
-.BR glmatrix (1),
+.BR glmatrix (MANSUFFIX),
 .BR X (1),
 .BR xscreensaver (1)
 .SH COPYRIGHT