| 1 | * Convert I/O layers to I/O objects. |
| 2 | |
| 3 | * Make 'print' and 'say' stringify the same way. (See RT #55196) |
| 4 | |
| 5 | * Decide if we plan to use AIO before the 1.0 release. (See RT #57920) |
| 6 | |
| 7 | * Change 'fprintf' to 'PIO_fprintf' where relevant. |
| 8 | |
| 9 | * Plain %s in parrot printf-alike functions do not handle NULL C strings well. Fix. |
| 10 | |
| 11 | * Remove deprecated opcode 'pioctl', and fix related documentation. (See RT #48589) |
| 12 | |
| 13 | <h3>General</h3> |
| 14 | |
| 15 | * All 'PIO_*' functions change to 'Parrot_io_*'. (Since the implementation is completely changing, better to create new functions with the new names than to change the names of existing functions.) |
| 16 | |
| 17 | * Continue to support different I/O operations on different platforms. Possibly via roles applied to the IO PMC, or possibly just using C '#ifdef's within specific functions. |
| 18 | |
| 19 | * Remove src/io/io_passdown.c and src/io/io_layers.c, purely implementation artifacts of I/O layers implementation. |
| 20 | |
| 21 | * Remove src/io/io_mmap.c, unused and not useful. |
| 22 | |
| 23 | * Change src/io/io_string.c to a subclass of FileHandle PMC, that provides the same interface, but to a string instead of a file handle. |
| 24 | |
| 25 | * src/io/io_unix.c is the guts of most I/O on most platforms. src/io/io_win32.c is Windows. src/io/io_stdio.c is STDIN, STDOUT, and STDERR. These three need to be ported to the new system. |
| 26 | |
| 27 | * src/io/io_utf8.c is really the wrong way to go about it. Filehandles should be marked with character set and encoding similar to strings. |
| 28 | |
| 29 | <h3>PMCs</h3> |
| 30 | |
| 31 | <strike>* Create a PMC named "IO", the base object for I/O operations.</strike> |
| 32 | |
| 33 | * Create a PMC named "FileHandle", as a core file handle object, which can be subclassed by various HLLs. |
| 34 | |
| 35 | * Create a subclass of "FileHandle" called "StandardIO" or something like that, to hold STDIN, STDOUT, and STDERR. |
| 36 | |
| 37 | * Create a PMC named "Socket", as a core socket object, which can be subclassed by various HLLs. |
| 38 | |
| 39 | <h3>src/io/io.c</h3> |
| 40 | |
| 41 | * Split into two files src/io/file.c and src/io/network.c. (Since the implementation is completely changing, better to create new files with the new function names, rather than changing the names of existing files.) |
| 42 | |
| 43 | <h3>include/parrot/io.h</h3> |
| 44 | |
| 45 | * Rip out the layers structures and macros. (After the migration is complete.) |