Umm, not to rain on anyone's parade, here, but something tells me we're trying to engineer a solution to a problem that might be better solved elsewhere.
The problem that we're trying to solve (IMHO) is documenting what goes where. If you start putting text commentary in the CP object directory, you start consuming substantial space in a shared resource that has a fixed size. Yes, Alan and Co can expand that size, but who hasn't seen finance weenies using Lotus 1-2-3 as a word processor because that's what they know? If the problem is DIRMAINT mucking around with comment locations, wouldn't it be simpler to add code to DIRM and the other directory maintenance tools that recognized a ":format on/off" meta-comment in the directory source to tell the tool to leave statements inside the block ordered as received. Let those tools manage the human text part of the problem and let CP worry about the virtual machine statements as fast as possible? I think I'm agreeing with Rob's earlier statement: I really don't think the CP object directory is the right place for this kind of thing, and there's a bunch more things that I'd rather have Alan & Co work on.
