Fix two bugs with caching of customized raw definitions.
[htmlpurifier.git] / docs / proposal-config.txt
blob4e031c5866b7a48ad1993cb5cc7f2e808cea64c6
2 Configuration
4 Configuration is documented on a per-use case: if a class uses a certain
5 value from the configuration object, it has to define its name and what the
6 value is used for.  This means decentralized configuration declarations that
7 are nevertheless error checking and a centralized configuration object.
9 Directives are divided into namespaces, indicating the major portion of
10 functionality they cover (although there may be overlaps).  Please consult
11 the documentation in ConfigDef for more information on these namespaces.
13 Since configuration is dependant on context, internal classes require a
14 configuration object to be passed as a parameter.  (They also require a
15 Context object). A majority of classes do not need the config object,
16 but for those who do, it is a lifesaver.
18 Definition objects are complex datatypes influenced by their respective
19 directive namespaces (HTMLDefinition with HTML and CSSDefinition with CSS).
20 If any of these directives is updated, HTML Purifier forces the definition
21 to be regenerated.
23     vim: et sw=4 sts=4