W3C home > Mailing lists > Public > www-dom@w3.org > January to March 2002

Description of whatToShow in DOMWriteFilter is unclear

From: Elliotte Rusty Harold <elharo@metalab.unc.edu>
Date: Tue, 05 Feb 2002 23:17:14 -0500
Message-ID: <3C60AE4A.4040809@metalab.unc.edu>
To: www-dom@w3.org
The description of the whatToShow attribute in DOM3 Load and Save for 
both DOMWriterFilter and DOMBuilderFilter is unclear. For example, in 
DOMWriterFilter we find the following:

whatToShow of type unsigned long, readonly
    Tells the DOMWriter
    what types of nodes to show to the filter. See NodeFilter for
    definition of the constants. The constant
    SHOW_ATTRIBUTEDOMWriterFilter. is meaningless here, attribute nodes
will never be passed to a

    For example, if I set whatToShow to NodeFilter.SHOW_ELEMENT does
    this mean that only element nodes will be output? or does it mean
    that only element nodes will be passed to the filter for further
    consideration while other kinds of nodes will be output without
    being checked through the filter? A literal reading seems to imply
    the former, but it's far from obvious. Clarification of the intent
would be appreciated.

Elliotte Rusty Harold
Received on Tuesday, 5 February 2002 23:16:59 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 20 October 2015 10:46:09 UTC