tango.io.stream.MapStream, allow comments

Patch?

Without testing, I would say the straightforward (trivial) solution is this:

        /***********************************************************************

                Write name & value to the provided stream

        ***********************************************************************/

        final MapOutput append (T[] name, T[] value, char[] comment = "")
        {
		if(comment.length)
                        output ("#") (comment) (NL) (name) (equals) (value) (NL);
		else
			output (name) (equals) (value) (NL);
                return this;
        }

        /***********************************************************************

                Write AA properties to the provided stream

        ***********************************************************************/

        final MapOutput append (T[][T[]] properties, char[] comment = "")
        {
		if(comment.length)
			output ("#") (comment) (NL);
		
                foreach (key, value; properties)
                         append (key, value);
                return this;
        }

I'd rather this was done via some application specific wrapper. Otherwise, people will doubtless complain that the formatting is all wrong, or they want tabs instead of spaces for the alignment, or whatever :)

Still, let's see what can be done

I think adding a discrete comment(char[] text) should be sufficient, especially if it can be chained with other calls e.g.

map.comment("some comment").append(properties);

(In [3152]) added comment() and newline() methods to MapOutput?. Closes #777