[Pcgen-trackers] [JIRA] Commented: (NEWTAG-25) CHOOSE:SKILL

[JIRA (f. E. C. S. ) <ji...@pc...>]

    [ http://jira.pcgen.org/browse/NEWTAG-25?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12426#action_12426 ] 

Eric C. Smith commented on NEWTAG-25:
-------------------------------------

I noticed that the Skill specific qualifiers include several that are actually negations of other qualifiers. I will not be including the negated qualifiers in the docs as there is already a statement that qualifiers can be negated.


> CHOOSE:SKILL
> ------------
>
>                 Key: NEWTAG-25
>                 URL: http://jira.pcgen.org/browse/NEWTAG-25
>             Project: New Tag
>          Issue Type: Modify Token
>          Components: LST Tag
>    Affects Versions: 5.17.1, 5.17.2
>            Reporter: Tom Parker
>            Assignee: Eric C. Smith
>             Fix For: 5.17.4 (Alpha)
>
>
> CHOOSE:SKILL
> SUBTOKEN: CSKILLS (deprecated)
> SUBTOKEN: NONCLASSSKILLLIST (deprecated)
> SUBTOKEN: SKILLSNAMED (deprecated)
> SUBTOKEN: SKILLSNAMEDTOCSKILL (deprecated)
> SUBTOKEN: SKILLSNAMEDTOCCSKILL (deprecated)
> SUBTOKEN: SKILLS (deprecated)
> SUBTOKEN: SKILL (new)
> [edit] Syntax
> CHOOSE:SKILL|x|y|y[x]|y[x,x]|x,y,y[x],y[x,x]
> x is a Skill PRIMITIVE
> A PRIMITIVE is an identifier of objects, and may include any number of specifications. In the case of Skill objects, there are are the four global PRIMITIVES:
> x = an Skill (specified by key)
> x = TYPE=w (w is a TYPE identifier for a Skill )
> x = !TYPE=w (w is a TYPE identifier for a Skill that would be prohibited)
> x = ALL (allow the choice of any Skill)
> There are also Skill specific PRIMITIVES:
> x% = a pattern match for a Skill (specified for skill keys)
> y is a QUALIFIER
> A QUALIFIER is a special keyword that identifies a subset of objects that should be returned. Valid qualifiers for Skill objects include any of the Global Qualifiers.
> There are also many Skill specific QUALIFIERS:
> CLASS Displays all class skills for the PC
> !CLASS Displays all skills that are NOT class skills for the PC
> CROSSCLASS Displays all crossclass skills for the PC
> !CROSSCLASS Displays all skills that are NOT crossclass skills for the PC
> EXCLUSIVE Displays all exclusive skills for the PC
> !EXCLUSIVE Displays all skills that are not exclusive skills for the PC
> NORANK Displays all skills in which the PC has no rank
> RANK=n Displays all skills in which the PC has n or more ranks
> A comma represents "AND", meaning multiple items are evaluated independently and then any item that appears in ALL of the items is added to the list.
> CHOOSE:SKILL|Search,Spot
> will result in NO choices because no Skill is both Search and Spot.
> CHOOSE:SKILL|TYPE=Foo,PC
> would test for any Skill that has the Foo type (as defined in the Skill LST file) which is ALSO already selected by the PlayerCharacter
> This could also be written (probably more clearly):
> CHOOSE:SKILL|PC[TYPE=Foo]
> A pipe represents "OR", meaning multiple items are evaluated independently and then any item that appears in any of the items is added to the list:
> CHOOSE:SKILL|Search|Spot
> will result in a choice between Deities Search and Spot.
> All commas (ANDs) are evaluated before pipes (ORs), so something like:
> CHOOSE:SKILL|Search|TYPE=Foo,PC
> would include Search unconditionally, in addition to any Skill that has the Foo type (as defined in the Skill LST file) which is ALSO already selected by the PlayerCharacter
> [edit] Special Case
> CHOOSE:NONCLASSSKILLLIST had an argument LIST which queried for CROSSCLASS skills on the PC, thus LIST is equivalent to CROSSCLASS in the new syntax
> Note that the SKILLSNAMED, SKILLSNAMEDTOCSKILL, and SKILLSNAMEDTOCCSKILL subtokens have syntax that does not change (even relative to the complex behavior available in those tokens)
> [edit] Conversion
> CHOOSE:CSKILLS becomes CHOOSE:SKILL|CLASS
> CHOOSE:SKILLS becomes CHOOSE:SKILL|PC
> CHOOSE:SKILLSNAMED|... becomes CHOOSE:SKILL|...
> CHOOSE:SKILLSNAMEDTOCSKILL|... becomes CHOOSE:SKILL|... CSKILL:LIST
> CHOOSE:SKILLSNAMEDTOCCSKILL|... becomes CHOOSE:SKILL|... CCSKILL:LIST
> CHOOSE:NONCLASSSKILLLIST|LIST becomes CHOOSE:SKILL|CROSSCLASS
> CHOOSE:NONCLASSSKILLLIST|LIST|Spot,Search becomes CHOOSE:SKILL|CROSSCLASS|Spot|Search 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.pcgen.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira