Once again, I failed to grok the vim docs, but I finally got this working. If you have an editor which implements folding, you probably love having annoying things folding out of the way. I find POD annoying. Almost all of my modules are written with inline POD because I believe it's very important for the documentation to be next to the code, but if you've worked on a codebase for any length of time, that POD quickly becomes annoying. The following will fold your POD out of the way without folding other bits:
I expect that's rather self-explantory. See
To learn more about vim's syntax options for Perl:
Folding in vim will usually show the first line of text folded (you can override this). Because the first line of text in our POD is usually a signature, we get this:
+-- 8 lines: =head2 resultset_with_request_params($c, $rs) : $rs------------
In short, every function comes with a quick synopsis with this. Very, very handy.