[jira] [Commented] (OAK-5051) Document XPath (and SQL-2) syntax as supported by Oak
[ https://issues.apache.org/jira/browse/OAK-5051?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16643284#comment-16643284 ] Julian Reschke commented on OAK-5051: - [~catholicon] - doc generation currently fails because oak-doc-railroad-macro is not in the reactor. Shouldn't it be added there? > Document XPath (and SQL-2) syntax as supported by Oak > - > > Key: OAK-5051 > URL: https://issues.apache.org/jira/browse/OAK-5051 > Project: Jackrabbit Oak > Issue Type: Documentation > Components: query >Reporter: Thomas Mueller >Assignee: Thomas Mueller >Priority: Major > > The JCR 2.0 SQL-2 language is documented at > http://h2database.com/jcr/grammar.html > But extensions to that are not documented. And XPath (as supported by Oak) is > not documented at all. > It would be good to have such a documentation, with examples. -- This message was sent by Atlassian JIRA (v7.6.3#76005)
[jira] [Commented] (OAK-5051) Document XPath (and SQL-2) syntax as supported by Oak
[ https://issues.apache.org/jira/browse/OAK-5051?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16371579#comment-16371579 ] Thomas Mueller commented on OAK-5051: - [~catholicon] thanks a lot for porting the BNF tool! I converted the SQL-2 part in svn.apache.org/r1824977 > Document XPath (and SQL-2) syntax as supported by Oak > - > > Key: OAK-5051 > URL: https://issues.apache.org/jira/browse/OAK-5051 > Project: Jackrabbit Oak > Issue Type: Documentation > Components: query >Reporter: Thomas Mueller >Assignee: Thomas Mueller >Priority: Major > > The JCR 2.0 SQL-2 language is documented at > http://h2database.com/jcr/grammar.html > But extensions to that are not documented. And XPath (as supported by Oak) is > not documented at all. > It would be good to have such a documentation, with examples. -- This message was sent by Atlassian JIRA (v7.6.3#76005)
[jira] [Commented] (OAK-5051) Document XPath (and SQL-2) syntax as supported by Oak
[
https://issues.apache.org/jira/browse/OAK-5051?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16358636#comment-16358636
]
Vikas Saurabh commented on OAK-5051:
[~tmueller], I've committed current work to trunk. Doing
{noformat}
mvn install site -Pdoc -pl :oak-doc -am
{noformat}
would build/install macro bundle too. I've published currently generated
grammar-xpath.html to oak-docs as well.
> Document XPath (and SQL-2) syntax as supported by Oak
> -
>
> Key: OAK-5051
> URL: https://issues.apache.org/jira/browse/OAK-5051
> Project: Jackrabbit Oak
> Issue Type: Documentation
> Components: query
>Reporter: Thomas Mueller
>Assignee: Thomas Mueller
>Priority: Major
>
> The JCR 2.0 SQL-2 language is documented at
> http://h2database.com/jcr/grammar.html
> But extensions to that are not documented. And XPath (as supported by Oak) is
> not documented at all.
> It would be good to have such a documentation, with examples.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Commented] (OAK-5051) Document XPath (and SQL-2) syntax as supported by Oak
[
https://issues.apache.org/jira/browse/OAK-5051?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16351851#comment-16351851
]
Vikas Saurabh commented on OAK-5051:
Btw, on [~chetanm]'s (offline) request, here's published page -
https://catholicon.github.io/railroad-output/query/grammar-xpath.html.
[~tmueller], btw, once you get around to check it out, I would like to mention
a few things:
* the macro loads the grammar csv, but renders only what's requested (it
doesn't load the csv every time as one site plugin activation instantiates one
instance of the macro)
* renamed {{grammar-xpath.md}} to {{grammar-xpath.md.vm}} as that allowed me to
put grammar csv in {{oak-doc}} project instead of an embedded resource in
{{oak-doc-railroad-macro}} project
** it has a minor downside though - since velocity reserves {{#}} for its own
macro language, so I had to utilize a small hack to bring up Markdown's
headings (which are {{#}}, or {{##}}, etc)
* while, I'm pretty happy with the current impl of macro and how it's reading
grammar csv (from consuming project), we still need to review:
** grammar
** nomenclature of new class and packages
> Document XPath (and SQL-2) syntax as supported by Oak
> -
>
> Key: OAK-5051
> URL: https://issues.apache.org/jira/browse/OAK-5051
> Project: Jackrabbit Oak
> Issue Type: Documentation
> Components: query
>Reporter: Thomas Mueller
>Assignee: Thomas Mueller
>Priority: Major
>
> The JCR 2.0 SQL-2 language is documented at
> http://h2database.com/jcr/grammar.html
> But extensions to that are not documented. And XPath (as supported by Oak) is
> not documented at all.
> It would be good to have such a documentation, with examples.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
[jira] [Commented] (OAK-5051) Document XPath (and SQL-2) syntax as supported by Oak
[ https://issues.apache.org/jira/browse/OAK-5051?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16349807#comment-16349807 ] Chetan Mehrotra commented on OAK-5051: -- bq. I've updated grammar-xpath.md [1] to utilize a doxia macro (part of the same branch) that renders railroads Interesting stuff! > Document XPath (and SQL-2) syntax as supported by Oak > - > > Key: OAK-5051 > URL: https://issues.apache.org/jira/browse/OAK-5051 > Project: Jackrabbit Oak > Issue Type: Documentation > Components: query >Reporter: Thomas Mueller >Assignee: Thomas Mueller >Priority: Major > > The JCR 2.0 SQL-2 language is documented at > http://h2database.com/jcr/grammar.html > But extensions to that are not documented. And XPath (as supported by Oak) is > not documented at all. > It would be good to have such a documentation, with examples. -- This message was sent by Atlassian JIRA (v7.6.3#76005)
[jira] [Commented] (OAK-5051) Document XPath (and SQL-2) syntax as supported by Oak
[
https://issues.apache.org/jira/browse/OAK-5051?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16349076#comment-16349076
]
Vikas Saurabh commented on OAK-5051:
[~tmueller], can you check out {{OAK-5051-grammar-railroads}} \[0] branch at my
fork. I've updated {{grammar-xpath.md}} \[1] to utilize a doxia macro (part of
the same branch) that renders railroads using very similar logic that you were
using at h2 railroad documentation.
\[0]:
https://github.com/catholicon/jackrabbit-oak/tree/OAK-5051-grammar-railroads
\[1]:
https://raw.githubusercontent.com/catholicon/jackrabbit-oak/OAK-5051-grammar-railroads/oak-doc/src/site/markdown/query/grammar-xpath.md
> Document XPath (and SQL-2) syntax as supported by Oak
> -
>
> Key: OAK-5051
> URL: https://issues.apache.org/jira/browse/OAK-5051
> Project: Jackrabbit Oak
> Issue Type: Documentation
> Components: query
>Reporter: Thomas Mueller
>Assignee: Thomas Mueller
>Priority: Major
>
> The JCR 2.0 SQL-2 language is documented at
> http://h2database.com/jcr/grammar.html
> But extensions to that are not documented. And XPath (as supported by Oak) is
> not documented at all.
> It would be good to have such a documentation, with examples.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
