From 0666c8f9a353b42ffde4902dc0cdec66f925a6e3 Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Sat, 2 Dec 2023 18:32:34 +0100
Subject: Bug 1481 - Hide [ArgumentIs]PascalString argument's length

Native pascal strings shall be just treated as normal Java strings on the Java side.

Hence drop the length parameter across generated API, i.e.
- C Function bindings
- Java Callbacks
---
 doc/manual/index.html | 10 +++++-----
 doc/manual/index.md   |  7 ++++---
 2 files changed, 9 insertions(+), 8 deletions(-)

(limited to 'doc/manual')

diff --git a/doc/manual/index.html b/doc/manual/index.html
index 68173ec..d9e4b02 100755
--- a/doc/manual/index.html
+++ b/doc/manual/index.html
@@ -1078,9 +1078,8 @@ using <a href="#CustomJavaCode">CustomJavaCode</a> to write the exposed
 API. In this case is most useful in conjunction with <a
 href="#RenameJavaMethod">RenameJavaMethod</a>.</p>
 <p><strong><span id="ArgumentIsString">ArgumentIsString</span></strong><br />
-Syntax:
-<code>ArgumentIsString [function name]                                 [indices...]</code>
-where the first argument index is 0<br />
+Syntax: <code>ArgumentIsString [function name] [indices...]</code> where
+the first argument index is 0<br />
 (optional) For a C function with one or more outgoing <code>char*</code>
 (or compatible data type) arguments, indicates that those arguments are
 semantically null-terminated C strings rather than arbitrary arrays of
@@ -1089,7 +1088,7 @@ as java.lang.String objects rather than <code>byte[]</code> or
 <code>ByteBuffer</code>.</p>
 <p><strong><span id="ArgumentIsPascalString">ArgumentIsPascalString</span></strong><br />
 Syntax:
-<code>ArgumentIsPascalString [function name]                                 [indice-tuples...]</code>,
+<code>ArgumentIsPascalString [function name] [indice-tuples...]</code>,
 with each tuple being the argument-index for the
 '<code>int length</code>' and the '<code>char* value</code>' argument
 with index 0 for the the first argument<br />
@@ -1099,7 +1098,8 @@ data type) arguments, indicates that those arguments are semantically
 non-null-terminated Pascal strings rather than null-terminated C strings
 or arbitrary arrays of bytes. The generated glue code will be modified
 to emit those arguments as java.lang.String objects rather than
-<code>byte[]</code> or <code>ByteBuffer</code>.</p>
+<code>byte[]</code> or <code>ByteBuffer</code> as well as dropping the
+redundant '<code>int length</code>' argument on the Java side.</p>
 <p><strong><span id="ClassJavadoc">ClassJavadoc</span></strong><br />
 Syntax: <code>ClassJavadoc [class name] [code...]</code><br />
 (optional) Causes the specified line of code to be emitted in the
diff --git a/doc/manual/index.md b/doc/manual/index.md
index 0ad4172..48a632d 100644
--- a/doc/manual/index.md
+++ b/doc/manual/index.md
@@ -648,7 +648,7 @@ this case is most useful in conjunction with
 
 **<span id="ArgumentIsString">ArgumentIsString</span>**  
 Syntax:
-`ArgumentIsString [function name]                                 [indices...]`
+`ArgumentIsString [function name] [indices...]`
 where the first argument index is 0  
 (optional) For a C function with one or more outgoing `char*` (or
 compatible data type) arguments, indicates that those arguments are
@@ -658,7 +658,7 @@ as java.lang.String objects rather than `byte[]` or `ByteBuffer`.
 
 **<span id="ArgumentIsPascalString">ArgumentIsPascalString</span>**  
 Syntax:
-`ArgumentIsPascalString [function name]                                 [indice-tuples...]`,
+`ArgumentIsPascalString [function name] [indice-tuples...]`,
 with each tuple being the argument-index for the '`int length`' and the
 '`char* value`' argument with index 0 for the the first argument  
 (optional) For a C function with one or more outgoing '`int length`' and
@@ -666,7 +666,8 @@ with each tuple being the argument-index for the '`int length`' and the
 those arguments are semantically non-null-terminated Pascal strings
 rather than null-terminated C strings or arbitrary arrays of bytes. The
 generated glue code will be modified to emit those arguments as
-java.lang.String objects rather than `byte[]` or `ByteBuffer`.
+java.lang.String objects rather than `byte[]` or `ByteBuffer`
+as well as dropping the redundant '`int length`' argument on the Java side.
 
 **<span id="ClassJavadoc">ClassJavadoc</span>**  
 Syntax: `ClassJavadoc [class name] [code...]`  
-- 
cgit v1.2.3