summaryrefslogtreecommitdiffhomepage
path: root/lib/fs.c
diff options
context:
space:
mode:
Diffstat (limited to 'lib/fs.c')
-rw-r--r--lib/fs.c28
1 files changed, 23 insertions, 5 deletions
diff --git a/lib/fs.c b/lib/fs.c
index 015228a..45cef36 100644
--- a/lib/fs.c
+++ b/lib/fs.c
@@ -15,7 +15,9 @@
*/
/**
- * This module provides functions for interacting with the file system.
+ * # Filesystem Access
+ *
+ * The `fs` module provides functions for interacting with the file system.
*
* Functions can be individually imported and directly accessed using the
* {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#named_import named import}
@@ -256,7 +258,11 @@ uc_fs_fileno_common(uc_vm_t *vm, size_t nargs, const char *type)
/**
* Represents a handle for interacting with a program launched by `popen()`.
*
- * @namespace module:fs.proc
+ * @class module:fs.proc
+ * @hideconstructor
+ *
+ * @see {@link module:fs#popen|popen()}
+ *
* @example
*
* const handle = popen(…);
@@ -522,9 +528,17 @@ uc_fs_popen(uc_vm_t *vm, size_t nargs)
/**
- * Represents a handle for interacting with a file opened by `open()`.
+ * Represents a handle for interacting with a file opened by one of the file
+ * open functions.
+ *
+ * @class module:fs.file
+ * @hideconstructor
+ *
+ * @see {@link module:fs#open|open()}
+ * @see {@link module:fs#fdopen|fdopen()}
+ * @see {@link module:fs#mkstemp|mkstemp()}
+ * @see {@link module:fs#pipe|pipe()}
*
- * @namespace module:fs.file
* @example
*
* const handle = open(…);
@@ -1044,7 +1058,11 @@ uc_fs_fdopen(uc_vm_t *vm, size_t nargs)
/**
* Represents a handle for interacting with a directory opened by `opendir()`.
*
- * @namespace module:fs.dir
+ * @class module:fs.dir
+ * @hideconstructor
+ *
+ * @see {@link module:fs#opendir|opendir()}
+ *
* @example
*
* const handle = opendir(…);