diff options
author | Nick Schonning <nschonni@gmail.com> | 2019-10-02 00:31:57 -0400 |
---|---|---|
committer | Rich Trott <rtrott@gmail.com> | 2019-10-03 22:57:33 -0700 |
commit | 24011de9071fcd092fab29719d3fa8269a95288a (patch) | |
tree | 47241142f5cc13c3dbf3f6bf1fdd94984b732edd /doc/api/fs.md | |
parent | 24d43ca1b1d65c95f22a14197350e0803adf918b (diff) | |
download | android-node-v8-24011de9071fcd092fab29719d3fa8269a95288a.tar.gz android-node-v8-24011de9071fcd092fab29719d3fa8269a95288a.tar.bz2 android-node-v8-24011de9071fcd092fab29719d3fa8269a95288a.zip |
doc: add explicit bracket for markdown reference links
Use explicit trailing `[]` for reference markdown links to prevent
implicit links when references are added to documents.
PR-URL: https://github.com/nodejs/node/pull/29808
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: David Carlier <devnexen@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Diffstat (limited to 'doc/api/fs.md')
-rw-r--r-- | doc/api/fs.md | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/doc/api/fs.md b/doc/api/fs.md index 7ea6835387..c22e169f1c 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -3133,7 +3133,7 @@ Using `fs.stat()` to check for the existence of a file before calling Instead, user code should open/read/write the file directly and handle the error raised if the file is not available. -To check if a file exists without manipulating it afterwards, [`fs.access()`] +To check if a file exists without manipulating it afterwards, [`fs.access()`][] is recommended. For example, given the following folder structure: @@ -3541,12 +3541,13 @@ The recursive option is only supported on macOS and Windows. This feature depends on the underlying operating system providing a way to be notified of filesystem changes. -* On Linux systems, this uses [`inotify(7)`]. -* On BSD systems, this uses [`kqueue(2)`]. -* On macOS, this uses [`kqueue(2)`] for files and [`FSEvents`] for directories. -* On SunOS systems (including Solaris and SmartOS), this uses [`event ports`]. -* On Windows systems, this feature depends on [`ReadDirectoryChangesW`]. -* On Aix systems, this feature depends on [`AHAFS`], which must be enabled. +* On Linux systems, this uses [`inotify(7)`][]. +* On BSD systems, this uses [`kqueue(2)`][]. +* On macOS, this uses [`kqueue(2)`][] for files and [`FSEvents`][] for + directories. +* On SunOS systems (including Solaris and SmartOS), this uses [`event ports`][]. +* On Windows systems, this feature depends on [`ReadDirectoryChangesW`][]. +* On Aix systems, this feature depends on [`AHAFS`][], which must be enabled. If the underlying functionality is not available for some reason, then `fs.watch` will not be able to function. For example, watching files or |