| # Licensed to the Apache Software Foundation (ASF) under one or more |
| # contributor license agreements. See the NOTICE file distributed with |
| # this work for additional information regarding copyright ownership. |
| # The ASF licenses this file to You under the Apache License, Version 2.0 |
| # (the "License"); you may not use this file except in compliance with |
| # the License. You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| |
| =head1 NAME |
| |
| Lucy::Docs::Cookbook - Apache Lucy recipes. |
| |
| =head1 DESCRIPTION |
| |
| The Cookbook provides thematic documentation covering some of Apache Lucy's |
| more sophisticated features. For a step-by-step introduction to Lucy, |
| see L<Lucy::Docs::Tutorial>. |
| |
| =head2 Chapters |
| |
| =over |
| |
| =item * |
| |
| L<Lucy::Docs::Cookbook::FastUpdates> - While index updates are fast on |
| average, worst-case update performance may be significantly slower. To make |
| index updates consistently quick, we must manually intervene to control the |
| process of index segment consolidation. |
| |
| =item * |
| |
| L<Lucy::Docs::Cookbook::CustomQuery> - Explore Lucy's support for |
| custom query types by creating a "PrefixQuery" class to handle trailing |
| wildcards. |
| |
| =item * |
| |
| L<Lucy::Docs::Cookbook::CustomQueryParser> - Define your own custom |
| search query syntax using Lucy::Search::QueryParser and |
| L<Parse::RecDescent>. |
| |
| =back |
| |
| =head2 Materials |
| |
| Some of the recipes in the Cookbook reference the completed |
| L<Tutorial|Lucy::Docs::Tutorial> application. These materials can be |
| found in the C<sample> directory at the root of the Lucy distribution: |
| |
| sample/indexer.pl # indexing app |
| sample/search.cgi # search app |
| sample/us_constitution # corpus |
| |
| |