Add a note to the API documentation emphasizing that the filename argument

to sqlite3_open() must be UTF-8.  Tickets #1713, #1533. (CVS 3151)

FossilOrigin-Name: b0111f43e4f82f0c3144d1e6348d9e5fae504d95

manifest

@@ -1,5 +1,5 @@
-C Make\ssure\sthe\srootpage\svalues\sin\sthe\ssymbol\stable\sare\scorrectly\supdated\nwhen\sdropping\stables\sand\sindices\sin\sautocommit\smode.\s\sTicket\s#1728.\s(CVS\s3150)
-D 2006-03-24T03:36:26
+C Add\sa\snote\sto\sthe\sAPI\sdocumentation\semphasizing\sthat\sthe\sfilename\sargument\nto\ssqlite3_open()\smust\sbe\sUTF-8.\s\sTickets\s#1713,\s#1533.\s(CVS\s3151)
+D 2006-03-25T14:03:42
 F Makefile.in 5d8dff443383918b700e495de42ec65bc1c8865b
 F Makefile.linux-gcc 74ba0eadf88748a9ce3fd03d2a3ede2e6715baec
 F README 9c4e2d6706bdcc3efdd773ce752a8cdab4f90028
@@ -311,7 +311,7 @@ F www/audit.tcl 90e09d580f79c7efec0c7d6f447b7ec5c2dce5c0
 F www/autoinc.tcl b357f5ba954b046ee35392ce0f884a2fcfcdea06
 F www/c_interface.tcl b51b08591554c16a0c3ef718364a508ac25abc7e
 F www/capi3.tcl 7a7cc225fe02eb7ab861a6019b08baa0014409e1
-F www/capi3ref.tcl 196c44b034995cc50cfc27eda3cccf88e1941e0f
+F www/capi3ref.tcl fcdd46f05a1474c2e811a6842d5f962e286bb646
 F www/changes.tcl 06e23e1286bee6753d405047f0ccb5c2ba8ca555
 F www/common.tcl 14d121c28532ad20c3e349caa4db708b0b822083
 F www/compile.tcl 276546d7eb445add5a867193bbd80f6919a6b084
@@ -355,7 +355,7 @@ F www/tclsqlite.tcl bb0d1357328a42b1993d78573e587c6dcbc964b9
 F www/vdbe.tcl 87a31ace769f20d3627a64fa1fade7fed47b90d0
 F www/version3.tcl 890248cf7b70e60c383b0e84d77d5132b3ead42b
 F www/whentouse.tcl 97e2b5cd296f7d8057e11f44427dea8a4c2db513
-P 986208a364ce0ba81456b54e6561a277fb19309c
-R 2e778dd94b82fbaeaf00aeb2c0a3a8c9
+P 1c582dd11304f4421da2fa451f52b313b541270e
+R 95b27b76724fa6c680d52e13fce463da
 U drh
-Z 5880b394a81520a397b49dc9bfcb72dd
+Z 7381e17e9519044ef5ca44deeaa6dc0e

manifest.uuid

@@ -1 +1 @@
-1c582dd11304f4421da2fa451f52b313b541270e
+b0111f43e4f82f0c3144d1e6348d9e5fae504d95

www/capi3ref.tcl

@@ -1,4 +1,4 @@
-set rcsid {$Id: capi3ref.tcl,v 1.35 2006/03/13 14:31:39 drh Exp $}
+set rcsid {$Id: capi3ref.tcl,v 1.36 2006/03/25 14:03:42 drh Exp $}
 source common.tcl
 header {C/C++ Interface For SQLite Version 3}
 puts {
@@ -988,6 +988,11 @@ int sqlite3_open16(
  pass the resulting database handle off to another thread to use.  This
  restriction is due to goofy design decisions (bugs?) in the way some
  threading implementations interact with file locks.
+
+ Note to windows users:  The encoding used for the filename argument
+ of sqlite3_open() must be UTF-8, not whatever codepage is currently
+ defined.  Filenames containing international characters must be converted
+ to UTF-8 prior to passing them into sqlite3_open().
 }
 
 api {} {