PortIn.h: Documentation improvements only

[TacoGrandeTX]

Description

• Improve function and parameter descriptions
• Improve clarity of the example

Pull request type

[ ] Fix
[ ] Refactor
[ ] Target update
[ ] Functionality change
[x] Docs update
[ ] Test update
[ ] Breaking change

[NirSonnenschein]

/morph build

[mbed-ci]

Build : SUCCESS

Build number : 3352
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/8419/

Triggering tests

/morph test
/morph export-build
/morph mbed2-build

[mbed-ci]

Exporter Build : FAILURE

Build number : 2986
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/exporter/8419/

[mbed-ci]

Test : SUCCESS

Build number : 3157
Test logs :http://mbed-os-logs.s3-website-us-west-1.amazonaws.com/?prefix=logs/8419/3157

[cmonr]

IAR network license issue.

/morph export-build

[mbed-ci]

Exporter Build : SUCCESS

Build number : 2991
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/exporter/8419/