Instructions to help writing reference documentation

[afre (Alan)]

I do know what you are talking about; didn’t expect such a long response.