logjam(1)

1logjam(1)                         LiveJournal                        logjam(1)
2
3
4

NAME

6       logjam - GTK+ client for LiveJournal
7

SYNOPSIS

9       logjam [OPTIONS] [FILE]
10

DESCRIPTION

12       logjam is a GTK+ client for LiveJournal-based sites such as livejour‐
13       nal.com.
14
15       Aside from writing entries, logjam lets you modify your friends list,
16       edit your previous entries, and more.
17
18       When run with no arguments (or just username option), logjam will run
19       in the GUI mode.  The user interface is mostly self-explanatory, and
20       won't be discussed here in detail, except for a few notes below.
21

OPTIONS AND COMMANDS

23       Options can be given in either short or long forms. For help on a par‐
24       ticular commands, type "logjam COMMAND help". For example, "logjam grep
25       help" will supply help about the grep command.
26
27           Options:
28             -v, --version
29               Show version of program.
30             -q, --quiet
31               Say less.
32
33             -u, --username=USERNAME
34               Username to operate as.
35             -p, --password=PASSWORD
36               Password for the current user.
37             -a, --postas=USERNAME
38               User/community to post as.
39
40             -f, --file=FILE
41               File to load.
42             -e, --edit
43               Use default editor to edit post.
44
45           Subcommands:
46             checkfriends  Efficiently check friends list for updates.
47             console       Run a command on the LiveJournal console.
48             post          Post event immediately.
49             offline       Manage offline copies of your journal.
50             user          Manage user list.
51
52       Also, GTK+ command line options (such as --display) can be used.
53

GUI

55       This section describes some of the GUI features that aren't immediately
56       apparent.
57
58       Check Friends
59
60       logjam can monitor your friends list and notify you when new entries
61       are posted there. Enable this by right-clicking on the indicator at the
62       bottom-left corner of the application window and selecting the appro‐
63       priate menu item. You may also configure logjam to start doing this
64       automatically for you when you login. When new entries are detected,
65       the indicator will turn red to let you know; click it to resume moni‐
66       toring or double-click it to open your browser on your friends page.
67       Optionally, you can have logjam open a small "floating" indicator which
68       has some useful GUI settings of its own.
69
70       Owners of large friends lists may prefer to be notified only after they
71       accumulate several new posts. You may set the threshold for this in the
72       Check Friends settings tab. The default is 1, that is, logjam will tell
73       you immediately when it detects new traffic on your friends page. There
74       is a small limit on the maximum threshold allowed, because this feature
75       is only useful with small threshold values.
76

STARTUP

78       When given a FILE argument, logjam will start up with an existing file
79       as the base for the composed entry. If the filename given is "-", the
80       data will be read from standard input. Several aspects of the entry,
81       such as its subject field and the journal in which to post it to, can
82       be controlled by other options. This is useful in conjunction with the
83       --commandline option, which causes logjam to post an entry without
84       going to GUI mode, allowing completely non-interactive posts. If you do
85       wish to interactively edit the entry, but don't want to load the GUI,
86       use the --edit option.
87
88       Autosave
89
90       logjam will periodically save a draft of your currently edited entry in
91       ~/.logjam/draft if you turn on the draft option in the Preferences dia‐
92       log. This feature is intended for crash recovery, not archiving. If you
93       want to keep a copy of your posts, you should use the Entry > Save As
94       menu option before submitting them. A future version of logjam will
95       support archiving of your journal.
96
97       Please note that when you exit the client normally, your draft is
98       cleared. It does not "stick" for the next invocation, as in the behav‐
99       ior of some other clients.
100
101       Checking friends from the command line
102
103       You can use logjam as a backend for a script or another application
104       that wishes to check the friends view. This may be useful if you don't
105       want to use the GUI, or if you have several journals (in conjunction
106       with --username). To do this, invoke logjam once with --check‐
107       friends=purge (-rpurge if you're using short options), and then some‐
108       thing like:
109
110               logjam --checkfriends && new-entries-handler
111
112       Make sure that your script or application purges the checkfriends sta‐
113       tus as described above once the user has acknowledged the new items,
114       otherwise logjam will always report there's nothing new.  You should
115       also pay attention to limiting your query rate, despite the fact that
116       logjam will refuse to flood the server with queries.  For more informa‐
117       tion, see the messages on the command line. (To suppress these mes‐
118       sages, use --quiet.)
119

AUTHOR

128       This manual page was mostly written by Gaal Yahas <gaal@forum2.org>.
129
130
131
1324.1.1                             2003-04-25                         logjam(1)