http://packetstormsecurity.org/UNIX/admin/xscreensaver-4.14.tar.gz
[xscreensaver] / hacks / ljlatest.man
1 .de EX          \"Begin example
2 .ne 5
3 .if n .sp 1
4 .if t .sp .5
5 .nf
6 .in +.5i
7 ..
8 .de EE
9 .fi
10 .in -.5i
11 .if n .sp 1
12 .if t .sp .5
13 ..
14 .TH XScreenSaver 1 "17-Jun-99" "X Version 11"
15 .SH NAME
16 ljlatest - prints the most recent public posts on livejournal.com.
17 .SH SYNOPSIS
18 .B ljlatest
19 [\--verbose]
20 [\--count \fIN\fP]
21 [\--columns \fIN\fP]
22 [\--images]
23 [\fIurl\fP]
24 .SH DESCRIPTION
25 The \fIljlatest\fP script reads the most recent public posts made to
26 livejournal.com, and prints them on stdout, after doing a rudimentary
27 conversion of HTML to plain text.
28
29 This is intended as a replacement for
30 .BR fortune (1)
31 for use with those
32 .BR xscreensaver (1)
33 programs that run an external program to generate text.  For example:
34 .EX
35 fontglide -program ljlatest
36 starwars -program ljlatest
37 phosphor -scale 2 -program 'ljlatest --cols 40'
38 .EE
39 .SH OPTIONS
40 .I ljlatest
41 accepts the following options:
42 .TP 8
43 .B \-\-count \fIN\fP
44 How many entries to print; the default is to print all that are available
45 in the LiveJournal RSS file (a few hundred.)
46 .TP 8
47 .B \-\-columns \fIN\fP or \-\-cols \fIN\fP
48 Where to wrap lines; default 72 columns.
49 .TP 8
50 .B \-\-images
51 Instead of printing the plain text of the recent entries, print HTML of all
52 of the inlined images in the recent entries.  Using this option, you can
53 create an HTML page of images recently posted to LiveJournal.
54 .TP 8
55 .B \-\-verbose \fRor\fP \-v
56 Print diagnostics to stderr.  Multiple \fI-v\fP switches increase the
57 amount of output.
58 .TP 8
59 .B \fIurl\fP
60 Which URL to load; default:
61     http://www.livejournal.com/stats/latest-rss.bml
62 .SH ENVIRONMENT
63 .PP
64 .TP 8
65 .B http_proxy\fR or \fPHTTP_PROXY
66 to get the default HTTP proxy host and port.
67 .SH BUGS
68 This program makes it seem like morons have invaded your screen saver.
69
70 The output is always ISO-8859-1, regardless of locale.
71 .SH SEE ALSO
72 .I http://www.livejournal.com/,
73 .BR xscreensaver (1),
74 .BR fortune (1),
75 .BR phosphor (1),
76 .BR apple2 (1),
77 .BR starwars (1),
78 .BR fontglide (1),
79 .BR dadadodo (1),
80 .BR webcollage (1),
81 .BR driftnet (1)
82 .BR EtherPEG ,
83 .BR EtherPeek
84 .SH COPYRIGHT
85 Copyright \(co 2003 by Jamie Zawinski.  Permission to use, copy, modify,
86 distribute, and sell this software and its documentation for any purpose is
87 hereby granted without fee, provided that the above copyright notice appear
88 in all copies and that both that copyright notice and this permission notice
89 appear in supporting documentation.  No representations are made about the
90 suitability of this software for any purpose.  It is provided "as is" without
91 express or implied warranty.
92 .SH AUTHOR
93 Jamie Zawinski <jwz@jwz.org>, 30-Aug-2003.