Tweak script docs

[oznogon]

• Consolidate script_docs function writer logic to a function
• Emit a warning for each function that lacks both a description and an example
• Add 1rem margin between function blocks in the script reference output
• Use two dashes instead of 3+ for file organization lines in shiptemplatebasedobject.lua to prevent them from bleeding into the Entity:setTemplate() function docs