sclj(1)

NAME
sclj - LiveJournal.com update client

SYNOPSIS
sclj [ +/-q ] [ -d <dir> ] [ -t <tmpdir> ] [ -e <editor> ] [ -w <columns> ] [ -p <proxy>:<port> ]

DESCRIPTION
sclj is a Perl script to update a LiveJournal from any handy terminal. It is purely text-based; no curses or GUI. For more information about LiveJournal itself, see <http://www.livejournal.com>.

When starting up, the client looks for its configuration file in $HOME/.sclj3/rc; if this file already exists, it's read in. Otherwise, sclj will enter rc-less mode and prompt for a post to open. Once a post is opened, rc-less mode behaves like normal mode.

To create the configuration file and the accounts to use, run scljed. To create an account, you will need your LiveJournal username and editor of choice handy, and possibly your proxy settings. Since LiveJournal essentially uses HTTP, if you don't know whether you need to configure a proxy, consult your web browser settings for HTTP proxies.

Accounts are associated with servers in scljed. When creating a server, the address, port, and path for LiveJournal are displayed in square brackets. Leaving those lines blank will use the bracketed values.

After its configuration is created, the client starts up at the main menu, displaying an LJ: prompt. Typing the word help followed by Enter at this prompt will give the online help for the client. The help is generally intended to relate the client commands to the LiveJournal features that a user is expected to be familiar with.

To log in, use the "login" command. sclj will fetch all the moods that aren't cached, as well as picture keywords, friend group information, and shared journal access. To save this information in the cache, use "login save"; then login will only be needed when that information changes.

In addition to the standard features supported through the Web client, sclj supports several extensions. The first of these is "paragraph-mode" autoformatting, which turns each entirely blank line in the event into a blank line on the server, much like the normal auto-format, while still making text within the paragraph wrap to the width of the browser window. This mode is the default.

The "save" and "open" commands can be used to save a post to disk, and open it again later.

OPTIONS
For options with both -X and +X forms, the +X option is the default behavior; they have been included so that whoever installed sclj may alter the defaults without obliterating that functionality.

-q  Quit after posting. Normally, the prompt returns with a new post. +q prevents the client from quitting.

-d <dir>
    Change the configuration directory from ~/.sclj3 to <dir>.

-t <tmpdir>
    Change the temporary directory to <tmpdir>. Normally, the temporary directory is the same as the hidden directory.

-e <editor>
    Use <editor> for editing posts.

-w <columns>
    Format long messages to be <columns> columns wide.

-p <proxy>:<port>
    Use port number <port> on the host named <proxy> as an HTTP proxy.

ENVIRONMENT

VISUAL, EDITOR
    The first of these found is used as the default editor in favor of "emacs".

TMPDIR, TEMPDIR, TEMP
    The first of these found is used as the temporary directory when running in rc-less mode and the -t option is not given. If none are found, sclj falls back on a built-in list of directories.

HOME
    If the -d option is not given, sclj will look for its configuration files in the $HOME/.sclj3 directory.

BUGS
Certain exotic configurations of friend group names can't be autocompleted properly, and must be selected from the custom security menu.

No lineendings field is sent. This means that this client will definitely break on a Mac.

sclj doesn't support Unicode or locale at all.

Bug reports should be posted to SourceForge <http://sourceforge.net/projects/sclj/> or LiveJournal <http://www.livejournal.com/community/sclj/>; failing that, email me at <mailto:loonxtall@hotmail.com> with "sclj" in the subject.

SEE ALSO
scljconv(1), scljed(1)

LICENSE
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program, in a file named "LICENSE"; if not, write to:

Free Software Foundation, Inc.
59 Temple Place, Suite 330
Boston, MA 02111-1307 USA

AUTHOR
Code and documentation by C. A. Daelhousen <loonxtall@hotmail.com>. Based on the public-domain Perl client by Brad Fitzpatrick. Currently, the only code recognizably from Brad's client is the networking code (SCLJ::Net).