# HG changeset patch
# User Tassilo Philipp
# Date 1586801334 -7200
# Node ID 8c8f848131c630428b4d33f4ca062bb292f765f8
# Parent  b84064293541b91cdb8d3cf907d06808d58c5dbb
- version bump
- better doc
- made calling convention mode reset by default, as only way to specify convention used is via signature string

diff -r b84064293541 -r 8c8f848131c6 python/pydc/README.txt
--- a/python/pydc/README.txt	Mon Apr 13 16:28:47 2020 +0200
+++ b/python/pydc/README.txt	Mon Apr 13 20:08:54 2020 +0200
@@ -10,6 +10,7 @@
 Apr 11, 2020: support for getting loaded library path
 Apr 12, 2020: breaking change: restrict 'Z' conversions to immutable types
               and 'p' to mutable types (and handles)
+Apr 13, 2020: added signature char support to specify calling conventions
 
 
 BUILD/INSTALLATION
@@ -28,11 +29,17 @@
 API
 ===
 
-libhandle = load(libpath)
+libhandle = load(libpath)               # if path == None => handle to running process
+libpath   = get_path(libhandle)         # if handle == None => path to executable
 funcptr   = find(libhandle, symbolname)
 call(funcptr, signature, ...)
 free(libhandle)
 
+Note that there are no functions to set the calling convention mode. However,
+it can be set using the signature.
+Not specifying any calling convention in the signature string will use the
+platform's default one.
+
 
 SIGNATURE FORMAT
 ================
@@ -73,6 +80,7 @@
       | -                               | bytes (PyBytes)               ! | const char* (UTF-8 for unicode) | int (PyString)                       | str (PyUnicode)
       | bytearray (PyByteArray)       ! | bytearray (PyByteArray)       ! | const char* (UTF-8 for unicode) | int (PyString)                       | str (PyUnicode)
 
+  Annotations:
   # converted to 1 if True and 0 otherwise
   @ converted to False if 0 and True otherwise
   % range/length checked
@@ -82,8 +90,24 @@
   ! immutable buffer when passed to C, as strings (in any form) are considered objects, not buffers
 
 
-  also supported are specifying calling convention mode switches using
-  '_'-prefixed signature characters; consult the dyncall docs for a list
+  Also supported are specifying calling convention switches using '_'-prefixed
+  signature characters:
+
+  SIG | DESCRIPTION
+  ----+-----------------------------------------------------------------------------------------------------------
+  '_' | prefix indicating that next signature character specifies calling convention; char is one of the following
+  ':' | platform's default calling convention
+  'e' | vararg function
+  '.' | vararg function's variadic/ellipsis part (...), to be specified before first vararg
+  'c' | only on x86: cdecl
+  's' | only on x86: stdcall
+  'F' | only on x86: fastcall (MS)
+  'f' | only on x86: fastcall (GNU)
+  '+' | only on x86: thiscall (MS)
+  '#' | only on x86: thiscall (GNU)
+  'A' | only on ARM: ARM mode
+  'a' | only on ARM: THUMB mode
+  '$' | syscall
 
 
 TODO
diff -r b84064293541 -r 8c8f848131c6 python/pydc/pydcext.c
--- a/python/pydc/pydcext.c	Mon Apr 13 16:28:47 2020 +0200
+++ b/python/pydc/pydcext.c	Mon Apr 13 20:08:54 2020 +0200
@@ -193,6 +193,7 @@
 	ts  = PyTuple_Size(args);
 
 	dcReset(gpCall);
+	dcMode(gpCall, DC_CALL_C_DEFAULT);
 
 	for (ch = *ptr; ch != '\0' && ch != ')'; ch = *++ptr)
 	{
diff -r b84064293541 -r 8c8f848131c6 python/pydc/setup.py
--- a/python/pydc/setup.py	Mon Apr 13 16:28:47 2020 +0200
+++ b/python/pydc/setup.py	Mon Apr 13 20:08:54 2020 +0200
@@ -7,11 +7,11 @@
 
 setup(
   name             = 'pydc'
-, version          = '1.1.1'
-, author           = 'Daniel Adler'
-, author_email     = 'dadler@dyncall.org'
-, maintainer       = 'Daniel Adler'
-, maintainer_email = 'dadler@dyncall.org'
+, version          = '1.1.2'
+, author           = 'Daniel Adler, Tassilo Philipp'
+, author_email     = 'dadler@dyncall.org, tphilip@dyncall.org'
+, maintainer       = 'Daniel Adler, Tassilo Philipp'
+, maintainer_email = 'dadler@dyncall.org, tphilip@dyncall.org'
 , url              = 'https://www.dyncall.org'
 , download_url     = 'https://www.dyncall.org/download'
 , classifiers      = []