========================================
                                 jlj 2.1

                             2002 Jan 18

                         jsl@absynth.com
        http://jerronimo.livejournal.com



----------------------------------------
                      Getting it running
----------------------------------------

You should be able to configure it as below, then just type 'jlj.pl'.
You might have to change the path to your "perl" executable in the
first line of jlj.pl, and as well you might want to change the name
of 'jlj.pl' to 'jlj' for ease of use.

If you want to do the check friends option, type 'jlj.pl -c'.  It will
respond with two lines, if all was successful.  ie:

        new=0
        interval=45

new: 0 if there was no new posts in your friends list since you last checked
     1 if there was a post in your friends list

interval:  The number of seconds that the server requests that you wait
            before you check your friends again.
            NOTE: the server may get unhappy with you if you check more
            often than this amount of time.


To use it in 'offline mode', type 'jlj.pl -o'.  This will not
attempt to connect to the server at all, but still will let you
queue up messages to be posted, as well as postponing messages for
completion later.  You will also be able to edit postponed messages
as well.

If you just type 'jlj.pl', it will attempt to log into the server. 

When it is run, you will be given a prompt similar to this:

    [new]/offline/list/<number>?

The selection in brackets, "new" in this case, is the default
selection.  If you just hit return, this is the action that will
be taken.  All of the prompts are arranged such that the first
letter of every selection is different. [*]

You can simply type the first letter of the menu, or hit return if
the selection you want is the default.  I have tried to arrange
the behavior of the first menu to change based on whether you run
it with the -o option, and if there are any postponed entries to
use... So if you have no postponed entries, and you run jlj with
the "-o" option, the prompt won't display at all since there'd be
nothing to do.

When a message is postponed instead of queued or sent to the server,
It goes into a directory so that you can edit it later.  At the
above prompt, if you select 'list', it will display all of the
postponed messages' date, community or user, and subject line, with
a number next to it.  You can type the number of the message to
continue editing that entry.

The journal entries in the 'queue' folder are entries that are in
the queue to be sent to the server.  The next time that jlj is run
with the '-f' option, these will be posted to the server.

The journal entries in the 'postponed' folder are entries that have
been set aside to be edited later by you.  You can re-activate
these using the above menu/prompt.

The journal entries in the 'sent' folder are entries that have been
submitted to the journal server.

[*] This caused a slight change with the 'security' prompt.  Instead
    of selecting if a post is to be: public, private, or friends-only,
    it is now: everyone, private, or friends-only.


NOTE:  If you mangle the date line, the entry might not be submittable anymore!
NOTE:  Do not change the line labelled 'do not edit', or it might fail


----------------------------------------
                    Command Line Options
----------------------------------------

-c
	Check your friends list to see if there were new posts.

-f
	Flush the queue of pending submission entries off to the server.

-h
	Display a help message (showing these options)

-j
	Display a cheat sheet of JerryWiki escapes.
	    To enable JerryWiki, set the "formatted" line 
	    in your .livejournal.rc to have "jerry" as the 
	    first item in the list, rather than "preformatted".

-o
	Work offline.
	    It does not attempt to contact the server at all.

-q
	Quick mode.
	    It only prompts you for subject, then bounces right
	    into the editor.  It tries to do this online.  You can
	    still postpone the message for completion later.

----------------------------------------
                   Getting it configured
----------------------------------------

Just some notes about configuring JLJ...

edit the enclosed '.livejournal.rc' file.  You will need to set your 
username and password.  There are prompts for most everything else, 
but not your username and password.

You should see something like this:

    user: yourusername
    password: yourpassword

change the text to read your correct username and password.  For example, 
if your username is "bunnyfoobar", and your password is "ilikecheese", then
those two lines should read:

    user: bunnyfoobar
    password: ilikecheese

The rest of the things in that file are fairly self explanatory, but i'll
briefly cover them here just in case. ;)

First of all, you may notice that there are multiple items on each of 
the lines.  JLJ only looks at the first item on each of the lines.  so if
you were to see:

    blah:  yes no

then the setting for 'blah' would be 'yes'.

Be sure to copy the .livejournal.rc file into your home directory, and make
it only readable by you.  ie: 
	chmod 600 .livejournal.rc
	mv .livejournal.rc ~

(assuming you're on a unix system)

--------------------------------------------------------------------------------
Thanks: 
	Adam T. Lindsay <atl@comp.lancs.ac.uk>  -  proxy code
	David Lindes <lindes@daveltd.com>       -  error code ideas
	Alexey Bestciokov <proforg@idbh.ru>     -  Russian language support
--------------------------------------------------------------------------------



----------------------------------------
                      Configuration File
----------------------------------------

user: username

    your username for livejournal


password: password

    your password for livejournal


editor:

    This is the full path to a text editor to use.  You should be 
    able to use anything like 'vi', 'emacs', 'pico', 'nedit' etc.
    Whichever you are comfortable with.  Mine is set to "usr/ucb/vi"


editor offset:

    To make editing easier, we'd like it to start us with the cursor
    at the bottom of the generated file.  This means that we want
    the cursor to be on line 12.  Most editors ('vi', 'emacs',
    'pico', and 'nedit' for example) allow for a command line option
    to set the start point of the cursor in the file.  For those
    just mentioned, it is "+<line number>", so the default value
    for this is "+12".  If your text editor does not support this,
    either delete the line, or set it to the appropriate option
    for your editor.


base dir: %s/.jlj

    where all of the files will be stored.  %s gets replaced with
    $HOME assuming it's set in your shell. (It usually is.)  In
    the above example, it'll save aside your entries in the ~/.jlj
    directory.  This should be an explicit pathname, not a relative
    path.  I have no idea what'll happen if it's a relative path.


security: public private friends prompt

    What 'security level' to use.  'public' 'private' and 'friends'
    will always post under those security levels.  'prompt' will
    ask you every time you run JLJ.  Generally you're probably
    going to want 'public'.  NOTE: 'friends' will be visible to
    _all_ of your friends, rather than to a specific friend group.


format: preformatted none

    If this is set to 'preformatted', the server will assume you've
    formatted the text yourself, and will do nothing.  If it is
    set to 'none', it will add line breaks at the end of every
    line. (Since you're probably going to be sticking with a certian
    style of posts, there's no reason to prompt you about this, so
    we set it once, and are done with it.)  If you set it to "none",
    then the Mongolian Crack Monkeys will take your post, put <br>'s
    at the end of each line, and do all sorts of other nasty
    automatic HTML code.  You probably will want it set to
    "preformatted"


mood prompt: yes no

    Ask what mood you're in.  This gets cross referenced with the 
    known moods when your entry is posted to the server.  If you type
    a standard mood like "happy", it will get a cute little icon next
    to it.  If you type a non-standard mood like "diagonal", it will
    just submit it as text, and you will get no cute little icon.


music prompt: yes no

    Ask what music you're listening to.


picture prompt: yes no

    Display a list of your pictures, and ask for which you want.
    For best results, put in descriptive keywords for your pictures
    so that you know which is which when you are given this list.


community prompt: yes no

    Display a list of communities and journals you can post to,
    and ask for which to post to.


proxy: no yes
    
    Set to yes if you're using a proxy for web connections.


proxy host: yourproxy.dom.tld

    Set it to the address of the web proxy server.


proxy port: 80

    which port on the proxy server is used.

