Skip to content

Commit 5629fd5

Browse files
committed
Add doc note about 'raws' encoding
1 parent d03c7e3 commit 5629fd5

File tree

3 files changed

+15
-20
lines changed

3 files changed

+15
-20
lines changed

doc/api.html

+7-7
Original file line numberDiff line numberDiff line change
@@ -55,12 +55,12 @@ <h2 id="_synopsis">SYNOPSIS</h2>
5555
</div>
5656
<h2 id="_api">API</h2>
5757
<div class="sectionbody">
58-
<div class="paragraph"><p>Node supports 3 byte-string encodings: ASCII (<tt>"ascii"</tt>), UTF-8 (<tt>"utf8"</tt>),
59-
and raw binary (<tt>"raw"</tt>). It uses strings to represent ASCII and UTF-8
60-
encoded data. For the moment, arrays of integers are used to represent raw
61-
binary data&#8212;this representation is rather inefficient. This will
62-
change in the future, when
63-
<a href="http://code.google.com/p/v8/issues/detail?id=270">V8 supports Blob objects</a>.</p></div>
58+
<div class="paragraph"><p>Node supports 4 byte-string encodings. ASCII (<tt>"ascii"</tt>), UTF-8 (<tt>"utf8"</tt>)
59+
both use the string object, obviously. Then two "raw binary" encodings - one
60+
uses an array of integers (<tt>"raw"</tt>) and the other uses a string (<tt>"raws"</tt>).
61+
Neither raw encodings are perfect and thier implemenations are rather
62+
inefficient. Hopefully the raw encoding situation will improve in the
63+
future.</p></div>
6464
<div class="paragraph"><p>Unless otherwise noted, functions are all asynchronous and do not block
6565
execution.</p></div>
6666
<h3 id="_helpers">Helpers</h3><div style="clear:left"></div>
@@ -1863,7 +1863,7 @@ <h2 id="_extension_api">Extension API</h2>
18631863
<div id="footer">
18641864
<div id="footer-text">
18651865
Version 0.1.9<br />
1866-
Last updated 2009-09-11 13:40:01 CEST
1866+
Last updated 2009-09-11 20:58:54 CEST
18671867
</div>
18681868
</div>
18691869
</body>

doc/api.txt

+6-6
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,12 @@ Server running at http://127.0.0.1:8000/
3838

3939
== API
4040

41-
Node supports 3 byte-string encodings: ASCII (+"ascii"+), UTF-8 (+"utf8"+),
42-
and raw binary (+"raw"+). It uses strings to represent ASCII and UTF-8
43-
encoded data. For the moment, arrays of integers are used to represent raw
44-
binary data--this representation is rather inefficient. This will
45-
change in the future, when
46-
http://code.google.com/p/v8/issues/detail?id=270[V8 supports Blob objects].
41+
Node supports 4 byte-string encodings. ASCII (+"ascii"+), UTF-8 (+"utf8"+)
42+
both use the string object, obviously. Then two "raw binary" encodings - one
43+
uses an array of integers (+"raw"+) and the other uses a string (+"raws"+).
44+
Neither raw encodings are perfect and thier implemenations are rather
45+
inefficient. Hopefully the raw encoding situation will improve in the
46+
future.
4747

4848
Unless otherwise noted, functions are all asynchronous and do not block
4949
execution.

doc/node.1

+2-7
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Server running at http://127\.0\.0\.1:8000/
3838
.fi
3939
.RE
4040
.SH "API"
41-
Node supports 3 byte\-string encodings: ASCII ("ascii"), UTF\-8 ("utf8"), and raw binary ("raw")\. It uses strings to represent ASCII and UTF\-8 encoded data\. For the moment, arrays of integers are used to represent raw binary data\(emthis representation is rather inefficient\. This will change in the future, when V8 supports Blob objects\.
41+
Node supports 4 byte\-string encodings\. ASCII ("ascii"), UTF\-8 ("utf8") both use the string object, obviously\. Then two "raw binary" encodings \- one uses an array of integers ("raw") and the other uses a string ("raws")\. Neither raw encodings are perfect and thier implemenations are rather inefficient\. Hopefully the raw encoding situation will improve in the future\.
4242
.sp
4343
Unless otherwise noted, functions are all asynchronous and do not block execution\.
4444
.sp
@@ -1774,16 +1774,11 @@ Further documentation will come soon\. For now see the source code of node_postg
17741774
.sp
17751775
.SH "NOTES"
17761776
.IP " 1." 4
1777-
V8 supports Blob objects
1778-
.RS 4
1779-
\%http://code.google.com/p/v8/issues/detail?id=270
1780-
.RE
1781-
.IP " 2." 4
17821777
here
17831778
.RS 4
17841779
\%http:/cvs.schmorp.de/libev/ev.html
17851780
.RE
1786-
.IP " 3." 4
1781+
.IP " 2." 4
17871782
node_postgres
17881783
.RS 4
17891784
\%http://github.com/ry/node_postgres

0 commit comments

Comments
 (0)