diff dynload/dynload.3 @ 308:7c6f19d42b31

dynload UTF-8 support for library paths: - added missing support to windows - added test code for all platforms to dynload_plain - doc update
author Tassilo Philipp
date Thu, 24 Oct 2019 23:19:20 +0200
parents 5cfe4322c500
children 3840e0188520
line wrap: on
line diff
--- a/dynload/dynload.3	Mon Apr 29 11:51:30 2019 +0200
+++ b/dynload/dynload.3	Thu Oct 24 23:19:20 2019 +0200
@@ -54,7 +54,9 @@
 .Fn dlFindSymbol
 calls. Passing a null pointer for the
 .Ar libpath
-argument is valid, and returns a handle to the main executable of the calling code. Also, searching libraries in library paths (e.g. by just passing the library's leaf name) should work, however, they are OS specific. Returns a null pointer on error.
+argument is valid, and returns a handle to the main executable of the calling code. Also, searching libraries in library paths (e.g. by just passing the library's leaf name) should work, however, they are OS specific. The
+.Ar libPath
+argument is expected to be UTF-8 encoded. Returns a null pointer on error.
 .Pp
 .Fn dlFreeLibrary 
 frees the loaded library with handle
@@ -74,9 +76,9 @@
 .Ar sOut
 is a pointer to a buffer of size
 .Ar bufSize
-(in bytes), to hold the output string. The return value is the size of the buffer (in bytes) needed to hold the null-terminated string, or 0 if it can't be looked up. If
+(in bytes), to hold the output string (UTF-8 encoded). The return value is the size of the buffer (in bytes) needed to hold the null-terminated string, or 0 if it can't be looked up. If
 .Ar bufSize
->= return value > 1, a null-terminted string with the path to the library should be in
+>= return value >= 1, a null-terminted string with the path to the library should be in
 .Ar sOut .
 If it returns 0, the library name wasn't able to be found. Please note that this might happen in some rare cases, so make sure to always check.
 .Pp