Basic Information
---------------------------

Jaffis is a Graphical program that serves as a search and download tool for Fanfiction.Net, Fimfiction.net, and Archiveofourown.org, with a few other additions. This program was developed as a personal tool that I am releasing in case somebody else might find it useful.

I make no claims as to the elegance or usefulness of the program. If you wish to report bugs, you can do so, but do not ncessarily expect them to be fixed (or even expect a response). For more detailed information on the use of this prgrams, looks in the 'Docs' folder.

This program uses wxWidgets (www.wxwidgets.org), so i've included the wxWindows license (licence3.txt) in the archive. More recently (Nov 2013), Fanfiction.Net switched to using SSL for everything, so I'm using libcurl (curl.haxx.se) for downloading, the license is in license_liburl.txt.

Installation
----------------

No fancy installer is provided. You basically run the executable from the folder where you unpack the contants of the archive. That means that you have to copy or move a binary executable (from the 'binaries' folders) to the directory mentioned above, and run it from there. 

Currently, 6 binaries are provided:
 - winnt : Should work on any modern version of Windows NT. I've tested it on Windows 2000 (x86), Windows XP (x86), Windows 7 (x64), and Windows 10. It will not work on anything older than Windows 2000.
 - osx : A 32 bit OS X program, which is a 'Universal Binary', should work on 10.4 (Tiger) or newer, PPC or Intel. Note that for 10.8 (Mountain Lion) and later, you will need to disable Gatekeeper when you first run the program.

Linux Versions: Needs GTK+ 2 and presumably the usual sort of stuff one would expect a simple GTK GUI program would need. There is no need to install wxwidgets.
- lin_amd64 : A Linux executable for x64/AMD64 versions of Linux. Tested on Ubuntu and Fedora.
- lin_i686  : A Linux executable for i686 (32 bit) versions of Linux. Tested on Ubuntu.
- lin_ppc32 : A Linux executable for 32 bit PowerPC versions of Linux. Built and tested on Xubuntu on a MacMini. 
- lin_ppc64 : A Linux executable for 64 bit PowerPC versions of Linux. Built and tested on a PowerMac G5 (Ubuntu).


Files the Program Uses
-------------------------------
gfilt.dat 	  : Where the programs stores global filters.
globalvals.dat    : Where the program stores some settings, such as the result directories.
html_entities.dat : Information on HTML used to help convert HTML into plain text.
htmlskel.dat 	  : Stores HTML Result Skeleton Data.

ffnscat.dat	  : Stores information on categories and crossover categories at Fanfiction.Net. Since this should be updated on a regular basic, the archive does not (always) contain this file: You have to use Jaffis to get the category data for the first time before doing any searches.

ao3mmcat.dat	  : Used to store category/section info for achiveofourown.org

trace0.txt	  : Logfile if you have logging turned on. This is meant as a debugging aid, so feel free to delete the file after you have ended the program.

jaffis_01.png	  : PNG Icon for Linux.

