view release on metacpan or  search on metacpan

src/judy-1.0.5/README  view on Meta::CPAN

	     Judy - C library creating and accessing dynamic arrays
	 ==============================================================

Content
---------

 1. Introduction
 2. Directory Contents
 3. How to install
 4. License
 5. Change History
 6. Reporting Bugs
 7. Known Issues


1. INTRODUCTION
-----------------

This tree contains sources, documents, tests, and tools for the Judy package.
This file is in a form that can be validated using the tool/readme script.

NOTE:  The README files here describe some files that are not included in
every Judy source package.

WHAT IS JUDY?  (see below for list of top-level directories and files)

Judy is a C library that implements a dynamic array.  Empty Judy arrays are
declared with null pointers.  A Judy array consumes memory only when
populated yet can grow to take advantage of all available memory.  Judy's key
benefits are:  scalability, performance, memory efficiency, and ease of use.
Judy arrays are designed to grow without tuning into the peta-element range,
scaling near O(log-base-256) -- 1 more RAM access at 256 X population.

Judy arrays are accessed with insert, retrieve, and delete calls for number
or string indexes.  Configuration and tuning are not required -- in fact not
possible.  Judy offers sorting, counting, and neighbor/empty searching.
Indexes can be sequential, clustered, periodic, or random -- it doesn't
matter to the algorithm.  Judy arrays can be arranged hierarchically to
handle any bit patterns -- large indexes, sets of keys, etc.

Judy is often an improvement over common data structures such as:  arrays,
sparse arrays, hash tables, B-trees, binary trees, linear lists, skiplists,
other sort and search algorithms, and counting functions.


2. JUDY TOP DIRECTORY CONTENTS:
--------------------------------

AUTHORS		Judy authors and contributors
README		This file.
INSTALL		Summary  instructions to build, check and install Judy.
COPYING		Judy deliverable license notice (the LGPL).
ChangeLog	List of changes per version of Judy.

configure	Autoconf configure script to allow a portable build e
                environment. 
		
src/		Header and source files used to build the package.
doc/		Documents, both external (to the package) and internal.
test/		Test support and some timing programs.
tool/		Primitive tool (jhton) to convert *.html files to "man" pages.
                and build tables used by Judy to malloc() sizes of memory.

3. HOW TO INSTALL
-----------------

For a quick description see the INSTALL file. 

Judy is now based on the GNU Auto tools. This means that you can do the standard
configure, make, make check and make install and everything should work, with
one minor difference and a little caveat. 

Judy is capable of being built as a 32-bit or a 64-bit library. Configure
will test to detect the native environment and default to that. Therefor if you
explicitly want to to compile for the non-native environment you need to tell
Judy what you want. You can run ./configure with one of the following flags:
          
	  --enable-32-bit 
          --enable-64-bit