Annotation For xvfs-core.c

Origin for each line in xvfs-core.c from check-in 32b55a907b:

69e476dcd5 2019-05-02        rkeene: #include <xvfs-core.h>
69e476dcd5 2019-05-02        rkeene: #include <tcl.h>
69e476dcd5 2019-05-02        rkeene: 
32b55a907b 2019-05-02        rkeene: /*
32b55a907b 2019-05-02        rkeene:  * There are three (3) modes of operation for Xvfs_Register:
32b55a907b 2019-05-02        rkeene:  *    1. standalone -- We register our own Tcl_Filesystem
32b55a907b 2019-05-02        rkeene:  *                     and handle requests under `//xvfs:/<fsName>`
32b55a907b 2019-05-02        rkeene:  *    2. client -- A single Tcl_Filesystem is registered for the
32b55a907b 2019-05-02        rkeene:  *                 interp to handle requests under `//xvfs:/` which
32b55a907b 2019-05-02        rkeene:  *                 then dispatches to the appropriate registered
32b55a907b 2019-05-02        rkeene:  *                 handler
32b55a907b 2019-05-02        rkeene:  *    3. flexible -- Attempts to find a core Xvfs instance for the
32b55a907b 2019-05-02        rkeene:  *                   process at runtime, if found do #2, otherwise
32b55a907b 2019-05-02        rkeene:  *                   fallback to #1
32b55a907b 2019-05-02        rkeene:  *
32b55a907b 2019-05-02        rkeene:  */
32b55a907b 2019-05-02        rkeene: static int Xvfs_Register_Standalone(Tcl_Interp *interp, const char *fsName, int protocolVersion, xvfs_proc_getChildren_t getChildrenProc, xvfs_proc_getData_t getDataProc) {
69e476dcd5 2019-05-02        rkeene: 	Tcl_SetResult(interp, "Not implemented", NULL);
69e476dcd5 2019-05-02        rkeene: 	return(TCL_ERROR);
32b55a907b 2019-05-02        rkeene: }
32b55a907b 2019-05-02        rkeene: 
32b55a907b 2019-05-02        rkeene: int Xvfs_Register(Tcl_Interp *interp, const char *fsName, int protocolVersion, xvfs_proc_getChildren_t getChildrenProc, xvfs_proc_getData_t getDataProc) {
32b55a907b 2019-05-02        rkeene: 	return(Xvfs_Register_Standalone(interp, fsName, protocolVersion, getChildrenProc, getDataProc));
69e476dcd5 2019-05-02        rkeene: }