You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Christopher Oliver <re...@verizon.net> on 2004/02/01 17:22:43 UTC

Re: cvs commit: cocoon-2.1/src/documentation/xdocs/userdocs/flow sitemap.xml

Antonio, that wasn't a typo. It is supposed to indicate "one or more".

antonio@apache.org wrote:

>antonio     2004/02/01 04:03:31
>
>  Modified:    src/documentation/xdocs/userdocs/flow sitemap.xml
>  Log:
>  Fixing typo
>  
>  Revision  Changes    Path
>  1.19      +1 -1      cocoon-2.1/src/documentation/xdocs/userdocs/flow/sitemap.xml
>  
>  Index: sitemap.xml
>  ===================================================================
>  RCS file: /home/cvs//cocoon-2.1/src/documentation/xdocs/userdocs/flow/sitemap.xml,v
>  retrieving revision 1.18
>  retrieving revision 1.19
>  diff -u -r1.18 -r1.19
>  --- sitemap.xml	12 Oct 2003 13:04:48 -0000	1.18
>  +++ sitemap.xml	1 Feb 2004 12:03:31 -0000	1.19
>  @@ -17,7 +17,7 @@
>        <p>The <code>flow</code> element defines a Flowscript interpreter for a sitemap. The <code>language</code> attribute specifies the target programming language. Currently the only supported language is <code>"javascript"</code>. Its embedded <code>script</code> elements allow you to specify the files that make up the flow for this sitemap. Each <code>script</code> element specifies the URI of a script that will be compiled and executed when this Sitemap is created. The <code>src</code> attribute specifies the URI of the script.</p>
>         <source><![CDATA[
>           <map:flow language="Language">
>  -           <map:script src="URI"/>+
>  +           <map:script src="URI"/>
>           </map:flow>
>         ]]></source>
>       <p>Example:</p>
>  
>  
>  
>
>  
>


Re: cvs commit: cocoon-2.1/src/documentation/xdocs/userdocs/flowsitemap.xml

Posted by Antonio Gallardo <ag...@agssa.net>.
Christopher Oliver dijo:
> Antonio, that wasn't a typo. It is supposed to indicate "one or more".

