Allow disabling footer date with includeDate template config (#910)

[jviotti]

As described in #910, this PR allows the user to disable the footer date in the default template, to prevent unnecessary noise in the commits.

This PR adds a new boolean option called includeDate to the templates config section.

Leaving it out preserves the current functionality (date is displayed). If you want to turn off that feature, you must pass includeDate: false explicitly:

{
    ...
    "templates": {
        ...
        "default": {
            "includeDate": false
        }
    },
    ...
}

I'll open an issue at https://github.com/jsdoc3/jsdoc3.github.com/issues along with this PR to include documentation about this new option.

[hegemonic]

• This code should be looking for the propertyenv.conf.templates.default.includeDate, because this option is specific to the default template.
• For safety, check for env.conf.templates and env.conf.templates.default first.
• Please check whether the property !== false, rather than for == undefined or truthy.
• If you want to remove the JSDoc version number as well, please use a separate includeVersion property to control that behavior. (And please make sure the </a> tag shows up when this property is set to false. In your current patch, setting includeDate to false causes the </a> tag to be omitted.)

[jviotti]

This code should be looking for the property env.conf.templates.default.includeDate, because this option is specific to the default template.

Indeed. I missed the default object you explained on the issue.

For safety, check for env.conf.templates and env.conf.templates.default first.

Included.

Please check whether the property !== false, rather than for == undefined or truthy.

Fixed, checking for false simplifies the condition.

If you want to remove the JSDoc version number as well, please use a separate includeVersion property to control that behavior. (And please make sure the tag shows up when this property is set to false. In your current patch, setting includeDate to false causes the tag to be omitted.)

My bad. I shouldn't be removing the version as well. Fixed.

[hegemonic]

Merged to master. I'll also merge the change to the 3.3.0 branch.

Thanks for fixing those issues and squashing the commits!

[jviotti]

@hegemonic Thanks, you're welcome, happy to have this issue fixed!