[Docs] Errors in Direction expression syntax

[oskarkk]

Read this:

[%number% [[(block|met(er|re))[s]] [to the]] (north[(-| )][(east|west)][(ward(s|ly)]|er[(n|ly)])] [of]|south[[(-| )][(east|west)][(ward(s|ly)]|er[(n|ly)])] [of]|[(east|west)[(ward(s|ly)]|er[(n|ly)])] [of]|above|over|[(up|down)[ward(s|ly)]]|below|under[neath]|beneath) [%direction%]

In particular:

north[(-| )][(east|west)][(ward(s|ly)]|er[(n|ly)])] [of]
north . [(-| )] . [(east|west)] . [ ( ward(s|ly)] | er[(n|ly)] ) ] . [of]
ward(s|ly)] - missing [, should be ward[(s|ly)]

This is total chaos:
south[[(-| )][(east|west)][(ward(s|ly)]|er[(n|ly)])] [of]
south[ . [(-| )] . [(east|west)] . [( ward(s|ly)] | er[(n|ly)] ) . ] . [of] - let's remove the first left bracket:
south . [(-| )] . [(east|west)] . [( ward(s|ly)] | er[(n|ly)] )] . [of] - now it's like north expression above, let's fix "wardsly" part:
ward(s|ly)] should be ward[(s|ly)], so:
south . [(-| )] . [(east|west)] . [( ward[(s|ly)] | er[(n|ly)] )] . [of]
south[(-| )][(east|west)][(ward[(s|ly)]|er[(n|ly)])] [of]

And:
[(east|west)[(ward(s|ly)]|er[(n|ly)])] [of]
[ . (east|west) . [( ward(s|ly)] | er[(n|ly)] )] . [of] - what's with that first left bracket? let's fix it:
(east|west) . [( ward(s|ly)] | er[(n|ly)] )] . [of] - fix "wardsly" again:
(east|west) . [( ward[(s|ly)] | er[(n|ly)] )] . [of]

And:

[(up|down)[ward(s|ly)]]
(up|down) [ ward[(s|ly)] ]

I've read that the docs are generated automatically, so I think something broke. By the way, that syntax is completely incomprehensible and it would be good to break it into smaller pieces, if that's possible:

[%number% [[(block|met(er|re))[s]] [to the]] north[(-| )][(east|west)][(ward[(s|ly)]|er[(n|ly)])] [of] [%direction%]

[%number% [[(block|met(er|re))[s]] [to the]] south[(-| )][(east|west)][(ward[(s|ly)]|er[(n|ly)])] [of] [%direction%]

[%number% [[(block|met(er|re))[s]] [to the]] (east|west)[(ward[(s|ly)]|er[(n|ly)])] [of] [%direction%]

[%number% [[(block|met(er|re))[s]] [to the]] (above|over|[(up|down)[ward(s|ly)]]|below|under[neath]|beneath) [%direction%]

That's more readable, doesn't it?

[oskarkk]

On SkriptHub the syntax is written in a different way:

[%number% [(block|met(er|re))[s]] [to the]] (north[(-| |)(east|west)][(ward(s|ly|)|er(n|ly|))] [of]|south[(-| |)(east|west)][(ward(s|ly|)|er(n|ly|))] [of]|(east|west)[(ward(s|ly|)|er(n|ly|))] [of]|above|over|(up|down)[ward(s|ly|)]|below|under[neath]|beneath) [%direction%]

As you can see, (x|y|) is preferred to [(x|y)], so it's using less chars and it's more readable. The errors which I described above have no place there.