I think these question marks are meant to convey that the parameters are optional.

Right, but other optional parameters lack them. In any case, why not just use standard man notation, i.e., brackets [param] to denote optional parameters? We don't type in question marks here, which will be confusing for new users unfamiliar with such things.

Right, but other optional parameters lack them.

Which ones? Might be good to fix them.

In any case, why not just use standard man notation, i.e., brackets [param] to denote optional parameters?

Yeah, I think that's a good idea. The ? notation is alien to me too.

So I'd vote for replacing it with the brackets notation, rather than removing it completely.

They are meant to denote optional parameters (regex notation). Switching to brackets sounds good to me, and fixing any other optional parameters that are not marked properly would also be good.

Done. What about parameters like pl for the plugin commands, and the one I added for showkey: key? Shall we clarify that these are merely placeholders and are meant to be replaced by the user? Man pages use italics for that.

Yep, it's an important thing to clarify. Actually there is already the '' notation used for this purpose throughut commands.md, right? So I think we should keep it everywhere, i.e. save ['filename'] instead of save [filename] etc (and showkey 'key' in particular).

Okay. When I see single quotes in the programming/command line/IT world, I read it as a form of shell escaping, which isn't the same thing as replacing an argument with appropriate text. But yeah, probably no reason to use both italics and single quotes. I'll make the change.

Okay. When I see single quotes in the programming/command line/IT world, I read it as a form of shell escaping, which isn't the same thing as replacing an argument with appropriate text. But yeah, probably no reason to use both italics and single quotes. I'll make the change.

Yep, using single quotes in this context doesn't look conventional to me either. But it has the advantage of not depending on the highlighting or on the terminal capabilities (italics don't always work hassle-free in a terminal, actually it seems they more often don't then do), so I don't see a better option right now.