---
name: "gjots2"
section: "1"
platform: "linux"
package: "gjots2"
version: "3.0.2-0.1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/gjots2"
---

# gjots2(1)

A gnome-2/X11 jotter

## 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)](/docbook2gjots/1.md).

**gjots2** files can be simply converted into HTML using [**gjots2html**(1)](/gjots2html/1.md) or into DOCBOOK with [**gjots2docbook**(1)](/gjots2docbook/1.md)

Sensitive data can be encrypted by  [**ccrypt**(1)](/ccrypt/1.md), [**openssl**(1)](/openssl/1.md) or [**gpg**(1)](/gpg/1.md) 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)](/fmt/1.md) command which is in the *coreutils* package in  **fedora** and in the *sys-apps/textutils* directory 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**

  debug to stdout

- **-t**, **--trace**

  trace lines as they execute

- **-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-2011 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)](/gjots2html/1.md), [**gjots2docbook**(1)](/gjots2docbook/1.md), [**docbook2gjots**(1)](/docbook2gjots/1.md).

Also, see the [**gjots2**(1)](/gjots2/1.md) README, probably as something like:

```
gjots /usr/share/doc/gjots/gjots2.gjots
```