Incomplete history of the method fs.lchmod

[AlessandroTambellini]

Affected URL(s)

No response

Description of the problem

In the new beta docs, the history drop-down menu of fs.lchmod doesn't include when the method was introduced. It only contains when it was deprecated.

[aduh95]

This was done in #6717, and AFAICT it was on purpose, it's an API that should not have been added.

[ashrees]

I'd like to help with this. From doc/changelogs/CHANGELOG_ARCHIVE.md, fs.lchmod was introduced in v0.5.0 (2011-07-05):

• #853 add fs.lchow, fs.lchmod, fs.fchmod, fs.fchown (isaacs)

The current YAML history blocks for fs.lchmod and fs.lchmodSync only record deprecated: v0.4.7 — which appears to predate the introduction, so the deprecation version may also deserve a second look.

Would a PR adding a correct added: entry (and adjusting deprecated: if needed) be welcome? Happy to open it.

[AlessandroTambellini]

@aduh95 I don't understand this comment:

it's an API that should not have been added

Perhaps it's true, but it still have an history and someone used it. So, it should be made clear when it was added