Add len function to macro rules.
Update documentation for metadata len function.
Correct metadata len() function syntax.
Re-tidied.
Added test for len(X) to test-battery.
Update metadata appendix to include len().
Merge pull request #815 from arjclark/rose-metadata-len-func

rose metadata: len function for fail-if, warn-if, etc