Support #6732
discussion of language features
Status:
New
Priority:
Normal
Assignee:
-
Target version:
-
Start date:
Due date:
% Done:
0%
billable:
No
vendor_id:
GCD
case_num:
version:
History
#1 Updated by Vladimir Tsichevski over 1 year ago
TRPL¶
I've read the docs about TRPL (mostly the Writing_TRPL_Rule-Sets
chapter), and some questions remain unanswered:
- I see multiple terms in the docs: profile document, master profile document, master document, profile, top-level, A PatternEngine profile, Pipeline profile documents, cfg. I suspect all they denote the same thing, correct?
- Are absolute paths supported in named
rule-sets
andincludes
? - About
load-condition
attribute: the only value used in FWD for this attribute is "runtime-query". May be, the attribute semantics should be changed to boolean "is runtime query"? - About
honor-hidden
attribute: default value is not defined in the docs. Is there any default for this attribute? - The docs says "If this attribute is not provided, an inline ruleset definition is assumed." and "inline" rulesets are immediate children of the "profile" file. Is it valid to use a not-named ruleset inside other rule-set. If yes, how will it be processed? The relations between "top-level", "named", "inlined" and "merged" are not clean to me.
- The docs mentions "filtered view". How this filteres view is defined in ".xml" and ".rules" files? Or somewhere else?
- from where the profiles are run? In which sequence? Is conversion flow documented anywhere, starting from
ConversionDriver
and like? - "pattern path". Is this the value of "patpath" parameter in "p2j.cfg.xml"? This is not explayned in the docs.
Other notes:
- The term "profile" is used in the docs. Sometimes it refers the files with
<cfg>
toplevel element only, sometimes also with<rule-set>
. Which is correct? - "<ast-spec>" element is not used in FWD rules, so its support may be (if not already) dropped, and the description removed from the docs.
- "<expression>" element is still used in FWD rules, but is never named, so the reference to named expressions can be removed from the docs (and support dropped).
- "Pipeline profile documents always have a filename extension of
.xml
. Rule-Set profile documents always have a filename extension of.rules
..."
"A pipeline profile must use the.xml
file name extension; a rule-set profile must use the.rules
file name extension."
This is not true: at least one file "schema/p2o_common.rules" is a profile document with the ".rules" extension. - According to the docs, "worker" elements can be used in profile scope only. Meanwhile, they are widely used in "rule-set" elements.
#2 Updated by Vladimir Tsichevski over 1 year ago
The docs say TRPL function parameters may have default values (like TRPL variables). But it is an error if I pass to expression compiler less parameter values than is declared for the function. So, either the docs or expression compiler needs fixing. Am I correct?