NAME

       Lucy::Docs::DevGuide - Quick-start guide to hacking on Apache Lucy.

DESCRIPTION

       The Apache Lucy code base is organized into roughly four layers:

          * Charmonizer - compiler and OS configuration probing.
          * Clownfish - header files.
          * C - implementation files.
          * Host - binding language.

       Charmonizer is a configuration prober which writes a single header file, "charmony.h", describing the
       build environment and facilitating cross-platform development.  It's similar to Autoconf or Metaconfig,
       but written in pure C.

       The ".cfh" files within the Lucy core are Clownfish header files.  Clownfish is a purpose-built,
       declaration-only language which superimposes a single-inheritance object model on top of C which is
       specifically designed to co-exist happily with variety of "host" languages and to allow limited run-time
       dynamic subclassing.  For more information see the Clownfish docs, but if there's one thing you should
       know about Clownfish OO before you start hacking, it's that method calls are differentiated from
       functions by capitalization:

           Indexer_Add_Doc   <-- Method, typically uses dynamic dispatch.
           Indexer_add_doc   <-- Function, always a direct invocation.

       The C files within the Lucy core are where most of Lucy's low-level functionality lies.  They implement
       the interface defined by the Clownfish header files.

       The C core is intentionally left incomplete, however; to be usable, it must be bound to a "host"
       language.  (In this context, even C is considered a "host" which must implement the missing pieces and be
       "bound" to the core.)  Some of the binding code is autogenerated by Clownfish on a spec customized for
       each language.  Other pieces are hand-coded in either C (using the host's C API) or the host language
       itself.

perl v5.22.1                                       2015-12-18                          Lucy::Docs::DevGuide(3pm)