======================================================================
English Kabbalah
Copyright (C) 2012 Marc Sylvestre <marc.sylvestre@manhydra.com>
======================================================================

English Kabbalah is a collection of command-line applications that
perform various coding/ciphering tasks, along with searching a given
file for those results.

- English Gematria
  Outputs a gematria value for an inputted word or phrase.
  Outputs a lists of words or phrases from a given file, where
  the gematria value of each word or phrase is equal to that of the
  inputted word or phrase.

- English Temurah
  Ciphers an inputted word or phrase using four key methods:

  + Avgad: Replaces each letter with the one that comes after it
	(forward shift) or before it (backward shift) in the English
	Alphabet.

  + Atbash: Replaces the first letter of the English alphabet with the
    last letter, the second with the next-to-last, and so on.

  + Albam: Replaces the first letter of the English alphabet with the
    twelfth, the second with the thirteenth, and so on.

  + Aik Bekar: Replaces each letter of the English alphabet with the
	next found within that letter's group.

  Outputs the number of times an enciphered inputted word or phrase
  is found within a given file for each method used.

  Letters are categorized into two groups: consonants (B-Z) and
  vowels (A-Y), each in two classes: uppercase and lowercase. Thus,
  letters are replaced with those in their respective group and class.

- English Notarikon
  Outputs a list of phrases from a given file where the first letter of
  each word in a phrase is found in the inputted acronym.

- English Anagram
  Outputs a list of words or phrases from a given file(s) where each
  letter of the inputted word or phrase, and the quantity thereof,
  is found.

Subject Background
==================

Kabbalah is often defined as an esoteric discipline or school of
philosophy. Various descriptions exist, however, one of the most
overlooked aspects or practices in Kabbalah (and probably the most
fundamental) is an area known as the "Literal Kabbalah."

This area is often described as having concerns with the
relationship between letters and numbers, however, this is a very
general description of what in actually is a sophisticated
coding/ciphering system. All the methods of the Literal Kabbalah
were used in various coding/ciphering activities, most notably in
military intelligence, and espionage.

Installation
============

English Kabbalah is designed to run on POSIX-compliant systems:

	GNU/Linux
	FreeBSD, NetBSD, OpenBSD
	Mac OS X

For installation on Windows systems:

	http://www.mingw.org
	http://www.cygwin.com

For the most basic build and installation:

	./configure
	make
	make install

Library required for remote file access:

	libcurl-dev >= 7.21.0

Building with libcurl is disabled by default. To build with libcurl:

	./configure --with-curl=yes

English Kabbalah provides an interactive application (eng-qbl).
Building eng-qbl is disabled by default. To build eng-qbl:

	./configure --enable-engqbl=yes

Library required for eng-qbl:

	libreadline-dev >= 6.1

For information on installation, consult the INSTALL file.

Usages
======

English Kabbalah is a suite of command-line programs designed to
output results within a text shell. Examples of usage are provided
by consulting each program's respective manpage.