Menu

#351 Namespaces in directives

5.2.0
open
nobody
None
1
2025-11-02
2025-10-31
No

Many directives that allow namespace-qualifies classnames don't explicitly say so, which is misleading.

For example, rexxref 3.3 ::CLASS says about sclass that it "is a literal string or symbol that is taken as a constant", but it should say that it "is a literal string or an optionally namespaced symbol that is taken as a constant" (strings, for whatever reason, cannot be namespaced).

Discussion

  • Josep Maria Blasco

    Here's a patch.

     
    • Rony G. Flatscher

      Looks good, thank you very much, Josep Maria!

       
  • Anonymous

    Anonymous - 2025-11-01

    WHAT is a namespaced symbol.
    rexxref talks about namespace but not namespaced

     
    • Josep Maria Blasco

      "namespaced symbol" = "a symbol preceded by a namespace and a colon".

       
      • Gil Barmwater

        Gil Barmwater - 2025-11-01

        Perhaps "namespace-qualified symbol" assuming that is defined in the section on Namespaces? Just a thought.

         
        • Josep Maria Blasco

          Sounds much better, yes. Thanks, Gil!

           
  • Josep Maria Blasco

    Here's an updated patch, following Gil's suggestion.

     
  • Anonymous

    Anonymous - 2025-11-02

    found this in ressref:
    namespace-prefixed symbol.

     
    • Josep Maria Blasco

      Interesting. There are six occurrences of "namespace-" in rexxref. Five are "namespace-qualified", and one is "namespace-prefixed". Clearly, this should be fixed to "namespace-qualified". Thanks for pointing this out.

       
  • Josep Maria Blasco

    Here's a small additional patch for the "namescape-prefixed" mention.

     

Anonymous
Anonymous

Add attachments
Cancel