doc: path functions ignore trailing slashes

Add notes about path.parse(), path.basename() and path.dirname() ignoring trailing slashes as suggested by @bnoordhuis at #6229 (closed).

Refs: https://github.com/nodejs/node/issues/6229

Checklist

• documentation is changed or added
• commit message follows commit guidelines

Affected core subsystem(s)

doc