Manual Reference Pages - FAQ::OMATIC::API (3)

CONTENTS

FAQ::OMatic::API is a class that makes HTTP requests to a FAQ-O-Matic.
It provides a way to manipulate a FAQ-O-Matic from Perl code. Operations
are performed by making HTTP requests on the FAQ-O-Matic server;
this ensures that any operation is performed in exactly the same environment
as it would be if it were requested by a human using a web browser.

fuzzyMatch() attempts to figure out which category the last string
in its array argument represents. The category name is matched fuzzily
against existing categories. If a unique match is found, it is returned
(as an array ref [$filename, $parent, $title]). If the match is
ambiguous, the previous array element is matched against the parents
of the set of fuzzy matches. This is performed recursively until the
child category is disambiguated.

Fuzzy matching means that

(a)

You dont have to get the parent category
names right if theyre not needed to disambiguate the child category.

(b)

Category names are matched without respect to case, spacing, or punctuation:
only alphanumerics matter. Also, the name you supply only has to appear
somewhere inside the one you want to match. (Exact matches are preferred;
this allows you to match categories whose names are prefixes of other
category names.)