Include Comments ABOVE the ALTER PROC statement
But if I use SQL PROMPT snippet AP<tab> pick-the-name<tab> it only displays what came after the original ALTER PROCEDURE statement. And if I go ahead and execute that, then my comment is eliminated.
I have refreshed the cache before testing this, so it is not a problem of being out-of-date, just apparently not being there at all. It would be great if this would retrieve the full definition including my preceding comment.