New draft (#6) of SRFI 170: POSIX API Arthur A. Gleckler 23 Jul 2019 06:42 UTC
I've just published draft #6 of SRFI 170. It was submitted by John Cowan, author of the SRFI, with much assistance from Harold (HGA). <https://srfi.schemers.org/srfi-170/> Here are John's comments on the draft: - removed glob and extra spawn* and exec* procedures - Add citations to specific IEEE and POSIX standards to Rationale - XSI extensions added to file-info (stat) - Excise /var/tmp as the default or example tmp dir location - Use the scsh capitalization conventions of the project - Minor language, typo, indentation fixes, regularize "file name(s)" - Add . and .. exceptions to read-directory, add paragraph break - Remove unreliable sync-file and sync-file-system proceedures - Based on file-info-*? description, perms/mode -> permission bits - Changed implementation version, added pointers to it and build notes. - create-directory/-fifo and set-file-mode change and workaround - Document temp-file-prefix/*temp-file-template* /var/tmp -> /tmp - Make temp-file-iterate rename to a temp file example less magical - set-file-timespecs -> set-file-times, and timespec argument diff - file-info record time field differences, and absence of new fields - Implementation exceptions in correct order, touch up work-around - Excise create-temp-file security note, obsolete with /tmp default - Add reference to scsh-build-notes.org in SRFI repository. - First draft, not tested or ornamented - Warnings that neither Scheme 48 or scsh 0.7 have uninstall targets - Added notes from building with vanilla test user account - Add offer of help and email contact for building on UNIX systems - Added formating for output blocks and mailto: for contact address - mailto: does nothing in GitHub org mode display - Section headers for Implementation section, moved time caveats up - Making sure glob writeup is not lost - Tiny language change - Document scsh's create-hard-link behavior across file systems - The ~a temp-file-iterate gotcha, and fix HTML goof - Finished temp-file-iterate Implementation section - Put real-path into correct section - Document file-info-symlink? Linux failure, touch up formatting - Looks Good To Me (LGTM) changes to 3.4 Processes - temp-file-iterate -> call-with-temporary-filename, bit of cleanup - Fix Implimentation item on call-with-temporary-filename - Prefer not to capitalize API names at beginning of sentence - Fix set-effective-uid/gid arguments - Use IANA-managed reserved example.com for fully-qualified dom name - Minor language cleanups - Discussed editorial changes, add config arg to exec and exec-path - umask and set-umask, added POSIX ref, scsh file-mode caveat - added back rename-file, editorial changes - More paranoid creation permission bits, set-umask returns previous - Note link in the link to POSIX errno.h that provides more details - renamed working-directory procedures to avoid confusion - infinite loop if create-directory w/override? of dir with contents - editorial Here's the diff: <https://github.com/scheme-requests-for-implementation/srfi-170/compare/7053d4a8883e565489c990410d440f836d7da230..66bef8221383b9a6dda2f845eb803ece876bb32f> Regards, SRFI Editor