2610. [filesys.ts] [PDTS] Apparently inconsistent return types from several functions

Section: 6 [filesys.ts::fs.filesystem.synopsis] Status: NAD Submitter: FI-4 Opened: 2014-01-20 Last modified: 2016-08-10

Priority: Not Prioritized

View all other issues in [filesys.ts::fs.filesystem.synopsis].

View all issues with NAD status.

Discussion:

Addresses: filesys.ts

It is unclear why copy, copy_file and copy_symlink have different return types, and why the attribute-version of create_directory has a different return type than the create_directory that takes no attributes. The status/error reporting in these functions seems inconsistent.

Resolution:

Make the status/error reporting consistent or add a note explaining why it's different.

[ 2014-02-11 Issaquah: NAD. LWG/SG-3 reviewed each function and return type, and found that since they have different functionality different return types are warranted. create_directory has an inconsistent return type between the synopsis and the description. This has subsequently been corrected editorially. ]

Proposed resolution: