Improvements to the documentation of the sqlite3_db_filename() interface.

FossilOrigin-Name: 1c45b2a0c055f6fc5da9d00ae2e9171099d904d4

1 files changed, 5 insertions, 0 deletions

diff --git a/src/sqlite.h.in b/src/sqlite.h.in
index f70893a3d..75241da42 100644
--- a/src/sqlite.h.in
+++ b/src/sqlite.h.in
@@ -4381,6 +4381,11 @@ sqlite3 *sqlite3_db_handle(sqlite3_stmt*);
 ** has the name "main".  If there is no attached database N on the database
 ** connection D, or if database N is a temporary or in-memory database, then
 ** a NULL pointer is returned.
+**
+** ^The filename returned by this function is the output of the
+** xFullPathname method of the [VFS].  ^In other words, the filename
+** will be an absolute pathname, even if the filename used
+** to open the database originally was a URI or relative pathname.
 */
 const char *sqlite3_db_filename(sqlite3 *db, const char *zDbName);