Just one comment on your patch.  The documentation already tells you how to handle keyword arguments (section 8 tells you how to handle default values, section 9 tells you how to handle | in the format string).  If you have any suggestions on how I could improve the documentation I'd be happy to try it.