From cb7e11fa797791418e617f99ad3e40213404653d Mon Sep 17 00:00:00 2001 From: Dongie Agnir <261310+dagnir@users.noreply.github.com> Date: Mon, 9 Sep 2019 13:22:51 -0700 Subject: [PATCH] feat(java): Indicate if method param is required (#762) This commit enhances javadoc generation for Java classes so that required method/constructor parameters are indicated in their description in the javadoc. This makes it easy for customers to see which paramaters must be provided when interacting with libraries from Java. Fixes #365 --- packages/jsii-pacmak/lib/targets/java.ts | 27 +++++++++++++------ .../jsii/tests/calculator/base/BaseProps.java | 4 +-- .../tests/calculator/lib/MyFirstStruct.java | 6 ++--- .../jsii/tests/calculator/lib/Number.java | 2 +- .../lib/StructWithOnlyOptionals.java | 6 ++--- .../jsii/tests/calculator/AbstractClass.java | 4 +++ .../amazon/jsii/tests/calculator/Add.java | 4 +-- .../jsii/tests/calculator/AllTypes.java | 4 +++ .../tests/calculator/AllowedMethodNames.java | 12 +++++++++ .../tests/calculator/AsyncVirtualMethods.java | 2 ++ .../tests/calculator/BinaryOperation.java | 4 +-- .../jsii/tests/calculator/Calculator.java | 6 +++++ .../tests/calculator/CalculatorProps.java | 4 +-- .../calculator/ClassWithCollections.java | 3 +++ .../ClassWithJavaReservedWords.java | 4 +++ ...vateConstructorAndAutomaticProperties.java | 3 +++ .../calculator/ConstructorPassesThisOut.java | 2 ++ .../ConsumersOfThisCrazyTypeSystem.java | 4 +++ .../jsii/tests/calculator/DataRenderer.java | 6 +++++ .../DefaultedConstructorArgument.java | 9 +++++++ .../tests/calculator/DeprecatedClass.java | 3 +++ .../tests/calculator/DeprecatedStruct.java | 2 +- .../jsii/tests/calculator/DerivedStruct.java | 16 +++++------ .../DiamondInheritanceBaseLevelStruct.java | 2 +- ...DiamondInheritanceFirstMidLevelStruct.java | 4 +-- ...iamondInheritanceSecondMidLevelStruct.java | 4 +-- .../DiamondInheritanceTopLevelStruct.java | 8 +++--- .../calculator/DoNotOverridePrivates.java | 2 ++ .../DoNotRecognizeAnyAsOptional.java | 9 +++++++ ...ontComplainAboutVariadicAfterOptional.java | 3 +++ .../calculator/EraseUndefinedHashValues.java | 3 +++ .../EraseUndefinedHashValuesOptions.java | 4 +-- .../tests/calculator/ExperimentalClass.java | 5 ++++ .../tests/calculator/ExperimentalStruct.java | 2 +- .../tests/calculator/ExportedBaseClass.java | 2 ++ .../calculator/ExtendsInternalInterface.java | 4 +-- .../jsii/tests/calculator/GiveMeStructs.java | 6 +++++ .../tests/calculator/GreetingAugmenter.java | 2 ++ ...IInterfaceWithOptionalMethodArguments.java | 10 +++++++ .../tests/calculator/ImplictBaseOfBase.java | 6 ++--- .../Hello.java | 2 +- .../Hello.java | 2 +- .../tests/calculator/InterfacesMaker.java | 2 ++ .../jsii/tests/calculator/JSII417Derived.java | 2 ++ .../jsii/tests/calculator/Multiply.java | 4 +-- .../amazon/jsii/tests/calculator/Negate.java | 2 ++ .../NullShouldBeTreatedAsUndefined.java | 9 +++++++ .../NullShouldBeTreatedAsUndefinedData.java | 4 +-- .../tests/calculator/NumberGenerator.java | 4 +++ .../calculator/ObjectRefsInCollections.java | 4 +++ .../OptionalConstructorArgument.java | 7 +++++ .../jsii/tests/calculator/OptionalStruct.java | 2 +- .../calculator/OptionalStructConsumer.java | 2 ++ .../calculator/OverrideReturnsObject.java | 2 ++ .../PartiallyInitializedThisConsumer.java | 8 ++++++ .../jsii/tests/calculator/Polymorphism.java | 2 ++ .../amazon/jsii/tests/calculator/Power.java | 4 +-- .../ReferenceEnumFromScopedPackage.java | 2 ++ .../tests/calculator/RuntimeTypeChecking.java | 18 +++++++++++++ .../tests/calculator/SecondLevelStruct.java | 2 +- .../jsii/tests/calculator/SingletonInt.java | 2 ++ .../tests/calculator/SingletonString.java | 2 ++ .../jsii/tests/calculator/StableClass.java | 3 +++ .../jsii/tests/calculator/StableStruct.java | 2 +- .../amazon/jsii/tests/calculator/Statics.java | 4 ++- .../jsii/tests/calculator/StructPassing.java | 4 +++ .../StructWithJavaReservedWords.java | 8 +++--- .../tests/calculator/SyncVirtualMethods.java | 8 ++++++ .../jsii/tests/calculator/TopLevelStruct.java | 6 ++--- .../jsii/tests/calculator/UnaryOperation.java | 2 ++ .../tests/calculator/UnionProperties.java | 10 +++---- .../UsesInterfaceWithProperties.java | 6 +++++ .../jsii/tests/calculator/VariadicMethod.java | 6 ++--- .../calculator/VirtualMethodPlayground.java | 10 +++++++ .../WithPrivatePropertyInConstructor.java | 2 ++ 75 files changed, 296 insertions(+), 76 deletions(-) diff --git a/packages/jsii-pacmak/lib/targets/java.ts b/packages/jsii-pacmak/lib/targets/java.ts index 75a87a00ff..b94e143bc1 100644 --- a/packages/jsii-pacmak/lib/targets/java.ts +++ b/packages/jsii-pacmak/lib/targets/java.ts @@ -896,11 +896,8 @@ class JavaGenerator extends Generator { this.code.line(); this.code.line('/**'); this.code.line(` * Sets the value of ${prop.propName}`); - if (prop.docs && prop.docs.summary) { - this.code.line(` * @param ${prop.fieldName} ${prop.docs.summary}`); - } else { - this.code.line(` * @param ${prop.fieldName} the value to be set`); - } + const summary = (prop.docs && prop.docs.summary) || "the value to be set"; + this.code.line(` * ${paramJavadoc(prop.fieldName, prop.nullable, summary)}`); this.code.line(` * @return {@code this}`); if (prop.docs && prop.docs.deprecated) { this.code.line(` * @deprecated ${prop.docs.deprecated}`); @@ -1194,9 +1191,8 @@ class JavaGenerator extends Generator { const method = doc as spec.Method; if (method.parameters) { for (const param of method.parameters) { - if (param.docs && param.docs.summary) { - tagLines.push(`@param ${param.name} ${param.docs.summary}`); - } + const summary = (param.docs && param.docs.summary) || undefined; + tagLines.push(paramJavadoc(param.name, param.optional, summary)); } } } @@ -1543,3 +1539,18 @@ function isNullable(optionalValue: spec.OptionalValue | undefined): boolean { || (spec.isPrimitiveTypeReference(optionalValue.type) && optionalValue.type.primitive === spec.PrimitiveType.Any); } + +function paramJavadoc(name: string, optional?: boolean, summary?: string): string { + const parts = ['@param', name]; + if (summary) { parts.push(endWithPeriod(summary)); } + if (!optional) { parts.push('This parameter is required.'); } + + return parts.join(' '); +} + +function endWithPeriod(s: string): string { + if (!s.endsWith('.')) { + return s + '.'; + } + return s; +} \ No newline at end of file diff --git a/packages/jsii-pacmak/test/expected.jsii-calc-base/java/src/main/java/software/amazon/jsii/tests/calculator/base/BaseProps.java b/packages/jsii-pacmak/test/expected.jsii-calc-base/java/src/main/java/software/amazon/jsii/tests/calculator/base/BaseProps.java index 90add71a8e..f32c5c2532 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc-base/java/src/main/java/software/amazon/jsii/tests/calculator/base/BaseProps.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc-base/java/src/main/java/software/amazon/jsii/tests/calculator/base/BaseProps.java @@ -20,7 +20,7 @@ public static final class Builder { /** * Sets the value of Bar - * @param bar the value to be set + * @param bar the value to be set. This parameter is required. * @return {@code this} */ public Builder bar(java.lang.String bar) { @@ -30,7 +30,7 @@ public Builder bar(java.lang.String bar) { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo the value to be set. This parameter is required. * @return {@code this} */ public Builder foo(software.amazon.jsii.tests.calculator.baseofbase.Very foo) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/MyFirstStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/MyFirstStruct.java index 42c6a143e8..48581d9b99 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/MyFirstStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/MyFirstStruct.java @@ -48,7 +48,7 @@ public static final class Builder { /** * Sets the value of Anumber - * @param anumber An awesome number value. + * @param anumber An awesome number value. This parameter is required. * @return {@code this} */ @Deprecated @@ -60,7 +60,7 @@ public Builder anumber(java.lang.Number anumber) { /** * Sets the value of Astring - * @param astring A string value. + * @param astring A string value. This parameter is required. * @return {@code this} */ @Deprecated @@ -72,7 +72,7 @@ public Builder astring(java.lang.String astring) { /** * Sets the value of FirstOptional - * @param firstOptional the value to be set + * @param firstOptional the value to be set. * @return {@code this} */ @Deprecated diff --git a/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/Number.java b/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/Number.java index 4169538f7e..87295757cb 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/Number.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/Number.java @@ -20,7 +20,7 @@ protected Number(final software.amazon.jsii.JsiiObject.InitializationMode initia /** * Creates a Number object. * - * @param value The number. + * @param value The number. This parameter is required. */ @Deprecated @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Deprecated) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/StructWithOnlyOptionals.java b/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/StructWithOnlyOptionals.java index e60b7034b9..e850573ede 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/StructWithOnlyOptionals.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc-lib/java/src/main/java/software/amazon/jsii/tests/calculator/lib/StructWithOnlyOptionals.java @@ -47,7 +47,7 @@ public static final class Builder { /** * Sets the value of Optional1 - * @param optional1 The first optional! + * @param optional1 The first optional!. * @return {@code this} */ @Deprecated @@ -59,7 +59,7 @@ public Builder optional1(java.lang.String optional1) { /** * Sets the value of Optional2 - * @param optional2 the value to be set + * @param optional2 the value to be set. * @return {@code this} */ @Deprecated @@ -71,7 +71,7 @@ public Builder optional2(java.lang.Number optional2) { /** * Sets the value of Optional3 - * @param optional3 the value to be set + * @param optional3 the value to be set. * @return {@code this} */ @Deprecated diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AbstractClass.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AbstractClass.java index 06a6a1c823..a99499b69e 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AbstractClass.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AbstractClass.java @@ -23,6 +23,8 @@ protected AbstractClass() { /** * EXPERIMENTAL + * + * @param name This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public abstract java.lang.String abstractMethod(final java.lang.String name); @@ -73,6 +75,8 @@ public java.lang.String getAbstractProperty() { /** * EXPERIMENTAL + * + * @param name This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @Override diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Add.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Add.java index 2d86be118e..983079af0b 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Add.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Add.java @@ -23,8 +23,8 @@ protected Add(final software.amazon.jsii.JsiiObject.InitializationMode initializ * * EXPERIMENTAL * - * @param lhs Left-hand side operand. - * @param rhs Right-hand side operand. + * @param lhs Left-hand side operand. This parameter is required. + * @param rhs Right-hand side operand. This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public Add(final software.amazon.jsii.tests.calculator.lib.Value lhs, final software.amazon.jsii.tests.calculator.lib.Value rhs) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllTypes.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllTypes.java index e7d2c52417..cd6c7dc539 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllTypes.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllTypes.java @@ -28,6 +28,8 @@ public AllTypes() { /** * EXPERIMENTAL + * + * @param inp This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void anyIn(final java.lang.Object inp) { @@ -44,6 +46,8 @@ public java.lang.Object anyOut() { /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public software.amazon.jsii.tests.calculator.StringEnum enumMethod(final software.amazon.jsii.tests.calculator.StringEnum value) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllowedMethodNames.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllowedMethodNames.java index 9377165832..a644216cb5 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllowedMethodNames.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AllowedMethodNames.java @@ -23,6 +23,9 @@ public AllowedMethodNames() { /** * EXPERIMENTAL + * + * @param _p1 This parameter is required. + * @param _p2 This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void getBar(final java.lang.String _p1, final java.lang.Number _p2) { @@ -33,6 +36,8 @@ public void getBar(final java.lang.String _p1, final java.lang.Number _p2) { * getXxx() is not allowed (see negatives), but getXxx(a, ...) is okay. * * EXPERIMENTAL + * + * @param withParam This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String getFoo(final java.lang.String withParam) { @@ -41,6 +46,10 @@ public java.lang.String getFoo(final java.lang.String withParam) { /** * EXPERIMENTAL + * + * @param _x This parameter is required. + * @param _y This parameter is required. + * @param _z This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void setBar(final java.lang.String _x, final java.lang.Number _y, final java.lang.Boolean _z) { @@ -51,6 +60,9 @@ public void setBar(final java.lang.String _x, final java.lang.Number _y, final j * setFoo(x) is not allowed (see negatives), but setXxx(a, b, ...) is okay. * * EXPERIMENTAL + * + * @param _x This parameter is required. + * @param _y This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void setFoo(final java.lang.String _x, final java.lang.Number _y) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AsyncVirtualMethods.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AsyncVirtualMethods.java index 88cf5ddcde..83ba28aea6 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AsyncVirtualMethods.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/AsyncVirtualMethods.java @@ -63,6 +63,8 @@ public java.lang.Number dontOverrideMe() { /** * EXPERIMENTAL + * + * @param mult This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number overrideMe(final java.lang.Number mult) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/BinaryOperation.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/BinaryOperation.java index 798a30ecac..b48f8e8504 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/BinaryOperation.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/BinaryOperation.java @@ -23,8 +23,8 @@ protected BinaryOperation(final software.amazon.jsii.JsiiObject.InitializationMo * * EXPERIMENTAL * - * @param lhs Left-hand side operand. - * @param rhs Right-hand side operand. + * @param lhs Left-hand side operand. This parameter is required. + * @param rhs Right-hand side operand. This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) protected BinaryOperation(final software.amazon.jsii.tests.calculator.lib.Value lhs, final software.amazon.jsii.tests.calculator.lib.Value rhs) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Calculator.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Calculator.java index 2d5c2d704b..2d3c27ad7b 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Calculator.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Calculator.java @@ -46,6 +46,8 @@ public Calculator() { * Adds a number to the current value. * * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void add(final java.lang.Number value) { @@ -56,6 +58,8 @@ public void add(final java.lang.Number value) { * Multiplies the current value by a number. * * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void mul(final java.lang.Number value) { @@ -76,6 +80,8 @@ public void neg() { * Raises the current value by a power. * * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void pow(final java.lang.Number value) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/CalculatorProps.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/CalculatorProps.java index 7c7fd20a96..56b53e27f5 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/CalculatorProps.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/CalculatorProps.java @@ -38,7 +38,7 @@ public static final class Builder { /** * Sets the value of InitialValue - * @param initialValue the value to be set + * @param initialValue the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -49,7 +49,7 @@ public Builder initialValue(java.lang.Number initialValue) { /** * Sets the value of MaximumValue - * @param maximumValue the value to be set + * @param maximumValue the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithCollections.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithCollections.java index 361ad2d5c9..3c6fa9217b 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithCollections.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithCollections.java @@ -18,6 +18,9 @@ protected ClassWithCollections(final software.amazon.jsii.JsiiObject.Initializat /** * EXPERIMENTAL + * + * @param map This parameter is required. + * @param array This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public ClassWithCollections(final java.util.Map map, final java.util.List array) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithJavaReservedWords.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithJavaReservedWords.java index 22e1d483b2..e6def862f6 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithJavaReservedWords.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithJavaReservedWords.java @@ -18,6 +18,8 @@ protected ClassWithJavaReservedWords(final software.amazon.jsii.JsiiObject.Initi /** * EXPERIMENTAL + * + * @param int This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public ClassWithJavaReservedWords(final java.lang.String intValue) { @@ -27,6 +29,8 @@ public ClassWithJavaReservedWords(final java.lang.String intValue) { /** * EXPERIMENTAL + * + * @param assert This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String doImport(final java.lang.String assertValue) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithPrivateConstructorAndAutomaticProperties.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithPrivateConstructorAndAutomaticProperties.java index 72c9120ad3..7dffd21e53 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithPrivateConstructorAndAutomaticProperties.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithPrivateConstructorAndAutomaticProperties.java @@ -20,6 +20,9 @@ protected ClassWithPrivateConstructorAndAutomaticProperties(final software.amazo /** * EXPERIMENTAL + * + * @param readOnlyString This parameter is required. + * @param readWriteString This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public static software.amazon.jsii.tests.calculator.ClassWithPrivateConstructorAndAutomaticProperties create(final java.lang.String readOnlyString, final java.lang.String readWriteString) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConstructorPassesThisOut.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConstructorPassesThisOut.java index ee083d2f0e..fd9b490c0e 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConstructorPassesThisOut.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConstructorPassesThisOut.java @@ -18,6 +18,8 @@ protected ConstructorPassesThisOut(final software.amazon.jsii.JsiiObject.Initial /** * EXPERIMENTAL + * + * @param consumer This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public ConstructorPassesThisOut(final software.amazon.jsii.tests.calculator.PartiallyInitializedThisConsumer consumer) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConsumersOfThisCrazyTypeSystem.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConsumersOfThisCrazyTypeSystem.java index 2c639877ed..704bd1a0af 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConsumersOfThisCrazyTypeSystem.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ConsumersOfThisCrazyTypeSystem.java @@ -23,6 +23,8 @@ public ConsumersOfThisCrazyTypeSystem() { /** * EXPERIMENTAL + * + * @param obj This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String consumeAnotherPublicInterface(final software.amazon.jsii.tests.calculator.IAnotherPublicInterface obj) { @@ -31,6 +33,8 @@ public java.lang.String consumeAnotherPublicInterface(final software.amazon.jsii /** * EXPERIMENTAL + * + * @param obj This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Object consumeNonInternalInterface(final software.amazon.jsii.tests.calculator.INonInternalInterface obj) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DataRenderer.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DataRenderer.java index f07e6508af..b50fea1171 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DataRenderer.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DataRenderer.java @@ -29,6 +29,8 @@ public DataRenderer() { /** * EXPERIMENTAL + * + * @param data */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String render(final software.amazon.jsii.tests.calculator.lib.MyFirstStruct data) { @@ -45,6 +47,8 @@ public java.lang.String render() { /** * EXPERIMENTAL + * + * @param data This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String renderArbitrary(final java.util.Map data) { @@ -53,6 +57,8 @@ public java.lang.String renderArbitrary(final java.util.Map map) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DefaultedConstructorArgument.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DefaultedConstructorArgument.java index 50e969d250..07a1fd6d14 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DefaultedConstructorArgument.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DefaultedConstructorArgument.java @@ -18,6 +18,10 @@ protected DefaultedConstructorArgument(final software.amazon.jsii.JsiiObject.Ini /** * EXPERIMENTAL + * + * @param arg1 + * @param arg2 + * @param arg3 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public DefaultedConstructorArgument(final java.lang.Number arg1, final java.lang.String arg2, final java.time.Instant arg3) { @@ -27,6 +31,9 @@ public DefaultedConstructorArgument(final java.lang.Number arg1, final java.lang /** * EXPERIMENTAL + * + * @param arg1 + * @param arg2 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public DefaultedConstructorArgument(final java.lang.Number arg1, final java.lang.String arg2) { @@ -36,6 +43,8 @@ public DefaultedConstructorArgument(final java.lang.Number arg1, final java.lang /** * EXPERIMENTAL + * + * @param arg1 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public DefaultedConstructorArgument(final java.lang.Number arg1) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedClass.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedClass.java index 950788cd2e..62d82b3d38 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedClass.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedClass.java @@ -19,6 +19,8 @@ protected DeprecatedClass(final software.amazon.jsii.JsiiObject.InitializationMo /** * @deprecated this constructor is "just" okay + * @param readonlyString This parameter is required. + * @param mutableNumber */ @Deprecated @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Deprecated) @@ -29,6 +31,7 @@ public DeprecatedClass(final java.lang.String readonlyString, final java.lang.Nu /** * @deprecated this constructor is "just" okay + * @param readonlyString This parameter is required. */ @Deprecated @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Deprecated) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedStruct.java index 83bec08ebe..e42757f29b 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DeprecatedStruct.java @@ -33,7 +33,7 @@ public static final class Builder { /** * Sets the value of ReadonlyProperty - * @param readonlyProperty the value to be set + * @param readonlyProperty the value to be set. This parameter is required. * @return {@code this} * @deprecated well, yeah */ diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DerivedStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DerivedStruct.java index 39a9582a6f..9ef12b74a6 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DerivedStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DerivedStruct.java @@ -73,7 +73,7 @@ public static final class Builder { /** * Sets the value of AnotherRequired - * @param anotherRequired the value to be set + * @param anotherRequired the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -84,7 +84,7 @@ public Builder anotherRequired(java.time.Instant anotherRequired) { /** * Sets the value of Bool - * @param bool the value to be set + * @param bool the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -95,7 +95,7 @@ public Builder bool(java.lang.Boolean bool) { /** * Sets the value of NonPrimitive - * @param nonPrimitive An example of a non primitive property. + * @param nonPrimitive An example of a non primitive property. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -117,7 +117,7 @@ public Builder anotherOptional(java.util.Map optionalArray) { /** * Sets the value of Anumber - * @param anumber An awesome number value. + * @param anumber An awesome number value. This parameter is required. * @return {@code this} */ @Deprecated @@ -151,7 +151,7 @@ public Builder anumber(java.lang.Number anumber) { /** * Sets the value of Astring - * @param astring A string value. + * @param astring A string value. This parameter is required. * @return {@code this} */ @Deprecated @@ -163,7 +163,7 @@ public Builder astring(java.lang.String astring) { /** * Sets the value of FirstOptional - * @param firstOptional the value to be set + * @param firstOptional the value to be set. * @return {@code this} */ @Deprecated diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceBaseLevelStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceBaseLevelStruct.java index 38c7a57822..a69a32b2f9 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceBaseLevelStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceBaseLevelStruct.java @@ -29,7 +29,7 @@ public static final class Builder { /** * Sets the value of BaseLevelProperty - * @param baseLevelProperty the value to be set + * @param baseLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceFirstMidLevelStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceFirstMidLevelStruct.java index 0a8e38cff8..7ba5f0a6f5 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceFirstMidLevelStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceFirstMidLevelStruct.java @@ -30,7 +30,7 @@ public static final class Builder { /** * Sets the value of FirstMidLevelProperty - * @param firstMidLevelProperty the value to be set + * @param firstMidLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -41,7 +41,7 @@ public Builder firstMidLevelProperty(java.lang.String firstMidLevelProperty) { /** * Sets the value of BaseLevelProperty - * @param baseLevelProperty the value to be set + * @param baseLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceSecondMidLevelStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceSecondMidLevelStruct.java index 5612e13842..6c3d3dfb74 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceSecondMidLevelStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceSecondMidLevelStruct.java @@ -30,7 +30,7 @@ public static final class Builder { /** * Sets the value of SecondMidLevelProperty - * @param secondMidLevelProperty the value to be set + * @param secondMidLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -41,7 +41,7 @@ public Builder secondMidLevelProperty(java.lang.String secondMidLevelProperty) { /** * Sets the value of BaseLevelProperty - * @param baseLevelProperty the value to be set + * @param baseLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceTopLevelStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceTopLevelStruct.java index 8aba54de7e..9c2417e7ba 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceTopLevelStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DiamondInheritanceTopLevelStruct.java @@ -32,7 +32,7 @@ public static final class Builder { /** * Sets the value of TopLevelProperty - * @param topLevelProperty the value to be set + * @param topLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -43,7 +43,7 @@ public Builder topLevelProperty(java.lang.String topLevelProperty) { /** * Sets the value of FirstMidLevelProperty - * @param firstMidLevelProperty the value to be set + * @param firstMidLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -54,7 +54,7 @@ public Builder firstMidLevelProperty(java.lang.String firstMidLevelProperty) { /** * Sets the value of BaseLevelProperty - * @param baseLevelProperty the value to be set + * @param baseLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -65,7 +65,7 @@ public Builder baseLevelProperty(java.lang.String baseLevelProperty) { /** * Sets the value of SecondMidLevelProperty - * @param secondMidLevelProperty the value to be set + * @param secondMidLevelProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotOverridePrivates.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotOverridePrivates.java index ac392cb752..b54189e5c1 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotOverridePrivates.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotOverridePrivates.java @@ -23,6 +23,8 @@ public DoNotOverridePrivates() { /** * EXPERIMENTAL + * + * @param newValue This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void changePrivatePropertyValue(final java.lang.String newValue) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotRecognizeAnyAsOptional.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotRecognizeAnyAsOptional.java index 19ab63a85e..707eb9f392 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotRecognizeAnyAsOptional.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DoNotRecognizeAnyAsOptional.java @@ -25,6 +25,10 @@ public DoNotRecognizeAnyAsOptional() { /** * EXPERIMENTAL + * + * @param _requiredAny This parameter is required. + * @param _optionalAny + * @param _optionalString */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void method(final java.lang.Object _requiredAny, final java.lang.Object _optionalAny, final java.lang.String _optionalString) { @@ -33,6 +37,9 @@ public void method(final java.lang.Object _requiredAny, final java.lang.Object _ /** * EXPERIMENTAL + * + * @param _requiredAny This parameter is required. + * @param _optionalAny */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void method(final java.lang.Object _requiredAny, final java.lang.Object _optionalAny) { @@ -41,6 +48,8 @@ public void method(final java.lang.Object _requiredAny, final java.lang.Object _ /** * EXPERIMENTAL + * + * @param _requiredAny This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void method(final java.lang.Object _requiredAny) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DontComplainAboutVariadicAfterOptional.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DontComplainAboutVariadicAfterOptional.java index 418d2510c7..a813022984 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DontComplainAboutVariadicAfterOptional.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DontComplainAboutVariadicAfterOptional.java @@ -23,6 +23,9 @@ public DontComplainAboutVariadicAfterOptional() { /** * EXPERIMENTAL + * + * @param optional + * @param things This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String optionalAndVariadic(final java.lang.String optional, final java.lang.String... things) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValues.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValues.java index efb3271dd8..43db17fda1 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValues.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValues.java @@ -28,6 +28,9 @@ public EraseUndefinedHashValues() { * are being erased when sending values from native code to JS. * * EXPERIMENTAL + * + * @param opts This parameter is required. + * @param key This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public static java.lang.Boolean doesKeyExist(final software.amazon.jsii.tests.calculator.EraseUndefinedHashValuesOptions opts, final java.lang.String key) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValuesOptions.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValuesOptions.java index 6cc750b5d2..ebc4b4549a 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValuesOptions.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/EraseUndefinedHashValuesOptions.java @@ -36,7 +36,7 @@ public static final class Builder { /** * Sets the value of Option1 - * @param option1 the value to be set + * @param option1 the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -47,7 +47,7 @@ public Builder option1(java.lang.String option1) { /** * Sets the value of Option2 - * @param option2 the value to be set + * @param option2 the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalClass.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalClass.java index 7181a01d40..e2fc4b947d 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalClass.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalClass.java @@ -18,6 +18,9 @@ protected ExperimentalClass(final software.amazon.jsii.JsiiObject.Initialization /** * EXPERIMENTAL + * + * @param readonlyString This parameter is required. + * @param mutableNumber */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public ExperimentalClass(final java.lang.String readonlyString, final java.lang.Number mutableNumber) { @@ -27,6 +30,8 @@ public ExperimentalClass(final java.lang.String readonlyString, final java.lang. /** * EXPERIMENTAL + * + * @param readonlyString This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public ExperimentalClass(final java.lang.String readonlyString) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalStruct.java index 27f7591541..d908557dd5 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExperimentalStruct.java @@ -29,7 +29,7 @@ public static final class Builder { /** * Sets the value of ReadonlyProperty - * @param readonlyProperty the value to be set + * @param readonlyProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExportedBaseClass.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExportedBaseClass.java index 64c8ac39b7..061e636122 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExportedBaseClass.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExportedBaseClass.java @@ -18,6 +18,8 @@ protected ExportedBaseClass(final software.amazon.jsii.JsiiObject.Initialization /** * EXPERIMENTAL + * + * @param success This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public ExportedBaseClass(final java.lang.Boolean success) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExtendsInternalInterface.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExtendsInternalInterface.java index 28907e7507..7cbd24e542 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExtendsInternalInterface.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ExtendsInternalInterface.java @@ -36,7 +36,7 @@ public static final class Builder { /** * Sets the value of Boom - * @param boom the value to be set + * @param boom the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -47,7 +47,7 @@ public Builder boom(java.lang.Boolean boom) { /** * Sets the value of Prop - * @param prop the value to be set + * @param prop the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GiveMeStructs.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GiveMeStructs.java index ffa97ad79b..46335c0407 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GiveMeStructs.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GiveMeStructs.java @@ -25,6 +25,8 @@ public GiveMeStructs() { * Accepts a struct of type DerivedStruct and returns a struct of type FirstStruct. * * EXPERIMENTAL + * + * @param derived This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public software.amazon.jsii.tests.calculator.lib.MyFirstStruct derivedToFirst(final software.amazon.jsii.tests.calculator.DerivedStruct derived) { @@ -35,6 +37,8 @@ public software.amazon.jsii.tests.calculator.lib.MyFirstStruct derivedToFirst(fi * Returns the boolean from a DerivedStruct struct. * * EXPERIMENTAL + * + * @param derived This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public software.amazon.jsii.tests.calculator.DoubleTrouble readDerivedNonPrimitive(final software.amazon.jsii.tests.calculator.DerivedStruct derived) { @@ -45,6 +49,8 @@ public software.amazon.jsii.tests.calculator.DoubleTrouble readDerivedNonPrimiti * Returns the "anumber" from a MyFirstStruct struct; * * EXPERIMENTAL + * + * @param first This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number readFirstNumber(final software.amazon.jsii.tests.calculator.lib.MyFirstStruct first) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GreetingAugmenter.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GreetingAugmenter.java index f2167d27c5..332ccd01ee 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GreetingAugmenter.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GreetingAugmenter.java @@ -23,6 +23,8 @@ public GreetingAugmenter() { /** * EXPERIMENTAL + * + * @param friendly This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String betterGreeting(final software.amazon.jsii.tests.calculator.lib.IFriendly friendly) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/IInterfaceWithOptionalMethodArguments.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/IInterfaceWithOptionalMethodArguments.java index 8c2d927d09..6bc8be6d18 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/IInterfaceWithOptionalMethodArguments.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/IInterfaceWithOptionalMethodArguments.java @@ -11,12 +11,17 @@ public interface IInterfaceWithOptionalMethodArguments extends software.amazon.j /** * EXPERIMENTAL + * + * @param arg1 This parameter is required. + * @param arg2 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) void hello(final java.lang.String arg1, final java.lang.Number arg2); /** * EXPERIMENTAL + * + * @param arg1 This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) void hello(final java.lang.String arg1); @@ -32,6 +37,9 @@ final static class Jsii$Proxy extends software.amazon.jsii.JsiiObject implements /** * EXPERIMENTAL + * + * @param arg1 This parameter is required. + * @param arg2 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @Override @@ -41,6 +49,8 @@ public void hello(final java.lang.String arg1, final java.lang.Number arg2) { /** * EXPERIMENTAL + * + * @param arg1 This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @Override diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ImplictBaseOfBase.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ImplictBaseOfBase.java index 1db5cd8197..7369817d28 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ImplictBaseOfBase.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ImplictBaseOfBase.java @@ -31,7 +31,7 @@ public static final class Builder { /** * Sets the value of Goo - * @param goo the value to be set + * @param goo the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -42,7 +42,7 @@ public Builder goo(java.time.Instant goo) { /** * Sets the value of Bar - * @param bar the value to be set + * @param bar the value to be set. This parameter is required. * @return {@code this} */ public Builder bar(java.lang.String bar) { @@ -52,7 +52,7 @@ public Builder bar(java.lang.String bar) { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo the value to be set. This parameter is required. * @return {@code this} */ public Builder foo(software.amazon.jsii.tests.calculator.baseofbase.Very foo) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceIncludesClasses/Hello.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceIncludesClasses/Hello.java index ac844fbad7..e657d330d6 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceIncludesClasses/Hello.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceIncludesClasses/Hello.java @@ -29,7 +29,7 @@ public static final class Builder { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceOnlyInterface/Hello.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceOnlyInterface/Hello.java index df16ac7d26..f4cbd08ffd 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceOnlyInterface/Hello.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfaceInNamespaceOnlyInterface/Hello.java @@ -29,7 +29,7 @@ public static final class Builder { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfacesMaker.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfacesMaker.java index 07e877acfa..6e05cdbc1a 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfacesMaker.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/InterfacesMaker.java @@ -20,6 +20,8 @@ protected InterfacesMaker(final software.amazon.jsii.JsiiObject.InitializationMo /** * EXPERIMENTAL + * + * @param count This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public static java.util.List makeInterfaces(final java.lang.Number count) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/JSII417Derived.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/JSII417Derived.java index 522747d07d..9c8613b572 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/JSII417Derived.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/JSII417Derived.java @@ -18,6 +18,8 @@ protected JSII417Derived(final software.amazon.jsii.JsiiObject.InitializationMod /** * EXPERIMENTAL + * + * @param property This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public JSII417Derived(final java.lang.String property) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Multiply.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Multiply.java index 64a13501be..151bf86269 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Multiply.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Multiply.java @@ -23,8 +23,8 @@ protected Multiply(final software.amazon.jsii.JsiiObject.InitializationMode init * * EXPERIMENTAL * - * @param lhs Left-hand side operand. - * @param rhs Right-hand side operand. + * @param lhs Left-hand side operand. This parameter is required. + * @param rhs Right-hand side operand. This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public Multiply(final software.amazon.jsii.tests.calculator.lib.Value lhs, final software.amazon.jsii.tests.calculator.lib.Value rhs) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Negate.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Negate.java index f744ce06c9..ad2dc16ed9 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Negate.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Negate.java @@ -20,6 +20,8 @@ protected Negate(final software.amazon.jsii.JsiiObject.InitializationMode initia /** * EXPERIMENTAL + * + * @param operand This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public Negate(final software.amazon.jsii.tests.calculator.lib.Value operand) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefined.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefined.java index 3ad0fbd3e1..1839d5e5fd 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefined.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefined.java @@ -20,6 +20,9 @@ protected NullShouldBeTreatedAsUndefined(final software.amazon.jsii.JsiiObject.I /** * EXPERIMENTAL + * + * @param _param1 This parameter is required. + * @param optional */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public NullShouldBeTreatedAsUndefined(final java.lang.String _param1, final java.lang.Object optional) { @@ -29,6 +32,8 @@ public NullShouldBeTreatedAsUndefined(final java.lang.String _param1, final java /** * EXPERIMENTAL + * + * @param _param1 This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public NullShouldBeTreatedAsUndefined(final java.lang.String _param1) { @@ -38,6 +43,8 @@ public NullShouldBeTreatedAsUndefined(final java.lang.String _param1) { /** * EXPERIMENTAL + * + * @param value */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void giveMeUndefined(final java.lang.Object value) { @@ -54,6 +61,8 @@ public void giveMeUndefined() { /** * EXPERIMENTAL + * + * @param input This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void giveMeUndefinedInsideAnObject(final software.amazon.jsii.tests.calculator.NullShouldBeTreatedAsUndefinedData input) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefinedData.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefinedData.java index 17b7ab4483..0cc86a97de 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefinedData.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NullShouldBeTreatedAsUndefinedData.java @@ -36,7 +36,7 @@ public static final class Builder { /** * Sets the value of ArrayWithThreeElementsAndUndefinedAsSecondArgument - * @param arrayWithThreeElementsAndUndefinedAsSecondArgument the value to be set + * @param arrayWithThreeElementsAndUndefinedAsSecondArgument the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -47,7 +47,7 @@ public Builder arrayWithThreeElementsAndUndefinedAsSecondArgument(java.util.List /** * Sets the value of ThisShouldBeUndefined - * @param thisShouldBeUndefined the value to be set + * @param thisShouldBeUndefined the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NumberGenerator.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NumberGenerator.java index 9361fc5418..2078253f3c 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NumberGenerator.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/NumberGenerator.java @@ -20,6 +20,8 @@ protected NumberGenerator(final software.amazon.jsii.JsiiObject.InitializationMo /** * EXPERIMENTAL + * + * @param generator This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public NumberGenerator(final software.amazon.jsii.tests.calculator.IRandomNumberGenerator generator) { @@ -29,6 +31,8 @@ public NumberGenerator(final software.amazon.jsii.tests.calculator.IRandomNumber /** * EXPERIMENTAL + * + * @param gen This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Boolean isSameGenerator(final software.amazon.jsii.tests.calculator.IRandomNumberGenerator gen) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ObjectRefsInCollections.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ObjectRefsInCollections.java index 3b47586dc1..ac42c4bdff 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ObjectRefsInCollections.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ObjectRefsInCollections.java @@ -27,6 +27,8 @@ public ObjectRefsInCollections() { * Returns the sum of all values. * * EXPERIMENTAL + * + * @param values This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number sumFromArray(final java.util.List values) { @@ -37,6 +39,8 @@ public java.lang.Number sumFromArray(final java.util.List values) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalConstructorArgument.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalConstructorArgument.java index 5ebfaee352..d8e59259df 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalConstructorArgument.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalConstructorArgument.java @@ -18,6 +18,10 @@ protected OptionalConstructorArgument(final software.amazon.jsii.JsiiObject.Init /** * EXPERIMENTAL + * + * @param arg1 This parameter is required. + * @param arg2 This parameter is required. + * @param arg3 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public OptionalConstructorArgument(final java.lang.Number arg1, final java.lang.String arg2, final java.time.Instant arg3) { @@ -27,6 +31,9 @@ public OptionalConstructorArgument(final java.lang.Number arg1, final java.lang. /** * EXPERIMENTAL + * + * @param arg1 This parameter is required. + * @param arg2 This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public OptionalConstructorArgument(final java.lang.Number arg1, final java.lang.String arg2) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStruct.java index aae311d59b..08f72989ff 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStruct.java @@ -29,7 +29,7 @@ public static final class Builder { /** * Sets the value of Field - * @param field the value to be set + * @param field the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStructConsumer.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStructConsumer.java index 1e144ca0b4..cf733666de 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStructConsumer.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OptionalStructConsumer.java @@ -18,6 +18,8 @@ protected OptionalStructConsumer(final software.amazon.jsii.JsiiObject.Initializ /** * EXPERIMENTAL + * + * @param optionalStruct */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public OptionalStructConsumer(final software.amazon.jsii.tests.calculator.OptionalStruct optionalStruct) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OverrideReturnsObject.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OverrideReturnsObject.java index 7631374ef2..e17a839fdc 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OverrideReturnsObject.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/OverrideReturnsObject.java @@ -23,6 +23,8 @@ public OverrideReturnsObject() { /** * EXPERIMENTAL + * + * @param obj This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number test(final software.amazon.jsii.tests.calculator.IReturnsNumber obj) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/PartiallyInitializedThisConsumer.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/PartiallyInitializedThisConsumer.java index ae80bbad70..8a6889fdab 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/PartiallyInitializedThisConsumer.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/PartiallyInitializedThisConsumer.java @@ -23,6 +23,10 @@ protected PartiallyInitializedThisConsumer() { /** * EXPERIMENTAL + * + * @param obj This parameter is required. + * @param dt This parameter is required. + * @param ev This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public abstract java.lang.String consumePartiallyInitializedThis(final software.amazon.jsii.tests.calculator.ConstructorPassesThisOut obj, final java.time.Instant dt, final software.amazon.jsii.tests.calculator.AllTypesEnum ev); @@ -38,6 +42,10 @@ final static class Jsii$Proxy extends software.amazon.jsii.tests.calculator.Part /** * EXPERIMENTAL + * + * @param obj This parameter is required. + * @param dt This parameter is required. + * @param ev This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @Override diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Polymorphism.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Polymorphism.java index 1c96d4ca70..17061ad7f8 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Polymorphism.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Polymorphism.java @@ -23,6 +23,8 @@ public Polymorphism() { /** * EXPERIMENTAL + * + * @param friendly This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String sayHello(final software.amazon.jsii.tests.calculator.lib.IFriendly friendly) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Power.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Power.java index 474bf7263f..642c290f28 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Power.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Power.java @@ -23,8 +23,8 @@ protected Power(final software.amazon.jsii.JsiiObject.InitializationMode initial * * EXPERIMENTAL * - * @param base The base of the power. - * @param pow The number of times to multiply. + * @param base The base of the power. This parameter is required. + * @param pow The number of times to multiply. This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public Power(final software.amazon.jsii.tests.calculator.lib.Value base, final software.amazon.jsii.tests.calculator.lib.Value pow) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ReferenceEnumFromScopedPackage.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ReferenceEnumFromScopedPackage.java index 2444ef8985..247aaba12b 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ReferenceEnumFromScopedPackage.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ReferenceEnumFromScopedPackage.java @@ -33,6 +33,8 @@ public software.amazon.jsii.tests.calculator.lib.EnumFromScopedModule loadFoo() /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void saveFoo(final software.amazon.jsii.tests.calculator.lib.EnumFromScopedModule value) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/RuntimeTypeChecking.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/RuntimeTypeChecking.java index 5a83ae25c7..2c5330b894 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/RuntimeTypeChecking.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/RuntimeTypeChecking.java @@ -23,6 +23,10 @@ public RuntimeTypeChecking() { /** * EXPERIMENTAL + * + * @param arg1 + * @param arg2 + * @param arg3 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void methodWithDefaultedArguments(final java.lang.Number arg1, final java.lang.String arg2, final java.time.Instant arg3) { @@ -31,6 +35,9 @@ public void methodWithDefaultedArguments(final java.lang.Number arg1, final java /** * EXPERIMENTAL + * + * @param arg1 + * @param arg2 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void methodWithDefaultedArguments(final java.lang.Number arg1, final java.lang.String arg2) { @@ -39,6 +46,8 @@ public void methodWithDefaultedArguments(final java.lang.Number arg1, final java /** * EXPERIMENTAL + * + * @param arg1 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void methodWithDefaultedArguments(final java.lang.Number arg1) { @@ -55,6 +64,8 @@ public void methodWithDefaultedArguments() { /** * EXPERIMENTAL + * + * @param arg */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void methodWithOptionalAnyArgument(final java.lang.Object arg) { @@ -73,6 +84,10 @@ public void methodWithOptionalAnyArgument() { * Used to verify verification of number of method arguments. * * EXPERIMENTAL + * + * @param arg1 This parameter is required. + * @param arg2 This parameter is required. + * @param arg3 */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void methodWithOptionalArguments(final java.lang.Number arg1, final java.lang.String arg2, final java.time.Instant arg3) { @@ -83,6 +98,9 @@ public void methodWithOptionalArguments(final java.lang.Number arg1, final java. * Used to verify verification of number of method arguments. * * EXPERIMENTAL + * + * @param arg1 This parameter is required. + * @param arg2 This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void methodWithOptionalArguments(final java.lang.Number arg1, final java.lang.String arg2) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SecondLevelStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SecondLevelStruct.java index a2e3ad8b37..b8608b560a 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SecondLevelStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SecondLevelStruct.java @@ -40,7 +40,7 @@ public static final class Builder { /** * Sets the value of DeeperRequiredProp - * @param deeperRequiredProp It's long and required. + * @param deeperRequiredProp It's long and required. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonInt.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonInt.java index 5a1717c500..15a515de22 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonInt.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonInt.java @@ -22,6 +22,8 @@ protected SingletonInt(final software.amazon.jsii.JsiiObject.InitializationMode /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Boolean isSingletonInt(final java.lang.Number value) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonString.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonString.java index 874fa14df4..37ab275972 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonString.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SingletonString.java @@ -22,6 +22,8 @@ protected SingletonString(final software.amazon.jsii.JsiiObject.InitializationMo /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Boolean isSingletonString(final java.lang.String value) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableClass.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableClass.java index 98ac23ade7..9f65092787 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableClass.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableClass.java @@ -16,6 +16,8 @@ protected StableClass(final software.amazon.jsii.JsiiObject.InitializationMode i } /** + * @param readonlyString This parameter is required. + * @param mutableNumber */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Stable) public StableClass(final java.lang.String readonlyString, final java.lang.Number mutableNumber) { @@ -24,6 +26,7 @@ public StableClass(final java.lang.String readonlyString, final java.lang.Number } /** + * @param readonlyString This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Stable) public StableClass(final java.lang.String readonlyString) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableStruct.java index 745634dec6..26a05183b0 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StableStruct.java @@ -27,7 +27,7 @@ public static final class Builder { /** * Sets the value of ReadonlyProperty - * @param readonlyProperty the value to be set + * @param readonlyProperty the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Stable) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Statics.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Statics.java index d9707dfda4..bc4f83aa48 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Statics.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Statics.java @@ -25,6 +25,8 @@ protected Statics(final software.amazon.jsii.JsiiObject.InitializationMode initi /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public Statics(final java.lang.String value) { @@ -37,7 +39,7 @@ public Statics(final java.lang.String value) { * * EXPERIMENTAL * - * @param name The name of the person to say hello to. + * @param name The name of the person to say hello to. This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public static java.lang.String staticMethod(final java.lang.String name) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructPassing.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructPassing.java index ab14a39d99..38db22f547 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructPassing.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructPassing.java @@ -22,6 +22,8 @@ public StructPassing() { } /** + * @param _positional This parameter is required. + * @param inputs This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.External) public static java.lang.Number howManyVarArgsDidIPass(final java.lang.Number _positional, final software.amazon.jsii.tests.calculator.TopLevelStruct... inputs) { @@ -29,6 +31,8 @@ public static java.lang.Number howManyVarArgsDidIPass(final java.lang.Number _po } /** + * @param _positional This parameter is required. + * @param input This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.External) public static software.amazon.jsii.tests.calculator.TopLevelStruct roundTrip(final java.lang.Number _positional, final software.amazon.jsii.tests.calculator.TopLevelStruct input) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructWithJavaReservedWords.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructWithJavaReservedWords.java index 05f419e12b..4ec8701f2c 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructWithJavaReservedWords.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/StructWithJavaReservedWords.java @@ -50,7 +50,7 @@ public static final class Builder { /** * Sets the value of DefaultValue - * @param defaultValue the value to be set + * @param defaultValue the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -61,7 +61,7 @@ public Builder defaultValue(java.lang.String defaultValue) { /** * Sets the value of AssertValue - * @param assertValue the value to be set + * @param assertValue the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -72,7 +72,7 @@ public Builder assertValue(java.lang.String assertValue) { /** * Sets the value of Result - * @param result the value to be set + * @param result the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -83,7 +83,7 @@ public Builder result(java.lang.String result) { /** * Sets the value of That - * @param that the value to be set + * @param that the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SyncVirtualMethods.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SyncVirtualMethods.java index b1cf8e25c2..71126d93a7 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SyncVirtualMethods.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/SyncVirtualMethods.java @@ -39,6 +39,8 @@ public java.lang.Number callerIsMethod() { /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void modifyOtherProperty(final java.lang.String value) { @@ -47,6 +49,8 @@ public void modifyOtherProperty(final java.lang.String value) { /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void modifyValueOfTheProperty(final java.lang.String value) { @@ -87,6 +91,8 @@ public java.lang.String retrieveValueOfTheProperty() { /** * EXPERIMENTAL + * + * @param n This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number virtualMethod(final java.lang.Number n) { @@ -95,6 +101,8 @@ public java.lang.Number virtualMethod(final java.lang.Number n) { /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public void writeA(final java.lang.Number value) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/TopLevelStruct.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/TopLevelStruct.java index 401e606305..d697f1e156 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/TopLevelStruct.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/TopLevelStruct.java @@ -49,7 +49,7 @@ public static final class Builder { /** * Sets the value of Required - * @param required This is a required field. + * @param required This is a required field. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -60,7 +60,7 @@ public Builder required(java.lang.String required) { /** * Sets the value of SecondLevel - * @param secondLevel A union to really stress test our serialization. + * @param secondLevel A union to really stress test our serialization. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -71,7 +71,7 @@ public Builder secondLevel(java.lang.Number secondLevel) { /** * Sets the value of SecondLevel - * @param secondLevel A union to really stress test our serialization. + * @param secondLevel A union to really stress test our serialization. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnaryOperation.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnaryOperation.java index beddebad85..1c93bb8e71 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnaryOperation.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnaryOperation.java @@ -20,6 +20,8 @@ protected UnaryOperation(final software.amazon.jsii.JsiiObject.InitializationMod /** * EXPERIMENTAL + * + * @param operand This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) protected UnaryOperation(final software.amazon.jsii.tests.calculator.lib.Value operand) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnionProperties.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnionProperties.java index e06062bf05..3e0bb49b73 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnionProperties.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UnionProperties.java @@ -36,7 +36,7 @@ public static final class Builder { /** * Sets the value of Bar - * @param bar the value to be set + * @param bar the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -47,7 +47,7 @@ public Builder bar(java.lang.String bar) { /** * Sets the value of Bar - * @param bar the value to be set + * @param bar the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -58,7 +58,7 @@ public Builder bar(java.lang.Number bar) { /** * Sets the value of Bar - * @param bar the value to be set + * @param bar the value to be set. This parameter is required. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -69,7 +69,7 @@ public Builder bar(software.amazon.jsii.tests.calculator.AllTypes bar) { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -80,7 +80,7 @@ public Builder foo(java.lang.String foo) { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo the value to be set. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UsesInterfaceWithProperties.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UsesInterfaceWithProperties.java index b0d4a856ae..a20e15e230 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UsesInterfaceWithProperties.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/UsesInterfaceWithProperties.java @@ -18,6 +18,8 @@ protected UsesInterfaceWithProperties(final software.amazon.jsii.JsiiObject.Init /** * EXPERIMENTAL + * + * @param obj This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public UsesInterfaceWithProperties(final software.amazon.jsii.tests.calculator.IInterfaceWithProperties obj) { @@ -35,6 +37,8 @@ public java.lang.String justRead() { /** * EXPERIMENTAL + * + * @param ext This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String readStringAndNumber(final software.amazon.jsii.tests.calculator.IInterfaceWithPropertiesExtension ext) { @@ -43,6 +47,8 @@ public java.lang.String readStringAndNumber(final software.amazon.jsii.tests.cal /** * EXPERIMENTAL + * + * @param value This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.String writeAndRead(final java.lang.String value) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VariadicMethod.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VariadicMethod.java index 4f745f0f18..eaacffb9cf 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VariadicMethod.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VariadicMethod.java @@ -19,7 +19,7 @@ protected VariadicMethod(final software.amazon.jsii.JsiiObject.InitializationMod /** * EXPERIMENTAL * - * @param prefix a prefix that will be use for all values returned by `#asArray`. + * @param prefix a prefix that will be use for all values returned by `#asArray`. This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public VariadicMethod(final java.lang.Number... prefix) { @@ -30,8 +30,8 @@ public VariadicMethod(final java.lang.Number... prefix) { /** * EXPERIMENTAL * - * @param first the first element of the array to be returned (after the `prefix` provided at construction time). - * @param others other elements to be included in the array. + * @param first the first element of the array to be returned (after the `prefix` provided at construction time). This parameter is required. + * @param others other elements to be included in the array. This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.util.List asArray(final java.lang.Number first, final java.lang.Number... others) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VirtualMethodPlayground.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VirtualMethodPlayground.java index dea218bd0d..de20904d8a 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VirtualMethodPlayground.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/VirtualMethodPlayground.java @@ -23,6 +23,8 @@ public VirtualMethodPlayground() { /** * EXPERIMENTAL + * + * @param index This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number overrideMeAsync(final java.lang.Number index) { @@ -31,6 +33,8 @@ public java.lang.Number overrideMeAsync(final java.lang.Number index) { /** * EXPERIMENTAL + * + * @param index This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number overrideMeSync(final java.lang.Number index) { @@ -39,6 +43,8 @@ public java.lang.Number overrideMeSync(final java.lang.Number index) { /** * EXPERIMENTAL + * + * @param count This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number parallelSumAsync(final java.lang.Number count) { @@ -47,6 +53,8 @@ public java.lang.Number parallelSumAsync(final java.lang.Number count) { /** * EXPERIMENTAL + * + * @param count This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number serialSumAsync(final java.lang.Number count) { @@ -55,6 +63,8 @@ public java.lang.Number serialSumAsync(final java.lang.Number count) { /** * EXPERIMENTAL + * + * @param count This parameter is required. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public java.lang.Number sumSync(final java.lang.Number count) { diff --git a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/WithPrivatePropertyInConstructor.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/WithPrivatePropertyInConstructor.java index 1946d53ac8..ca0c5a6eab 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/WithPrivatePropertyInConstructor.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/WithPrivatePropertyInConstructor.java @@ -20,6 +20,8 @@ protected WithPrivatePropertyInConstructor(final software.amazon.jsii.JsiiObject /** * EXPERIMENTAL + * + * @param privateField */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public WithPrivatePropertyInConstructor(final java.lang.String privateField) {