Thanks for the feekback. Here is a patch with all your suggested modifications.

About the manual, given it's the first time I edit it I went for a very minimalist approach, please tell me if I should mention the default values, or the type of the defcustom in there.