1 .TH XScreenSaver 1 "20-Mar-2005 (4.21)" "X Version 11"
3 xscreensaver\-text - prints some text to stdout, for use by screen savers.
10 [\--program \fICMD\fP]
13 The \fIxscreensaver\-text\fP script prints out some text for use by
14 various screensavers, according to the options set in the ~/.xscreensaver
15 file. This may dump the contents of a file, run a program, or load a URL.
18 accepts the following options:
20 .B \-\-columns \fIN\fP or \-\-cols \fIN\fP
21 Where to wrap lines; default 72 columns.
23 .B \-\-verbose \fRor\fP \-v
24 Print diagnostics to stderr. Multiple \fI-v\fP switches increase the
27 Command line options may be used to override the settings in the
30 .B \-\-string \fISTRING\fP
31 Print the given string. It may contain % escape sequences as per
34 .B \-\-file \fIPATH\fP
35 Print the contents of the given file. If --cols is specified, re-wrap
36 the lines; otherwise, print them as-is.
38 .B \-\-program \fICMD\fP
39 Run the given program and print its output. If --cols is specified,
42 .B \-\-url \fIHTTP-URL\fP
43 Download and print the contents of the HTTP document. If it contains
44 HTML, RSS, or Atom, it will be converted to plain-text.
46 Note: this re-downloads the document every time it is run! It might
47 be considered abusive for you to point this at a web server that you
52 .B HTTP_PROXY\fR or \fPhttp_proxy
53 to get the default HTTP proxy host and port.
55 The RSS and Atom output is always ISO-8859-1, regardless of locale.
57 URLs should be cached, use "If-Modified-Since", and obey "Expires".
59 .BR xscreensaver-demo (1),
62 .BR phosphor (MANSUFFIX),
63 .BR apple2 (MANSUFFIX),
64 .BR starwars (MANSUFFIX),
65 .BR fontglide (MANSUFFIX),
67 .BR webcollage (MANSUFFIX),
69 .I http://www.livejournal.com/stats/latest-rss.bml,
71 .I http://twitter.com/statuses/public_timeline.atom,
77 Copyright \(co 2005 by Jamie Zawinski. Permission to use, copy, modify,
78 distribute, and sell this software and its documentation for any purpose is
79 hereby granted without fee, provided that the above copyright notice appear
80 in all copies and that both that copyright notice and this permission notice
81 appear in supporting documentation. No representations are made about the
82 suitability of this software for any purpose. It is provided "as is" without
83 express or implied warranty.
85 Jamie Zawinski <jwz@jwz.org>, 20-Mar-2005.