Jane 0.3
========

What is Jane?
--------------
Jane stores your thoughts and ideas as notes to yourself.

Why is it called Jane?
----------------------
Because Jane is Another Note Editor?

What can it do, in its present form?
------------------------------------
If you are in the habit of keeping notes, or a diary, or a journal of
your activities, Jane can keep them organised and accessible.

That's nice, but does it ever do anything useful?
-------------------------------------------------
If it does, it does it when I'm not looking. Besides, if it did, do you think
I would be giving it away free?

While there is no guarantee that it will do anything useful, or anything at all,
there is every probability of the version number increasing in the future as
and when I get the time to add more features (especially if anyone asks).

Availability
------------
Jane is available as source code to compile on your own machine.

Changes in version 0.3
----------------------
Ported to Qt 6.
Added Ctrl-Q as a shortcut to quit the program.
Debugged irregular behavior of font size changes in the editor.
Added code to resize the window showing the note titles.
Some fixes to user-interface behavior.
A warning now pops-up when a second instance of Jane is opened without closing the first.
Added warnings if the notes could not be saved for any reason.
A language preference for the spell checking was added.
Added a word count to right side of the status bar.

Changes in version 0.2
----------------------
Added spellcheck functionality. Wrongly spelled words are underlined and can be corrected
through a right click, and selecting the correct word from the pop-up that appears.

Changes in version 0.1
----------------------
Initial release.

Compiling the source
--------------------
All the source files are available on Github under the following link:
https://github.com/letapk/jane

The repository is public. Anyone can check out the branch onto her local machine.

To compile, you will need the libraries and developement files from Qt, which are
available from the depository of your Linux distribution or from www.qt.io.

You will also need the spellcheck library for Qt (libqtspell-qt6) which should be available
from the package manager of your Linux distribution. The header files required for compilation,
"QtSpellExport.hpp" and "QtSpell.hpp" are part of the QtSpell package by Sandro Mani from Github at:
https://github.com/manisandro/qtspell
These are made available under the GNU General Public License version 3.0.
Many thanks, Sandro, for the extremely useful utility.

Since the spellcheck code requires the enchant spell-checking library, that will have to be
installed as well. This should be available through your package manager.

If you are using QtCreator, load the project file jane.pro which is available in the source
package. Select the version you want to build (debug version or release version) and hit
Ctrl-B.

If you prefer to work from the command line, create a Makefile by running qmake (or qmake6)
on jane.pro, then rune make:
>   qmake6 jane.pro
>   make

If there are no problems, either of the two approaches should build the binary.
The program has been compiled and tested on version 6.11 of Qt6, under Suse Tumbleweed.

The binary may be stored locally in a directory separate from the source subdirectory,
depending on how QtCreator is configured. This location will be available within QtCreator.

When the program is executed, Jane searches for a hidden subdirectory called
“.jane”. If this is absent (which will be the case when it is executed the first
time) it issues a notification that it will be created.

Subsequently all data is stored in this subdirectory in a file named "Notes.jane".
You should make backups of this file to recover from data loss or just as a
precaution.

Exit the program and copy the help and image files in the downloaded package to the
hidden data subdirectory. Either use a file manager or open a terminal and do the
following from within the Jane subdirectory:

cp janehelp.* ~/.jane
cp COPYING ~/.jane

Remember to put the dot (".") in the right place. This will make the on-line help
available when the program is running.

What is the copying policy?
---------------------------
While Jane is copyright, (C) 2024 onwards, Kartik Patel  the program is also 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
will receive a copy of the GNU General Public License along with this program;
for more information, write to the Free Software  oundation, Inc., 675 Mass
Ave, Cambridge, MA 02139, USA.

What else?
----------
That covers it, more or less. Email me if there is anything left out, or there are
problems in installation.

Enjoy!

Kartik Patel
letapk@gmail.com
https://letapk.wordpress.com