Man Linux: Main Page and Category List

NAME

       gjots2 - A gnome-2/X11 jotter

SYNOPSIS

       gjots2 [options] gjotsfile

DESCRIPTION

       gjots2  is  a  fairly  simple  jotter  application for your desktop. It
       displays your data organised in a tree with each leaf being your  text.

       Getting  data  into gjots2 is fairly easy - you can type it in, cut and
       paste text or use an editor to convert other text files to  the  simple
       gjots2 format (see below for details). You can also convert an existing
       DOCBOOK file into gjots2 format with docbook2gjots(1).

       gjots2 files can be simply converted into HTML using  gjots2html(1)  or
       into DOCBOOK with gjots2docbook(1)

       Sensitive  data  can  be  encrypted  by ccrypt(1), openssl(1) or gpg(1)
       simply by saving with  an  appropriate  file  suffix  and  providing  a
       password:

              ccrypt     .cpt

              openssl    .ssl

              gpg        .gpg

       Don’t  forget  your  passwords.  Obviously,  the appropriate encryption
       utility must have been installed.

       Simple  text  formatting  is  provided  with  the  usual  cut  &  paste
       operations  and  paragraph  formatting (line wrapping) according to the
       line length set  in  Settings->Preferences.   Lines  are  formatted  by
       pressing  the Wrap button or ^L. This requires the fmt(1) command which
       is in the sys-apps/textutils pacakge (on Gentoo).

       An external editor (configured in Settings->Preferences) can be invoked
       by  pressing  the Ext.Ed button.  gjots2 is suspended while the editing
       is carried on.

       File locking is implemented by a  lockfile  (.#filename)  in  the  same
       directory  as  the  file being edited. Multiple users can open the file
       readonly but only one user can open the file  for  writing.  Since  the
       locking  is  done  with  a  lockfile  even  NFS-mounted  files  can  be
       protected.

OPTIONS

       --help Prints help.

       -g, --geometry WIDTHxHEIGHT[+X+Y]
              Initial window geometry for gjots2.   Note  that  the  X  and  Y
              components are presently ignored.

       -p, --purge-password
              When opening an encrypted file, gjots now remembers the password
              for subsequent writes. To restore the old behaviour where  gjots
              purged the password, use this option.

       -r, --readonly
              Opens  the  gjotsfile  in  readonly mode (with no locking and no
              ability to write)

       -d, --debug
              Produces  a  trace  of  program  execution  possiby  useful   in
              debugging

       -V, --version
              Print the version and quit

FILES

       $HOME/.gjotsfile The default data file

       ‘dirname filename/.#basename filename‘
              The lock file for the file called filename.

FILE FORMAT

       gjots2  uses a simple text file format with the addition of a hierarchy
       of items introduced by keywords. The keywords need to be at  the  start
       of line to be recognised. Only 3 keywords are presently used:

       \NewEntry      Starts a new entry

       \NewFolder     Promotes the current item to a folder

       \EndFolder     Ends a folder

       The first line in every entry is used as the ’title’ for the tree.

       In a future release the \Option keyword may be added.

EXAMPLE

       \NewEntry
       title1
       this is the stuff that goes into title1

       \NewFolder
       \NewEntry
       title3
       title 3’s stuff

       \EndFolder

AUTHOR

       Written by Bob Hepple <bhepple@freeshell.org>

       http://bhepple.freeshell.org/gjots

COPYRIGHT

       Copyright (c) 2002 Robert Hepple
       This  is free software; see the source for copying conditions. There is
       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
       PURPOSE.

SEE ALSO

       gjots2html(1), gjots2docbook(1), docbook2gjots(1).

       Also, see the gjots2(1) README, probably as something like:

              gjots /usr/share/doc/gjots-0.8/gjots2.gjots

       or

              netscape /usr/share/doc/gjots-0.8/gjot.html