From 80251ed8edd92c389a3d83d52ddd53d0e2cc6e61 Mon Sep 17 00:00:00 2001 From: "Ronald S. Bultje" Date: Wed, 6 Jul 2005 12:24:50 +0000 Subject: [PATCH] docs/pwg/: Remove never-written filter-factory chapter; I'll add the various base classes to part 4 ("other element t... Original commit message from CVS: * docs/pwg/building-filterfactory.xml: * docs/pwg/pwg.xml: Remove never-written filter-factory chapter; I'll add the various base classes to part 4 ("other element types") later on. --- ChangeLog | 7 +++++++ docs/pwg/building-filterfactory.xml | 24 ------------------------ docs/pwg/pwg.xml | 2 -- 3 files changed, 7 insertions(+), 26 deletions(-) delete mode 100644 docs/pwg/building-filterfactory.xml diff --git a/ChangeLog b/ChangeLog index 037b3752ff..0ca23870af 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2005-07-06 Ronald S. Bultje + + * docs/pwg/building-filterfactory.xml: + * docs/pwg/pwg.xml: + Remove never-written filter-factory chapter; I'll add the various + base classes to part 4 ("other element types") later on. + 2005-07-06 Ronald S. Bultje * docs/pwg/advanced-negotiation.xml: diff --git a/docs/pwg/building-filterfactory.xml b/docs/pwg/building-filterfactory.xml deleted file mode 100644 index a5a8997e27..0000000000 --- a/docs/pwg/building-filterfactory.xml +++ /dev/null @@ -1,24 +0,0 @@ - - Creating a Filter with a Filter Factory - - A plan for the future is to create a FilterFactory, to make the process of making a new filter a simple process of specifying a few details, and - writing a small amount of code to perform the actual data processing. - Ideally, a FilterFactory would perform the tasks of boilerplate creation, - code functionality implementation, and filter registration. - - - Unfortunately, this has not yet been implemented. Even when someone - eventually does write a FilterFactory, this element will not be able to - cover all the possibilities available for filter writing. Thus, some - plugins will always need to be manually coded and registered. - - - Here is a rough outline of what is planned: You run the FilterFactory and - give the factory a list of appropriate function pointers and data - structures to define a filter. With a reasonable measure of preprocessor - magic, you just need to provide a name for the filter and definitions of - the functions and data structures desired. Then you call a macro from - within plugin_init() that registers the new filter. All the fluff that - goes into the definition of a filter is thus be hidden from view. - - diff --git a/docs/pwg/pwg.xml b/docs/pwg/pwg.xml index 4ddab482a7..06d5a06f5a 100644 --- a/docs/pwg/pwg.xml +++ b/docs/pwg/pwg.xml @@ -19,7 +19,6 @@ - @@ -119,7 +118,6 @@ &BUILDING_PROPS; &BUILDING_SIGNALS; &BUILDING_TESTAPP; - &BUILDING_FILTERFACT;