cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: xml-cocoon2/src/documentation/xdocs/userdocs/selectors selectors.xml
Date Thu, 30 May 2002 17:44:16 GMT
shannon     02/05/30 10:44:16

  Modified:    src/documentation/xdocs/userdocs/selectors selectors.xml
  Tightened and clarified the language.
  Simplified sentence structure.
  Revision  Changes    Path
  1.2       +35 -31    xml-cocoon2/src/documentation/xdocs/userdocs/selectors/selectors.xml
  Index: selectors.xml
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/selectors/selectors.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- selectors.xml	3 Jan 2002 12:31:05 -0000	1.1
  +++ selectors.xml	30 May 2002 17:44:16 -0000	1.2
  @@ -9,15 +9,16 @@
   			<person name="Carsten Ziegeler" email=""/>
   			<person name="Gianugo Rabellino" email=""/>
  +			<person name="Diana Shannon, ed." email=""/>
  -		 <abstract>This document describes all available selectors of Cocoon.</abstract>
  +		 <abstract>This document describes all of the available selectors of Cocoon.</abstract>
   		<s1 title="Goal">
  -      This document lists all available selectors of Apache Cocoon and
  +      This document lists all of the available selectors of Apache Cocoon and
         describes their purpose.
  -      See also the concepts document
  +      You may also wish to read  
         <link href="../concepts/matchers_selectors.html">Using and Implementing
         Matchers and Selectors</link>.
  @@ -25,29 +26,32 @@
   		 <s1 title="Overview">
         Selectors in Apache Cocoon have a role similar to matchers 
  -      while being more flexible. Like matchers they are designed
  -      to test something against a part of the environment (the
  -      request URI, headers, cookies and so on), but unlike matchers
  -      they can be active decision driving components.
  -      A matcher allows only for simple 
  -      "yes/no" decisions: the match can be succesful or not, if it
  -      is the pipeline is executed, if not it's simply ignored. 
  -      Selectors go a step further allowing for more complex
  -      use cases, where there is need for a decision to be
  -      made according to a multiple chance scenario. In short you can 
  -      think of matchers as an "if" statement, while selectors have all
  -      the power of an "if-else if-else" or "switch-case" construct.
  -      The selector syntax is similar will be familiar to people
  -      using the XSLT <code>&lt;xsl:test&gt;</code> statement.
  +      with additional flexibility. If you haven't learned about
  +      matchers yet, read about them <link href="../matchers/matchers.html">here</link>
  +      before continuing. Selectors are designed to evaluate a 
  +      generally simple boolean expression regarding some
  +      part of the environment (request URI, headers, or cookies, for example). 
  +      The result of this evaluation determines which pipeline fragments 
  +      should be combined within a given pipeline. Unlike matchers, 
  +      selectors can be active decision-driving components.
  +      For example, a matcher makes only simple 
  +      &quot;yes/no&quot; decisions. If a match is successful, a 
  +      pipeline is executed. If not, it is ignored. 
  +      Selectors go further by allowing more complex, multiple-choice
  +      use cases. In short, consider matchers to be simple &quot;if&quot; 
  +      statements. By extension, consider selectors to have all
  +      the power of an &quot;if-else if-else&quot; or &quot;switch-case&quot;
  +      The selector syntax should be familiar to anyone who
  +      uses XSLT's <code>&lt;xsl:test&gt;</code> statement.
  -      As an example consider the typical scenario where a page has to
  -      be rendered in different way according to the browser being 
  -      used. There are plenty of browsers out there so expressing this
  -      need as a set of matchers might become ankward and counterintuitive. 
  -      Using the BrowserSelector, which checks a given pattern
  -      against the user-agent header, it's easy to deploy a consistent 
  -      and readable setup:
  +      As an example, consider the typical scenario in which a page should
  +      be rendered differently based on the client browser. 
  +      Given the large number and diversity of available browsers, 
  +      it would be awkward and counterintuitive to address this need
  +      with a set of matchers. The BrowserSelector tests a given parameter
  +      against the user-agent request header. Using this single selector, 
  +      we can deploy a consistent and readable setup.
  @@ -77,21 +81,21 @@
   		 <s1 title="The Selectors in Cocoon">
  -      These are the available Selectors in Cocoon:
  +      Available Selectors in Cocoon include the following:
  -				<li><strong>BrowserSelector</strong>: matches the value of the "test"
  -        parameter against the HTTP User-Agent header, allowing to 
  -        recognize the browser being used;</li>
  +				<li><strong>BrowserSelector</strong>: matches the value of the &quot;test&quot;
  +        parameter against the HTTP User-Agent header, allowing it to 
  +        recognize the browser issuing the request;</li>
   				<li><strong>CodeSelector</strong>: matches a snippet of Java code
  -        given as the "test" parameter against the environment;</li>
  +        given as the &quot;test&quot; parameter against the environment;</li>
  -				<li><strong>HostSelector</strong>: matches the "test" parameter value
  +				<li><strong>HostSelector</strong>: matches the &quot;test&quot;
parameter value
           against the Host request header</li>
   				<li><strong>ParameterSelector</strong>: matches the string specified
  -        in the "test" parameter against a specified Cocoon internal
  +        in the &quot;test&quot; parameter against a specified Cocoon internal
           (e.g. sitemap) parameter;</li>
   				<li><strong>HeaderSelector</strong>: same as the Parameter selector,

In case of troubles, e-mail:
To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message