From a8a0aa1252105650eb3d023307f0eb449419bac1 Mon Sep 17 00:00:00 2001 From: Ivan Goncharov Date: Sun, 26 Aug 2018 00:55:00 +0300 Subject: [PATCH] Add missing deprecation comments --- src/utilities/extendSchema.js | 1 + src/utilities/schemaPrinter.js | 12 +++++++++++- 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/src/utilities/extendSchema.js b/src/utilities/extendSchema.js index ffe0f9ed40..62b184a5be 100644 --- a/src/utilities/extendSchema.js +++ b/src/utilities/extendSchema.js @@ -68,6 +68,7 @@ type Options = {| * Descriptions are defined as preceding string literals, however an older * experimental version of the SDL supported preceding comments as * descriptions. Set to true to enable this deprecated behavior. + * This option is provided to ease adoption and will be removed in v16. * * Default: false */ diff --git a/src/utilities/schemaPrinter.js b/src/utilities/schemaPrinter.js index a630f27d23..aa9b01c096 100644 --- a/src/utilities/schemaPrinter.js +++ b/src/utilities/schemaPrinter.js @@ -38,7 +38,17 @@ import { } from '../type/directives'; import { isIntrospectionType } from '../type/introspection'; -type Options = {| commentDescriptions?: boolean |}; +type Options = {| + /** + * Descriptions are defined as preceding string literals, however an older + * experimental version of the SDL supported preceding comments as + * descriptions. Set to true to enable this deprecated behavior. + * This option is provided to ease adoption and will be removed in v16. + * + * Default: false + */ + commentDescriptions?: boolean, +|}; /** * Accepts options as a second argument: