Update function header comments on "ng" implementation functions

[skliper]

Action item from vxworks-ng review held on 2019-08-27:

Across posix-ng, rtems-ng, and vxworks-ng, the implementation functions have header comments that were cut and paste from the original implementation and may not reflect the actual code anymore.

This should be scrubbed prior to the OSAL release.

[skliper]

Imported from trac issue 240. Created by jphickey on 2019-08-27T16:41:36, last modified: 2019-09-10T09:15:46

[skliper]

Trac comment by jphickey on 2019-09-09 10:10:16:

For resolving this I propose to put the corrected comments/descriptions in the "os-impl.h" file and //remove// them from the C file, or at least replace the ones in the C file with a simpler/shorter comment that refers back to the header file for detail.

The reason is that all three implementations share a common "os-impl.h" header file. Putting it in the C source means copying it at least 3 times, this will become another maintenance issue. (actually partly the cause of the current problem, things just got copied/pasted).

[skliper]

Trac comment by jhageman on 2019-09-10 09:15:46:

Agree completely, describe in os-impl.h, remove from c files.

Please transfer this issue to github and apply changes to the release candidate branch.

[skliper]

Closing as duplicate of #17