Content-type: text/html Manpage of GJOTS

GJOTS

Section: User Commands (1)
Index Return to Main Contents

NAME

gjots - A gnome/X11 jotter

SYNOPSIS

gjots [options] gjotsfile

DESCRIPTION

gjots gjots is a fairly simple but very lightweight (fast) jotter application for your desktop. It displays your data organised in a tree with each leaf being your text.

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

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

Sensitive data can be held in gjots by saving as a .cpt file which gjots will save in an encrypted form under your password. gjots uses ccrypt(1) to encrypt/decrypt so make sure it's installed if you want to use the encryption feature.

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.

An external editor (configured in Settings->Preferences) with default xterm -e vi %s can be invoked by pressing the Ext.Ed button. gjots is suspended while the editing is carried on.

File locking is implemented by a lockfile 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

gjots understands the standard gnome options which can be seen with --help.

--help: Prints the standard gnome help items.
-g, --geometry WIDTHxHEIGHT[+X+Y]: Initial window geometry for gjots. Note that the X and Y components are presently ignored.
-p, --prefs filename: Use filename as the preferences file for gjots instead of the default ($HOME/.gjotsrc). With this option a separate preferences profile can be kept for each file.
-r, --readonly: Opens the gjotsfile in readonly mode (with no locking and no ability to write)

FILES

$HOME/.gjotsrc: Preferences are saved here
$HOME/.gjotsfile: The default data file
`dirname filename`/.#`basename filename`: The lock file for the file called filename.
.gjotsfile: the default file for storing your jottings
.gjotsrc: preference settings for gjots

FILE FORMAT

gjots uses the same format as kjots but with the addition of a hierarchy of items. 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.

This document was created by man2html, using the manual pages.
Time: 08:09:30 GMT, February 18, 2023