1. Chapter 1 Getting Started

   1. Installing Ferret

   2. A Quick Example: Indexing the Filesystem

   3. Summary

2. Chapter 2 Indexing

   1. Index Storage

   2. Documents, Fields, and Boosts

   3. Setting Up the Index

   4. Basic Indexing Operations

   5. Indexing Non-String Datatypes

   6. Summary

3. Chapter 3 Advanced Indexing

   1. How the Indexing Process Works

   2. Tuning Indexing Performance

   3. Optimizing the Index

   4. Index Locking and Concurrency Issues

   5. Summary

4. Chapter 4 Search

   1. Overview of Searching Classes

   2. Building Queries

   3. QueryParser

   4. Filtering Search Results

   5. Sorting Search Results

   6. Highlighting Query Results

   7. Summary

5. Chapter 5 Analysis

   1. Token

   2. TokenStream

   3. Analyzer

   4. Custom Analysis

6. Chapter 6 Ferret in Practice

   1. Indexing Multiple Document Types

   2. Other Indexing Improvements

   3. Search Improvements

   4. Putting It All Together

   5. Summary

1. Colophon

The animal on the cover of Ferret is a ferret. The scientific name for the domestic ferret is Mustela putorius furo, or "weasel-like smelly thief." These slender, carnivorous mammals are about 20 inches long-including a 5-inch tail-weigh 2-4 pounds, and live for 7-10 years. Common colors include albino, chocolate, butterscotch, silver, and cinnamon. The domestic ferret is sometimes confused with the wild black-footed ferret (Mustela nigripes), an endangered North American mammal related to the Russian polecat. Male ferrets are called hobs, female ferrets are jills, and young ferrets are kits. A group of ferrets is a business.

Ferrets were first bred 2,500 years ago in Africa for hunting rabbits. Today they are more often kept as pets, and are now the third most popular pet in the United States after cats and dogs. Ferrets are intelligent and playful; they can recognize their names and learn simple tricks. They have a habit of stealing household objects and hiding them-socks, keys, books, umbrellas, T.V. remotes, even fish out of bowls. When ferrets are excited and want to play, they bounce and flop around in a routine known as a "weasel war dance." They may also hiss and arch their backs. Ferrets in war dances tend to be clumsy, often hopping into things or tripping on their own feet.

Some parts of the world restrict the keeping of ferrets. A ferret-free zone, or FFZ, is a place where ferrets are banned or illegal. Three reasons are often cited for a ban: ferrets may bite or scratch children; there is no proven rabies vaccine for ferrets; and ferrets may threaten native wildlife. However, these points are often disputed. Former mayor of New York City Rudy Giuliani infamously clashed with ferret lovers in 2001, when the city council considered dropping the ban on ferrets and Giuliani opposed it, railing against ferrets as "wild animals." Still, many regions are being persuaded to change their anti-ferret laws, and the only U.S. states that now ban ferrets are California and Hawaii.

The cover image is from the Dover Pictorial Archive. The cover font is Adobe's ITC Garamond. The text font is Linotype Birka, the heading font is Adobe Myriad Condensed, and the code font is LucasFont's TheSans Mono Condensed.