From: Tom P. (JIRA) <ji...@pc...> - 2010-06-22 02:50:27
|
[ http://jira.pcgen.org/browse/NEWTAG-25?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Tom Parker updated NEWTAG-25: ----------------------------- Description: 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 was: 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[z]|y[z,z]|x,y,y[z],y[z,z] 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 > 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 > 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 |