From a15666fd95164a1e4839d44fc03446476fc9c125 Mon Sep 17 00:00:00 2001 From: Dongie Agnir Date: Tue, 3 Sep 2019 16:44:19 -0700 Subject: [PATCH] feat(java): when generating builders indicate for each property if it's required in the docs Fixes #365 --- packages/jsii-pacmak/lib/targets/java.ts | 34 ++++++++++++++----- .../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 | 8 ++++- .../tests/calculator/CalculatorProps.java | 4 +-- .../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 | 18 +++++----- .../DiamondInheritanceBaseLevelStruct.java | 2 +- ...DiamondInheritanceFirstMidLevelStruct.java | 4 +-- ...iamondInheritanceSecondMidLevelStruct.java | 4 +-- .../DiamondInheritanceTopLevelStruct.java | 8 ++--- .../calculator/DoNotOverridePrivates.java | 2 ++ .../DoNotRecognizeAnyAsOptional.java | 9 +++++ .../tests/calculator/DocumentedClass.java | 2 +- ...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 ++++ .../amazon/jsii/tests/calculator/Greetee.java | 2 +- .../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 ++ .../LoadBalancedFargateServiceProps.java | 10 +++--- .../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 | 4 +-- .../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 | 8 ++--- .../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 ++ 77 files changed, 311 insertions(+), 87 deletions(-) diff --git a/packages/jsii-pacmak/lib/targets/java.ts b/packages/jsii-pacmak/lib/targets/java.ts index ebe1c665e3..687274ba82 100644 --- a/packages/jsii-pacmak/lib/targets/java.ts +++ b/packages/jsii-pacmak/lib/targets/java.ts @@ -928,11 +928,8 @@ class JavaGenerator extends Generator { // Start property setter 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) || undefined; + 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}`); @@ -1180,9 +1177,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)); } } } @@ -1504,3 +1500,25 @@ 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 { + let documentation; + if (summary) { + documentation = summary; + } else { + documentation = ''; + } + + if (documentation.length > 0) { + if (!documentation.endsWith('.')) { + documentation += '.'; + } + documentation += " "; + } + + if (!optional) { + documentation += 'This parameter is required.'; + } + + return `@param ${name} ${documentation}`; +} 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 25803b1e4a..fccb401bfa 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 @@ final class Builder { /** * Sets the value of Bar - * @param bar the value to be set + * @param bar 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 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 4eeeb87d06..803495f763 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 @@ 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 * @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 37995de83d..68496eebc5 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 @@ -19,7 +19,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 4296680e3f..590f842259 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 @@ 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 * @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 * @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 d9f770d9ec..6302f7a100 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 @@ -22,6 +22,8 @@ public 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); @@ -72,6 +74,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 0c11d3b111..926004b518 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 @@ -22,8 +22,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 fb9bee1f79..210ca5de14 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 @@ -27,6 +27,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) { @@ -43,6 +45,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 7a04386201..e6c0347e81 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 @@ -22,6 +22,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) { @@ -32,6 +35,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) { @@ -40,6 +45,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) { @@ -50,6 +59,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 6adfc252f5..1dc85a3142 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 @@ -62,6 +62,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 7202f847f2..8bb132cb30 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 @@ -22,8 +22,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) public 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 9e1d9cc780..e9b7a930e0 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 @@ -22,7 +22,7 @@ protected Calculator(final software.amazon.jsii.JsiiObject.InitializationMode in * * EXPERIMENTAL * - * @param props Initialization properties. + * @param props Initialization properties. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) public Calculator(final software.amazon.jsii.tests.calculator.CalculatorProps props) { @@ -44,6 +44,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) { @@ -54,6 +56,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) { @@ -74,6 +78,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 07a4619c09..5089005eb8 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 @@ final class Builder { /** * Sets the value of InitialValue - * @param initialValue the value to be set + * @param initialValue * @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 * @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/ClassWithJavaReservedWords.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/ClassWithJavaReservedWords.java index 6ba0583a7c..8ba0a8d071 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 @@ -17,6 +17,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) { @@ -26,6 +28,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 05435a3778..64e39d4f94 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 @@ -17,6 +17,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 46c60e9686..a5bd5c8eb2 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 @@ -22,6 +22,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) { @@ -30,6 +32,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 e43f3b4c3c..102041e7a4 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 @@ -28,6 +28,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) { @@ -44,6 +46,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) { @@ -52,6 +56,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 50ea2a0cee..b1e9ef6b06 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 @@ -17,6 +17,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) { @@ -25,6 +29,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) { @@ -33,6 +40,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 6f5dfd0635..4048e9df71 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 @@ -18,6 +18,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) @@ -27,6 +29,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 a2d1e77523..0ab5a9bbfb 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 @@ final class Builder { /** * Sets the value of ReadonlyProperty - * @param readonlyProperty the value to be set + * @param readonlyProperty 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 4fb30548b9..e25f2ce081 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 @@ final class Builder { /** * Sets the value of AnotherRequired - * @param anotherRequired the value to be set + * @param anotherRequired 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 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) @@ -106,7 +106,7 @@ public Builder nonPrimitive(software.amazon.jsii.tests.calculator.DoubleTrouble /** * Sets the value of AnotherOptional - * @param anotherOptional This is optional. + * @param anotherOptional This is optional. * @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 * @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 7330fc57bb..bd434eea53 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 @@ final class Builder { /** * Sets the value of BaseLevelProperty - * @param baseLevelProperty the value to be set + * @param baseLevelProperty 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 812f61bea4..a7f0c5f47c 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 @@ final class Builder { /** * Sets the value of FirstMidLevelProperty - * @param firstMidLevelProperty the value to be set + * @param firstMidLevelProperty 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 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 8a7b7408e7..efb49eb77d 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 @@ final class Builder { /** * Sets the value of SecondMidLevelProperty - * @param secondMidLevelProperty the value to be set + * @param secondMidLevelProperty 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 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 8b52c96829..2050da15e4 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 @@ final class Builder { /** * Sets the value of TopLevelProperty - * @param topLevelProperty the value to be set + * @param topLevelProperty 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 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 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 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 5c56bade39..d80b10e2c0 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 @@ -22,6 +22,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 5f6141ebf3..587f77f967 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 @@ -24,6 +24,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) { @@ -32,6 +36,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) { @@ -40,6 +47,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/DocumentedClass.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DocumentedClass.java index 895327a22a..6b4b337929 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DocumentedClass.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/DocumentedClass.java @@ -32,7 +32,7 @@ public DocumentedClass() { * the indicated person. * * @return A number that everyone knows very well - * @param greetee The person to be greeted. + * @param greetee The person to be greeted. */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Stable) public java.lang.Number greet(final software.amazon.jsii.tests.calculator.Greetee greetee) { 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 afe52be5f5..a0a83739db 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 @@ -22,6 +22,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 512abba9f1..8ed771a6d3 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 @@ -27,6 +27,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 5fd21d724e..a5ac5804b6 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 @@ final class Builder { /** * Sets the value of Option1 - * @param option1 the value to be set + * @param option1 * @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 * @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 05ceaccd75..15245cfe24 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 @@ -17,6 +17,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) { @@ -25,6 +28,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 d60f19a64e..85394db838 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 @@ final class Builder { /** * Sets the value of ReadonlyProperty - * @param readonlyProperty the value to be set + * @param readonlyProperty 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 60db89d173..ec2370a254 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 @@ -17,6 +17,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 ff58444dd8..645ab4d35e 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 @@ final class Builder { /** * Sets the value of Boom - * @param boom the value to be set + * @param boom 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 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 b7e41a95ac..cebd9aaf8e 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 @@ -24,6 +24,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) { @@ -34,6 +36,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) { @@ -44,6 +48,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/Greetee.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Greetee.java index a0b6a984cd..7ed9bbcd16 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Greetee.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Greetee.java @@ -35,7 +35,7 @@ final class Builder { /** * Sets the value of Name - * @param name The name of the greetee. + * @param name The name of the greetee. * @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/GreetingAugmenter.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/GreetingAugmenter.java index d71304b314..675f1ad21d 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 @@ -22,6 +22,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 cd55d03ff3..bb593e91b1 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 @@ -10,12 +10,17 @@ public interface IInterfaceWithOptionalMethodArguments extends software.amazon.jsii.JsiiSerializable { /** * 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 3c041fb66a..f2e0634249 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 @@ final class Builder { /** * Sets the value of Goo - * @param goo the value to be set + * @param goo 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 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 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 e563a08714..cee1635b1b 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 @@ final class Builder { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo 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 3606e5c69a..5a3178460e 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 @@ final class Builder { /** * Sets the value of Foo - * @param foo the value to be set + * @param foo 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 02260f8e0c..ad1d2c0776 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 720e3e8a4c..76da064214 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 @@ -17,6 +17,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/LoadBalancedFargateServiceProps.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/LoadBalancedFargateServiceProps.java index 92614d2bca..1308037cdd 100644 --- a/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/LoadBalancedFargateServiceProps.java +++ b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/LoadBalancedFargateServiceProps.java @@ -98,7 +98,7 @@ final class Builder { /** * Sets the value of ContainerPort - * @param containerPort The container port of the application load balancer attached to your Fargate service. + * @param containerPort The container port of the application load balancer attached to your Fargate service. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -109,7 +109,7 @@ public Builder containerPort(java.lang.Number containerPort) { /** * Sets the value of Cpu - * @param cpu The number of cpu units used by the task. Valid values, which determines your range of valid values for the memory parameter: 256 (.25 vCPU) - Available memory values: 0.5GB, 1GB, 2GB 512 (.5 vCPU) - Available memory values: 1GB, 2GB, 3GB, 4GB 1024 (1 vCPU) - Available memory values: 2GB, 3GB, 4GB, 5GB, 6GB, 7GB, 8GB 2048 (2 vCPU) - Available memory values: Between 4GB and 16GB in 1GB increments 4096 (4 vCPU) - Available memory values: Between 8GB and 30GB in 1GB increments. + * @param cpu The number of cpu units used by the task. Valid values, which determines your range of valid values for the memory parameter: 256 (.25 vCPU) - Available memory values: 0.5GB, 1GB, 2GB 512 (.5 vCPU) - Available memory values: 1GB, 2GB, 3GB, 4GB 1024 (1 vCPU) - Available memory values: 2GB, 3GB, 4GB, 5GB, 6GB, 7GB, 8GB 2048 (2 vCPU) - Available memory values: Between 4GB and 16GB in 1GB increments 4096 (4 vCPU) - Available memory values: Between 8GB and 30GB in 1GB increments. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -120,7 +120,7 @@ public Builder cpu(java.lang.String cpu) { /** * Sets the value of MemoryMiB - * @param memoryMiB The amount (in MiB) of memory used by the task. + * @param memoryMiB The amount (in MiB) of memory used by the task. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -131,7 +131,7 @@ public Builder memoryMiB(java.lang.String memoryMiB) { /** * Sets the value of PublicLoadBalancer - * @param publicLoadBalancer Determines whether the Application Load Balancer will be internet-facing. + * @param publicLoadBalancer Determines whether the Application Load Balancer will be internet-facing. * @return {@code this} */ @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental) @@ -142,7 +142,7 @@ public Builder publicLoadBalancer(java.lang.Boolean publicLoadBalancer) { /** * Sets the value of PublicTasks - * @param publicTasks Determines whether your Fargate Service will be assigned a public IP address. + * @param publicTasks Determines whether your Fargate Service will be assigned a public IP address. * @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/Multiply.java b/packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/Multiply.java index d5c2375666..5911386ac4 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 @@ -22,8 +22,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 d1c00ab618..ecd3c9cbec 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 @@ -19,6 +19,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 439eafd2e8..5e69490d94 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 @@ -19,6 +19,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) { @@ -27,6 +30,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) { @@ -36,6 +41,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) { @@ -52,6 +59,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 0fd84a1e36..c61c2b9fb5 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 @@ final class Builder { /** * Sets the value of ArrayWithThreeElementsAndUndefinedAsSecondArgument - * @param arrayWithThreeElementsAndUndefinedAsSecondArgument the value to be set + * @param arrayWithThreeElementsAndUndefinedAsSecondArgument 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 * @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 e250c27984..d655fe1252 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 @@ -19,6 +19,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) { @@ -28,6 +30,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 70dd001afa..da84dd5688 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 @@ -26,6 +26,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) { @@ -36,6 +38,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 97ca59c10c..0f1e90a826 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 @@ -17,6 +17,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) { @@ -25,6 +29,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 bed34b5eba..a6002fe858 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 @@ final class Builder { /** * Sets the value of Field - * @param field the value to be set + * @param field * @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 dac51b97a5..595ba04b0b 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 @@ -17,6 +17,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 b6f11d3f7c..4774142b62 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 @@ -22,6 +22,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 96c668f206..c704104868 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 @@ -22,6 +22,10 @@ public 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); @@ -37,6 +41,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 7e04a017f4..6c794aeab2 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 @@ -22,6 +22,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 0e1f04f2f8..ade35af3e8 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 @@ -22,8 +22,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 1e7d2215f6..e7b3e64158 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 @@ -32,6 +32,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 b2db272724..eb2e9de6f2 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 @@ -22,6 +22,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) { @@ -30,6 +34,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) { @@ -38,6 +45,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) { @@ -54,6 +63,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) { @@ -72,6 +83,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) { @@ -82,6 +97,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 35a695278a..d4bf54bf5c 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 @@ 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) @@ -51,7 +51,7 @@ public Builder deeperRequiredProp(java.lang.String deeperRequiredProp) { /** * Sets the value of DeeperOptionalProp - * @param deeperOptionalProp It's long, but you'll almost never pass it. + * @param deeperOptionalProp It's long, but you'll almost never pass it. * @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 c3fdd50b87..5254835f5a 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 @@ -15,6 +15,8 @@ protected StableClass(final software.amazon.jsii.JsiiObject.InitializationMode i super(initializationMode); } /** + * @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) { @@ -22,6 +24,7 @@ public StableClass(final java.lang.String readonlyString, final java.lang.Number this.setObjRef(software.amazon.jsii.JsiiEngine.getInstance().createNewObject(this, new Object[] { java.util.Objects.requireNonNull(readonlyString, "readonlyString is required"), mutableNumber })); } /** + * @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 7d9fde5561..39e863ecd8 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 @@ final class Builder { /** * Sets the value of ReadonlyProperty - * @param readonlyProperty the value to be set + * @param readonlyProperty 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 53d23568b7..f56128baf4 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 @@ -23,6 +23,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) { @@ -35,7 +37,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 e80fb04617..118e923be2 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 @@ -21,6 +21,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) { @@ -28,6 +30,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 dce2d83726..08ff529126 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 @@ final class Builder { /** * Sets the value of DefaultValue - * @param defaultValue the value to be set + * @param defaultValue 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 * @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 * @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 * @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 66cd8f166a..76bc18990f 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 @@ -38,6 +38,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) { @@ -46,6 +48,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) { @@ -86,6 +90,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) { @@ -94,6 +100,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 790d399a0c..e4720ee1bf 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 @@ 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) @@ -82,7 +82,7 @@ public Builder secondLevel(software.amazon.jsii.tests.calculator.SecondLevelStru /** * Sets the value of Optional - * @param optional You don't have to pass this. + * @param optional You don't have to pass this. * @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 6e2b081a83..4fe420722d 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 @@ -19,6 +19,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) public 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 e1d44eb853..4fcf853e8e 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 @@ final class Builder { /** * Sets the value of Bar - * @param bar the value to be set + * @param bar 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 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 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 * @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 * @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 9ce564f56d..9d4ead1d9e 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 @@ -17,6 +17,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) { @@ -34,6 +36,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) { @@ -42,6 +46,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 f3571046f8..06515aeb0b 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 @@ -18,7 +18,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) { @@ -29,8 +29,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 c830f18785..3b93c1e461 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 @@ -22,6 +22,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) { @@ -30,6 +32,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) { @@ -38,6 +42,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) { @@ -46,6 +52,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) { @@ -54,6 +62,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 86bf2672e8..af8f69e307 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 @@ -19,6 +19,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) {