**Runtime Utility Formatting Function**

(acronym expansion subject to change)

Ruff! is the documentation system included with [Woof!]. Unlike other source documentation systems, Ruff! generates documentation using runtime introspection.

======
namespace eval ::ruff::test {
    proc print_array {name_of_array {key_pattern *}} {
        upvar $name_of_array arr
        foreach {key val} [array get arr] {
            puts $key:$val
        }
        # Note this proc has no ruff comments
    }

    proc sample_proc {param {param_with_default default_value}} {
        # A sample proc to illustrate ruff! This is the summary line
        # (or lines). It may or may not have a whitespace line following it.
        #  param - a parameter to the procedure.
        #  param_with_default - another parameter but with default value. Note
        #    the parameter description may cover multiple logical and
        #    physical lines.
        #
        # This is a general description paragraph. Paragraphs are separated
        # by lines that only have the comment character # and  whitespace
        # 
        # Introspective documentation generation allows correct pickup
        # of namespaces in procedure names, less duplication, minimal
        # extraneous symbols.
        #
        # Returns the empty string.

        set foo bar

        return ""
    }
}
======
----
!!!!!!
%| [Category Documentation] |%
!!!!!!