Sorry. I understand now. The "+" was written in the sense of "lex" tokens
or "regular expressions" as grep, perl, etc. To me it was not clear, since
it is not a standard XSLT notation. Seems like I still have problem when
people is mixing languages. Sorry. :-(

Well, I will fix it back, but I think some other people (as me) can
missunderstand its meaning and think it is a typo. Since this is posible I
think we need to find another way to represent it or define a "notation".

Maybe:

<source>
  <map:flow language="Language">
    <map:script src="URI1"/>
    <map:script src="URI2"/>
    <map:script src="URI3"/>
    ...
    <map:script src="URIn"/>
  </map:flow>
</source>

or:

<source>
  <map:flow language="Language">
    <map:script src="URI"/>
    <!-- Declare more scripts here -->
    ...
  </map:flow>
</source>

To me this is clearer than a single "+" with the meaning of another language.

I will wait for an answer before make the change.

WDYT?

Best Regards,

Antonio Gallardo



>
> antonio@apache.org wrote:
>
>>antonio     2004/02/01 04:03:31
>>
>>  Modified:    src/documentation/xdocs/userdocs/flow sitemap.xml
>>  Log:
>>  Fixing typo
>>
>>  Revision  Changes    Path
>>  1.19      +1 -1
>> cocoon-2.1/src/documentation/xdocs/userdocs/flow/sitemap.xml
>>
>>  Index: sitemap.xml
>>  ===================================================================
>>  RCS file:
>> /home/cvs//cocoon-2.1/src/documentation/xdocs/userdocs/flow/sitemap.xml,v
>>  retrieving revision 1.18
>>  retrieving revision 1.19
>>  diff -u -r1.18 -r1.19
>>  --- sitemap.xml	12 Oct 2003 13:04:48 -0000	1.18
>>  +++ sitemap.xml	1 Feb 2004 12:03:31 -0000	1.19
>>  @@ -17,7 +17,7 @@
>>        <p>The <code>flow</code> element defines a Flowscript interpreter
>> for a sitemap. The <code>language</code> attribute specifies the
>> target programming language. Currently the only supported
>> language is <code>"javascript"</code>. Its embedded
>> <code>script</code> elements allow you to specify the files that
>> make up the flow for this sitemap. Each <code>script</code>
>> element specifies the URI of a script that will be compiled and
>> executed when this Sitemap is created. The <code>src</code>
>> attribute specifies the URI of the script.</p>
>>         <source><![CDATA[
>>           <map:flow language="Language">
>>  -           <map:script src="URI"/>+
>>  +           <map:script src="URI"/>
>>           </map:flow>
>>         ]]></source>
>>       <p>Example:</p>
>>
>>
>>
>>
>>
>>
>


Re: cvs commit: cocoon-2.1/src/documentation/xdocs/userdocs/flowsitemap.xml

Posted by Antonio Gallardo <ag...@agssa.net>.
Christopher Oliver dijo:
> Feel free to add it..

What we would add? :-D

Best Regards,

Antonio Gallardo
>
> Tony Collen wrote:
>
>> Antonio Gallardo wrote:
>>
>>> Christopher Oliver dijo:
>>>
>>>> Antonio, that wasn't a typo. It is supposed to indicate "one or more".
>>>
>>> Sorry. I understand now. The "+" was written in the sense of "lex"
>>> tokens
>>> or "regular expressions" as grep, perl, etc. To me it was not clear,
>>> since
>>> it is not a standard XSLT notation. Seems like I still have problem
>>> when
>>> people is mixing languages. Sorry. :-(
>>>
>>> Well, I will fix it back, but I think some other people (as me) can
>>> missunderstand its meaning and think it is a typo. Since this is
>>> posible I
>>> think we need to find another way to represent it or define a
>>> "notation".
>>
>> I think there should be a comment clearly explaining what is allowed.
>> The + is confusing and would confuse newbies even more.
>>
>> Tony


Re: cvs commit: cocoon-2.1/src/documentation/xdocs/userdocs/flowsitemap.xml

Posted by Christopher Oliver <re...@verizon.net>.
Feel free to add it..

Tony Collen wrote:

> Antonio Gallardo wrote:
>
>> Christopher Oliver dijo:
>>  
>>
>>> Antonio, that wasn't a typo. It is supposed to indicate "one or more".
>>>   
>>
>>
>> Sorry. I understand now. The "+" was written in the sense of "lex" 
>> tokens
>> or "regular expressions" as grep, perl, etc. To me it was not clear, 
>> since
>> it is not a standard XSLT notation. Seems like I still have problem when
>> people is mixing languages. Sorry. :-(
>>
>> Well, I will fix it back, but I think some other people (as me) can
>> missunderstand its meaning and think it is a typo. Since this is 
>> posible I
>> think we need to find another way to represent it or define a 
>> "notation".
>>
>>  
>>
>
> I think there should be a comment clearly explaining what is allowed.  
> The + is confusing and would confuse newbies even more.
>
> Tony
>
>


Re: cvs commit: cocoon-2.1/src/documentation/xdocs/userdocs/flowsitemap.xml

Posted by Tony Collen <co...@umn.edu>.
Antonio Gallardo wrote:

>Christopher Oliver dijo:
>  
>
>>Antonio, that wasn't a typo. It is supposed to indicate "one or more".
>>    
>>
>
>Sorry. I understand now. The "+" was written in the sense of "lex" tokens
>or "regular expressions" as grep, perl, etc. To me it was not clear, since
>it is not a standard XSLT notation. Seems like I still have problem when
>people is mixing languages. Sorry. :-(
>
>Well, I will fix it back, but I think some other people (as me) can
>missunderstand its meaning and think it is a typo. Since this is posible I
>think we need to find another way to represent it or define a "notation".
>
>  
>

I think there should be a comment clearly explaining what is allowed.  
The + is confusing and would confuse newbies even more.

Tony