8c4b2c35a4
doc: Missing word 'are' in documentation
...
Fix simple spelling mistake in documentation.
fix #5808
2013-12-26 21:17:19 +04:00
691b9ebc8c
fs: add recursive subdirectory support to fs.watch
...
Currently fs.watch does not have an option to specify if a directory
should be recursively watched for events across all subdirectories.
Several file watcher APIs support this. FSEvents on OS X > 10.5 is
one example. libuv has added support for FSEvents, but fs.watch had
no way to specify that a recursive watch was required.
fs.watch now has an additional boolean option 'recursive'. When set
to true, and when supported, fs.watch will return notifications for
the entire directory tree hierarchy rooted at the specified path.
2013-10-31 01:13:44 +04:00
0396b20ff4
Merge remote-tracking branch 'ry/v0.10'
2013-10-28 14:12:00 -07:00
977c54adb5
doc: fs: clarify fs.symlink Windows specific args
2013-10-27 21:02:19 +01:00
61ccaf9a97
Merge remote-tracking branch 'upstream/v0.10'
...
Conflicts:
ChangeLog
deps/uv/ChangeLog
deps/uv/include/uv-darwin.h
deps/uv/src/unix/fsevents.c
deps/uv/src/unix/process.c
deps/uv/src/version.c
doc/api/addons.markdown
doc/api/cluster.markdown
doc/api/http.markdown
lib/http.js
lib/tls.js
src/node_crypto.cc
src/node_http_parser.cc
src/node_version.h
src/pipe_wrap.cc
src/v8abbr.h
src/v8ustack.d
test/simple/test-http-pipeline-flood.js
2013-10-25 11:26:05 -07:00
d97ea06d88
doc: add warning to fs.exists() documentation
...
Warn against the open-if-exists anti-pattern, it's susceptible to
race conditions.
2013-10-05 14:54:57 +02:00
645418e9f1
fs: Expose birthtime on stat objects
...
Just do the best we can with whatever libuv gives us.
Also, document the semantics of `ctime` and the compatibility with
Windows.
2013-08-27 10:42:18 -07:00
b26d346b57
Merge remote-tracking branch 'upstream/v0.10'
...
Conflicts:
deps/v8/test/cctest/test-api.cc
lib/events.js
lib/http.js
2013-08-06 11:59:17 -07:00
6a7be99703
doc: fs.open, fix flag/mode confusion, etc.
...
Flags and modes aren't the same, symlinks are followed in all of the
path but the last component, docs should say something about what the
mode argument is for and when its used, fs.openSync should point to the
function that contains the docs for its args, as fs.writeSync does.
2013-08-05 12:26:09 +02:00
7ca77eaf38
fs: write strings directly to disk
...
Prior, strings would first be converted to a Buffer before being written
to disk. Now the intermediary step has been removed.
Other changes of note:
* Class member "must_free" was added to req_wrap so to track if the
memory needs to be manually cleaned up after use.
* External String Resource support, so the memory will be used directly
instead of copying out the data.
* Docs have been updated to reflect that if position is not a number
then it will assume null. Previously it specified the argument must be
null, but that was not how the code worked. An attempt was made to
only support == null, but there were too many tests that assumed !=
number would be enough.
* Docs update show some of the write/writeSync arguments are optional.
2013-07-30 14:42:30 -07:00
b8c04b921b
Merge remote-tracking branch 'origin/v0.10'
...
Conflicts:
AUTHORS
ChangeLog
deps/uv/ChangeLog
deps/uv/src/version.c
deps/uv/src/win/fs.c
src/node.cc
src/node_crypto.cc
src/node_os.cc
src/node_version.h
2013-07-30 15:19:48 +02:00
4881a6a9a3
doc: clarify fs.read() offset argument
2013-07-28 00:05:10 +02:00
adf9b67e59
Merge remote-tracking branch 'ry/v0.10' into master
...
Conflicts:
ChangeLog
deps/uv/ChangeLog
deps/uv/src/unix/stream.c
deps/uv/src/version.c
deps/v8/build/common.gypi
deps/v8/src/frames.h
deps/v8/src/runtime.cc
deps/v8/test/mjsunit/debug-set-variable-value.js
lib/http.js
src/node_version.h
2013-06-25 11:12:33 -07:00
3fac4157fe
doc: fs: synchronize watchFile/unwatchFile warning
...
One said "if available", the other "if possible". Now they both say
"if possible."
2013-06-24 11:18:24 +02:00
2900f0778a
Merge remote-tracking branch 'ry/v0.10'
...
Conflicts:
ChangeLog
src/node_version.h
2013-05-31 11:52:57 -07:00
36e90da6df
doc: remove `bufferSize` option
...
`bufferSize` option has been removed in b0f6789
2013-05-30 15:10:03 +02:00
61c9f78c63
Merge remote-tracking branch 'ry/v0.10' into master
...
Conflicts:
AUTHORS
ChangeLog
deps/uv/ChangeLog
deps/uv/config-unix.mk
deps/uv/src/unix/stream.c
deps/uv/src/version.c
deps/uv/uv.gyp
src/node.cc
src/node_buffer.cc
src/node_crypto.cc
src/node_version.h
src/stream_wrap.cc
src/stream_wrap.h
2013-05-17 14:04:54 -07:00
4cd643ee2d
doc: fix missing Class in header
2013-05-16 16:56:56 +02:00
b06c82fd88
doc: fix the link to Stream document
2013-05-16 16:56:41 +02:00
259839fe75
Merge branch 'v0.10'
...
Conflicts:
ChangeLog
deps/uv/src/version.c
src/node.h
src/node_crypto.cc
src/node_crypto_bio.cc
src/node_crypto_bio.h
src/node_object_wrap.h
src/node_version.h
2013-04-12 11:30:11 -04:00
e8c01739cd
doc: document linux pwrite() bug
...
On Linux, positional writes don't work when the file is opened in
append mode. The kernel ignores the position argument and always
appends the data to the end of the file.
To quote the man page:
POSIX requires that opening a file with the O_APPEND flag should have
no affect on the location at which pwrite() writes data. However, on
Linux, if a file is opened with O_APPEND, pwrite() appends data to the
end of the file, regardless of the value of offset.
2013-04-08 00:43:30 +02:00
889fec3cc8
doc: typo fixes
2013-04-01 18:44:02 +02:00
2f88272ba2
Merge remote-tracking branch 'ry/v0.10' into master
...
Conflicts:
src/node.cc
src/node_version.h
2013-03-21 10:52:01 -07:00
1f53cfdeae
doc: don't mark fs callbacks as optional
...
Refs #5005 , #5008
2013-03-14 13:06:49 -07:00
5e140b33e5
Revert "fs: Missing cb errors are deprecated, not a throw"
...
This reverts commits 6bd8b7e540fa05e8a270
2013-03-13 15:51:32 -07:00
fa05e8a270
doc: implicit fs callbacks don't throw in v0.10
...
But they will in v0.12.
Re #5005 .
2013-03-13 15:34:18 -07:00
0928a526dd
fs: Support mode/flag options to read/append/writeFile
...
Fix #4841
2013-03-01 09:48:57 -08:00
dcaebec208
fs: add autoClose=true option to fs.createReadStream
2012-12-20 11:25:39 +01:00
a80434736b
fs: fix 'object is not a function' callback errors
...
Use a default callback if the user omitted one. Avoids errors like the one
below:
fs.js:777
if (err) return callback(err);
^
TypeError: object is not a function
at fs.appendFile (fs.js:777:21)
at Object.oncomplete (fs.js:297:15)
This commit fixes the behavior of fs.lchmod(), fs.lchown() and fs.readFile()
when the callback is omitted. Before, they silently swallowed errors.
Fixes #4352 .
2012-12-04 08:05:55 +01:00
d0227b0308
Merge remote-tracking branch 'origin/v0.8'
...
Conflicts:
deps/openssl/openssl.gyp
2012-10-21 23:06:48 +02:00
a7b5938715
docs: fix copy and paste error
2012-10-14 14:47:02 +02:00
bb207c2827
Merge remote-tracking branch 'ry/v0.8' into master
...
Conflicts:
ChangeLog
src/node_version.h
test/simple/test-util-inspect.js
2012-09-12 15:13:07 -07:00
58a5bc1ec7
doc: fs: clarfify fs.watch() documentation
...
fs.watch() is implemented on all supported platforms but, depending on the
object being watched, doesn't always work reliably (or at all).
Fixes #4005 .
2012-09-12 17:08:32 +02:00
168a555780
fs: fix naming of truncate/ftruncate functions
...
For backwards compatibility, fs.truncate(<number>) will proxy to
fs.ftruncate.
Fix #3805
2012-08-06 08:40:56 -07:00
8146f2e607
doc: clarify fs.symlink and fs.symlinkSync parameters
2012-07-10 16:36:08 +02:00
5b5362aa8d
fs: make unwatchFile() remove a specific listener
...
Before this commit, `fs.unwatchFile(path)` removed *all* listeners for `path`.
The function is overloaded now: `fs.unwatchFile(path)` still removes all
listeners, but `fs.unwatchFile(path, cb)` lets you remove a specific listener.
Fixes #3660 .
2012-07-09 15:48:43 +02:00
b9abb64fbb
doc: fs.lchmod() is only available on OS X
2012-06-30 02:23:31 +02:00
be3afd0bec
doc: remove references to deprecated fs api
...
The string-based versions of fs.read() and fs.write() have been deprecated
since before v0.2.0.
2012-06-28 03:50:48 +02:00
8708bb0280
doc: update fs.watchFile() docs
2012-06-21 15:03:49 +02:00
39e25528eb
windows: enable creating directory junctions with fs.symlink
2012-05-24 01:15:15 -07:00
a039bad299
fs.watch should not require a listener arguments
...
Since fs.watch returns an event emitter where the change event is exactly
the same as the listener callback, the argument should be required
2012-05-19 18:58:28 -03:00
18b94ea838
doc: improve fs.open() docs
2012-05-17 06:18:25 +02:00
ccc4e547ea
doc: document fs 'rs+' open mode
2012-05-17 06:05:33 +02:00
dfcdd5b8aa
fs: add sync open flags 'rs' and 'rs+'
2012-05-16 00:14:46 +02:00
6ba3e68bd2
doc: correct return value of string-based fs.readSync
...
Closes #2330
2012-05-01 15:19:36 +02:00
7cd1690f3d
doc: add cache argument to fs.realpath()
2012-04-17 14:17:41 +02:00
0a83b78ba8
docs: more explicit argument names in fs
2012-04-16 16:31:02 +02:00
0dd8e0167d
doc: document fs.createReadStream() encodings
...
Fixes #2700 .
2012-03-26 00:25:45 +02:00
6628a3b6ea
doc: fix # links from (and within) api/fs
2012-03-16 15:42:26 +01:00
31ad1d29c7
Merge branch 'v0.6'
2012-03-08 03:14:48 +01:00
8258bd467a
doc: 'filename' arg not guaranteed ever.
2012-03-05 10:28:47 -08:00
1d5b6f26fe
Merge remote-tracking branch 'ry/v0.6' into v0.6-merge
...
Conflicts:
ChangeLog
Makefile
deps/npm/AUTHORS
deps/npm/html/api/bin.html
deps/npm/html/api/bugs.html
deps/npm/html/api/commands.html
deps/npm/html/api/config.html
deps/npm/html/api/deprecate.html
deps/npm/html/api/docs.html
deps/npm/html/api/edit.html
deps/npm/html/api/explore.html
deps/npm/html/api/help-search.html
deps/npm/html/api/init.html
deps/npm/html/api/install.html
deps/npm/html/api/link.html
deps/npm/html/api/load.html
deps/npm/html/api/ls.html
deps/npm/html/api/npm.html
deps/npm/html/api/outdated.html
deps/npm/html/api/owner.html
deps/npm/html/api/pack.html
deps/npm/html/api/prefix.html
deps/npm/html/api/prune.html
deps/npm/html/api/publish.html
deps/npm/html/api/rebuild.html
deps/npm/html/api/restart.html
deps/npm/html/api/root.html
deps/npm/html/api/run-script.html
deps/npm/html/api/search.html
deps/npm/html/api/shrinkwrap.html
deps/npm/html/api/start.html
deps/npm/html/api/stop.html
deps/npm/html/api/submodule.html
deps/npm/html/api/tag.html
deps/npm/html/api/test.html
deps/npm/html/api/uninstall.html
deps/npm/html/api/unpublish.html
deps/npm/html/api/update.html
deps/npm/html/api/version.html
deps/npm/html/api/view.html
deps/npm/html/api/whoami.html
deps/npm/html/doc/README.html
deps/npm/html/doc/adduser.html
deps/npm/html/doc/bin.html
deps/npm/html/doc/bugs.html
deps/npm/html/doc/build.html
deps/npm/html/doc/bundle.html
deps/npm/html/doc/cache.html
deps/npm/html/doc/changelog.html
deps/npm/html/doc/coding-style.html
deps/npm/html/doc/completion.html
deps/npm/html/doc/config.html
deps/npm/html/doc/deprecate.html
deps/npm/html/doc/developers.html
deps/npm/html/doc/disputes.html
deps/npm/html/doc/docs.html
deps/npm/html/doc/edit.html
deps/npm/html/doc/explore.html
deps/npm/html/doc/faq.html
deps/npm/html/doc/folders.html
deps/npm/html/doc/help-search.html
deps/npm/html/doc/help.html
deps/npm/html/doc/index.html
deps/npm/html/doc/init.html
deps/npm/html/doc/install.html
deps/npm/html/doc/json.html
deps/npm/html/doc/link.html
deps/npm/html/doc/list.html
deps/npm/html/doc/npm.html
deps/npm/html/doc/outdated.html
deps/npm/html/doc/owner.html
deps/npm/html/doc/pack.html
deps/npm/html/doc/prefix.html
deps/npm/html/doc/prune.html
deps/npm/html/doc/publish.html
deps/npm/html/doc/rebuild.html
deps/npm/html/doc/registry.html
deps/npm/html/doc/removing-npm.html
deps/npm/html/doc/restart.html
deps/npm/html/doc/root.html
deps/npm/html/doc/run-script.html
deps/npm/html/doc/scripts.html
deps/npm/html/doc/search.html
deps/npm/html/doc/semver.html
deps/npm/html/doc/shrinkwrap.html
deps/npm/html/doc/star.html
deps/npm/html/doc/start.html
deps/npm/html/doc/stop.html
deps/npm/html/doc/submodule.html
deps/npm/html/doc/tag.html
deps/npm/html/doc/test.html
deps/npm/html/doc/uninstall.html
deps/npm/html/doc/unpublish.html
deps/npm/html/doc/update.html
deps/npm/html/doc/version.html
deps/npm/html/doc/view.html
deps/npm/html/doc/whoami.html
deps/npm/lib/install.js
deps/npm/lib/ls.js
deps/npm/man/man1/npm.1
deps/npm/man/man1/shrinkwrap.1
deps/npm/man/man3/npm.3
deps/npm/man/man3/shrinkwrap.3
deps/npm/node_modules/request/main.js
deps/npm/node_modules/request/package.json
deps/npm/package.json
deps/uv/src/unix/core.c
deps/v8/src/conversions-inl.h
deps/v8/src/elements.cc
deps/v8/src/version.cc
doc/about/index.html
doc/api/assert.markdown
doc/api/child_process.markdown
doc/api/cluster.markdown
doc/api/crypto.markdown
doc/api/debugger.markdown
doc/api/dgram.markdown
doc/api/dns.markdown
doc/api/documentation.markdown
doc/api/events.markdown
doc/api/fs.markdown
doc/api/globals.markdown
doc/api/http.markdown
doc/api/https.markdown
doc/api/modules.markdown
doc/api/net.markdown
doc/api/os.markdown
doc/api/path.markdown
doc/api/process.markdown
doc/api/querystring.markdown
doc/api/readline.markdown
doc/api/stdio.markdown
doc/api/stream.markdown
doc/api/timers.markdown
doc/api/tls.markdown
doc/api/tty.markdown
doc/api/url.markdown
doc/api/util.markdown
doc/api/vm.markdown
doc/api/zlib.markdown
doc/api_assets/style.css
doc/community/index.html
doc/index.html
doc/logos/index.html
doc/template.html
src/node_version.h
tools/doc/html.js
tools/gyp/test/mac/app-bundle/empty.c
2012-03-03 23:38:52 -08:00
a42b4ad44e
doc: Typo'd some stability indicators.
2012-03-03 22:12:43 -08:00
1d59a73fef
doc: Change 'file_system' module to 'fs' as it should be
2012-03-03 17:14:06 -08:00
2e487379ad
doc: Stability and Caveats for fs.watch/watchFile
2012-03-03 17:04:02 -08:00
f70be203e4
doc: indentation and structure in fs.markdown
2012-03-03 17:04:02 -08:00
2d44dcc8be
doc: Add stability indicators to documentation
2012-03-03 17:03:52 -08:00
7bfa5cf284
s/streams/stream/
2012-02-29 16:04:55 -08:00
2a6ff3f56b
doc refactor: fs
2012-02-29 16:04:51 -08:00
f9df88c6da
s/streams/stream/
2012-02-27 11:18:10 -08:00
40190b7c92
doc refactor: fs
2012-02-27 11:14:33 -08:00
279e7e7341
fs: add O_EXCL support, exclusive open file
2012-01-31 14:29:32 +01:00
e10ed097cb
path fs: move `path.exists*` to `fs.exists*`
...
`path.exists*` functions show a deprecation warning and call functions
from `fs`. They should be removed later.
test: fix references to `path.exists*` in tests
test fs: add test for `fs.exists` and `fs.existsSync`
doc: reflect moving `path.exists*` to `fs`
2012-01-21 14:37:14 +01:00
aa67b1f375
fs: add appendFile() and appendFileSync() functions
2012-01-05 21:39:57 +01:00
e1c043f43a
docs: fix docs to not suggest variable leaks
...
Fixes #2106 .
2011-12-27 17:43:58 +09:00
d6bae2cb95
document mode argument for fs.symlink
2011-12-16 11:16:33 -08:00
06d71ad457
docs: document the `persistent` option for `fs.watch` and `fs.watchFile`
2011-11-18 00:00:01 +01:00
c1472ac105
docs: fix some minor typos in the fs documentation
...
* fchmodSync: replace 'path' with 'fd'
* lchmod: replace 'fd' with 'path'
* utimes, futimes, fsync: mark 'callback' as optional
2011-11-04 23:53:01 +01:00
44a5452a4f
docs: fix typo in the documented fchown signature
2011-11-04 20:10:21 +01:00
a6dbe0ff23
docs: make fs.mkdir()'s mode argument an option.
2011-11-03 20:04:22 +09:00
06190928c0
doc: Correct blatantly wrong futimes documentation
2011-10-31 16:31:59 -07:00
00aa8935d7
docs: improvement fs, http and https
2011-10-22 23:40:15 +09:00
493d3b9f7c
Merge remote branch 'origin/v0.4'
...
Conflicts:
ChangeLog
Makefile
deps/libev/wscript
doc/index.html
doc/template.html
lib/net.js
src/node_version.h
src/platform_cygwin.cc
test/pummel/test-net-write-callbacks.js
test/simple/test-buffer.js
2011-10-21 18:02:30 -07:00
f243ca199b
docs: mention util instead of sys
2011-10-13 05:06:42 +02:00
39987cbc80
docs: improved fs.Stats section in API documentation
2011-10-13 02:25:30 +02:00
f164704383
fs.watch documentation
2011-10-11 18:28:16 -07:00
eb40dcb097
Fix typo for fs.write docs
...
Fixes #1843 .
2011-10-09 16:51:42 +09:00
b93a7cc99e
docs: add links
2011-09-20 15:50:36 +09:00
e58c036c27
fs: add positioned file writing feature to fs.WriteStream
...
Patterned on same feature in ReadStream; a small bit of new code added
plus two refactorings of previous code; added two test files.
Fixes #1645 .
2011-09-12 14:57:49 +09:00
4cf0ce5bb4
docs: typos and minor edits in several modules
...
Mostly quite minor edits. Those possibly of more interest are:
emitter.setMaxListeners(n)
That the limit is per event name for an emitter.
fs.readlink()
Not a path, but rather the symbolic link's string value, which
would be at best a partial path, certainly not a 'resolvedPath'
global.__filename
This may be "well-known" but this is a full path to the module
that referencing code is running in. It is not the main program's
path, unless you are in the main program. Each module knows only
its own path.
server.listen(port,...)
I actually needed this functionality... "gimme just _any_ next port"
stream.end()
stream.destroy()
Yeah, everybody knows what happens to the queued data, but let's
make it *really* explicit for the first readers.
2011-09-06 18:19:41 +02:00
8320af7ef3
Merge remote branch 'origin/v0.4'
...
Conflicts:
doc/api/tls.markdown
2011-08-17 13:25:44 -07:00
e8d268fd5f
Fix docs for fs.*chown
...
Fix bad parameters of fs.chown[Sync], fs.fchown[Sync] and
fs.lchown[Sync] in documentation.
Fixes #1533 .
2011-08-15 22:45:41 +09:00
7ba30a4c2e
Small changes for fs.watchFile. Fixed broken markdown. Changed variable `f` to a proper filename.
...
Fixes #1507 .
2011-08-12 21:57:58 +09:00
0d8d04e585
Correct code span
...
Fixes #1489 .
2011-08-11 16:29:37 +09:00
25c1a5e804
added information about relative paths in File System module
2011-07-15 09:54:56 -07:00
9a16f1c7d0
added information about relative paths in File System module
2011-07-15 09:54:20 -07:00
041c983290
Merge branch 'v0.4'
...
Conflicts:
deps/libev/wscript
doc/api/modules.markdown
2011-07-14 15:52:08 -07:00
7e8735b3fe
Doc improvements. Explained the flags of fs.open().
...
Fixes #1268 .
2011-07-09 17:09:26 +09:00
87b6dc21c8
Doc improvements
...
moved 'continue' event from http.Agent to http.ClientRequest.
added 'close' event to http.ClientResponse.
added 'open' event to fs.ReadStream.
Fixes #1169 .
2011-07-09 13:23:28 +09:00
fc80ee947a
docs for chown/chmod
2011-07-08 22:41:30 +02:00
d6188bdd27
Document behaviour of the `encoding` parameter of fs.writeFile().
...
Fixes #401 .
2011-07-04 16:26:46 +02:00
b6a742d76f
Merge branch 'v0.4'
2011-06-03 16:37:56 +02:00
0cb4484d43
Doc improvements
...
Fixes #1147 .
Fixes #1139 .
Fixes #1126 .
Thanks ctide, kext, disfated.
2011-06-03 13:27:35 +02:00
c33790262b
Added docs for fs.fsync and fs.fsyncSync
...
Thanks baudehlo. Fixes #1009 .
2011-05-06 16:02:22 -07:00
efca5f8e78
docs for chown/chmod
2011-04-20 16:04:46 -07:00
80711b0ff9
Feature: WriteStream#bytesWritten property
...
Implemented a new property for writable file streams that keeps track
of the bytes written (not queued). This helps when you are piping
another stream to a file, and would like to know how big the file is
without having to issue another stat call.
closes #930
2011-04-14 14:26:46 -07:00
598792ba91
Merge branch 'v0.4'
...
Conflicts:
src/platform_sunos.cc
test/simple/test-os.js
2011-04-14 01:11:21 +00:00
301f53c2aa
Allow omission of end option for range reads
...
Problem: Sometimes it is useful to read a file from a certain position
to it's end. The current implementation was already perfectly capable
of this, but decided to throw an error when the user tried to omit
the end option. The only way to do this, was to pass {end: Infinity}.
Solution: Automatically assume {end: Infinity} when omitted, and remove
the previous exception thrown. Also updated the docs.
closes #801 .
2011-04-13 09:46:28 -07:00
bfa9db9dd6
Merge branch 'v0.4'
...
Conflicts:
src/node_version.h
test/simple/test-buffer.js
2011-04-03 23:42:56 -07:00
e35b2d9617
docs: fs.read/write() cb()s now receive buffer
2011-03-29 12:23:42 -07:00
Benjamin Waters
Nick Simmons
isaacs
Phillip Alexander
Timothy J Fontaine
Ben Noordhuis
Sam Roberts
Trevor Norris
Kiyoshi Nomo
Ryuichi Okumura
Fedor Indutny
Kyle Robinson Young
koichik
Farid Neshat
Jan Lehnardt
Ivan Torres
Igor Zinkovsky
Andreas Madsen
Kevin Bowman
Zachary Scott
Rod Vagg
Bert Belder
Maciej Małecki
Emerson Macedo
Trevor Burnham
Jacob H.C. Kragh
Ryan Dahl
Brian White
Ilya Dmitrichenko
Thomas Shinnick
Mickaël Delahaye
Arnout Kazemier
Christopher Wright
Wojciech Wnętrzak
Felix Geisendörfer
Jorge Chamorro Bieling