Clojurians Log v2

gqi" ?

Thanks @tomd. The i" piece isn't working for me, but I understand the idea. I'll have to figure out what's going on with my config. (I see now that part of the reason I never learned this trick is that (a) I write text more often than code, (b) I started using vim so long ago that g and q were not mapped to anything--or not to anything I thought useful--so I created my own custom mappings for them for use with writing text [and got annoyed when Bram or someone created standard mappings later] so I've never used g or q in the usual way. Oh well.)

I tend to use gw for this (e.g. gwi", or gww to just do the current line) I forget the difference between gw and gq -- does anyone here know?

gw doesn't move the cursor

Probably the better choice in most cases

I just visually select the paragraph I want to format and hit gq (that stopped working recently, though. Glad to learn that gw does the trick)

I tend to document function args in a little block like this:

foo | Doco for the `foo` arg
bar | Doco for the `bar` arg

To line up the pipes I visually select the args block and use the Tabularize plugin like this :Tab /|, which I have mapped to just |

Thanks @dave, @jkrasnay, @tomd. That's all very helpful. Now I just have to figure out my preferred approach (and mess with my config a little to create a new mapping because my fingers have permanently reassigned the meaning of g to something no one else uses).

You can format in vim with =. Check this out: https://vim.fandom.com/wiki/Format_a_code_block