docs: improve sync and async options docs

Signed-off-by: Markus <28785953+MarkusJx@users.noreply.github.com>

Author: MarkusJx

crates/java-bridge/src/node/java_config.rs

@@ -82,7 +82,10 @@ impl JavaConfig {
     /// Pass `null` or an empty string to disable the suffix.
     /// This must not be the same as the {@link asyncSuffix}.
     ///
-    /// # Example
+    /// This option does not affect standard methods of java classes
+    /// like `toString`, `toStringSync`, `toStringAsync` and `newInstanceAsync`.
+    ///
+    /// ## Example
     /// ```ts
     /// import { config, clearClassProxies } from 'java-bridge';
     ///
@@ -137,6 +140,9 @@ impl JavaConfig {
     /// Pass `null` or an empty string to disable the suffix.
     /// This must not be the same as the {@link syncSuffix}.
     ///
+    /// This option does not affect standard methods of java classes
+    /// like `toString`, `toStringSync`, `toStringAsync` and `newInstanceAsync`.
+    ///
     /// @see syncSuffix
     /// @since 2.4.0
     /// @param value the suffix to use for asynchronous methods

ts-src/definitions.ts

@@ -150,6 +150,9 @@ export declare class JavaClass extends JavaObject {
      * Does not overwrite any existing instanceof operator.
      * This uses the native java instanceof operator.
      *
+     * This method's name is not affected by the {@link JavaConfig#syncSuffix}
+     * and {@link JavaConfig#asyncSuffix} options.
+     *
      * ## Example
      * ```ts
      * import { importClass } from 'java-bridge';
@@ -190,6 +193,9 @@ export declare class JavaClass extends JavaObject {
      * Java default toString method.
      * Sync call.
      *
+     * This method's name is not affected by the {@link JavaConfig#syncSuffix}
+     * and {@link JavaConfig#asyncSuffix} options.
+     *
      * @returns this as a string
      */
     public toString(): string;
@@ -198,6 +204,9 @@ export declare class JavaClass extends JavaObject {
      * Java default toString method.
      * Sync call.
      *
+     * This method's name is not affected by the {@link JavaConfig#syncSuffix}
+     * and {@link JavaConfig#asyncSuffix} options.
+     *
      * @deprecated use {@link toString} instead
      * @returns this as a string
      */
@@ -207,6 +216,9 @@ export declare class JavaClass extends JavaObject {
      * Java default toString method.
      * Async call.
      *
+     * This method's name is not affected by the {@link JavaConfig#syncSuffix}
+     * and {@link JavaConfig#asyncSuffix} options.
+     *
      * @since 2.4.0
      * @returns this as a string
      */
@@ -251,6 +263,9 @@ export declare class UnknownJavaClass extends JavaClass {
      * Create a new java class instance.
      * Async version.
      *
+     * This method's name is not affected by the {@link JavaConfig#syncSuffix}
+     * and {@link JavaConfig#asyncSuffix} options.
+     *
      * @template T the type of this class as a new instance of this class will be returned
      * @param args the arguments to create the instance
      * @return the java_instance_proxy instance