@sap/cds-compiler 2.12.0 → 2.15.2

package/lib/model/enrichCsn.js

@@ -61,10 +61,14 @@ function enrichCsn( csn, options = {} ) {
     // TODO: excluding
     '@': () => { /* ignore annotations */ },
   }
-  setLocations( csn, false, null );
-  const { inspectRef, artifactRef, getOrigin, __getCache_forEnrichCsnDebugging } =
-      csnRefs( csn );
+  // options.enrichCsn = 'DEBUG';
   let $$cacheObjectNumber = 0;   // for debugging
+  const debugLocationInfo = options.enrichCsn === 'DEBUG' && Object.create(null);
+
+  setLocations( csn, false, null );
+  const { inspectRef, artifactRef, getOrigin, initDefinition, __getCache_forEnrichCsnDebugging } =
+        csnRefs( csn, true );
+
   const csnPath = [];
   if (csn.definitions)
     dictionary( csn, 'definitions', csn.definitions );
@@ -107,6 +111,8 @@ function enrichCsn( csn, options = {} ) {
       return;
     csnPath.push( prop );
     for (let name of Object.getOwnPropertyNames( dict )) {
+      if (prop === 'definitions')
+        initDefinition( dict[name] );
       definition( dict, name, dict[name] );
     }
     if (!Object.prototype.propertyIsEnumerable.call( parent, prop ))
@@ -115,11 +121,19 @@ function enrichCsn( csn, options = {} ) {
   }
 
   function refLocation( art ) {
-    if (art && typeof art === 'object')
-      return art.$location || '<no location>';
+    if (!art || typeof art !== 'object' || Array.isArray( art )) {
+      if (!options.testMode)
+        return (typeof art === 'string')
+        ? `<illegal ref = ${art}>`
+        : `<illegal ref: ${typeof art}>`;
+      throw new Error( 'Illegal reference' );
+    }
+    else if (art.$location)
+      return art.$location;
+
     if (!options.testMode)
-      return art || '<illegal link>';
-    throw new Error( 'Undefined reference' );
+      return `<${Object.keys( art ).join('+')}+!$location>`;
+    throw new Error( 'Reference to object without $location' );
   }
 
   function simpleRef( parent, prop, ref ) {
@@ -138,6 +152,7 @@ function enrichCsn( csn, options = {} ) {
     else {                      // targetAspect, target
       csnPath.push( prop );
       dictionary( ref, 'elements', ref.elements );
+      _cache_debug( ref );
       csnPath.pop();
     }
     // } catch (e) {
@@ -242,6 +257,10 @@ function enrichCsn( csn, options = {} ) {
             obj.$$cacheObject[name] = sub;
           }
         }
+        else if (name === '$origin$step') { // string value handled above
+          const kind = Object.keys( val )[0];
+          obj.$$cacheObject[name] = `${kind}: ${ val[kind] }`;
+        }
         else if (Array.isArray( val )) {
           obj.$$cacheObject[name] = val.map( item => {
             if (!item.$$objectNumber)
@@ -257,8 +276,53 @@ function enrichCsn( csn, options = {} ) {
       }
     }
   }
+
+  function debugLocation( loc, userProvided ) {
+    if (debugLocationInfo && !userProvided) {
+      loc = loc.replace( /\([0-9]+\)\^/, '^' );
+      debugLocationInfo[loc] = (debugLocationInfo[loc] || 0) + 1;
+      loc = `${loc}(${debugLocationInfo[loc]})`;
+    }
+    return loc;
+  }
+
+  function setLocations( node, prop, loc ) {
+    if (!node || typeof node !== 'object')
+      return;
+    const isMember = artifactProperties.includes( prop );
+    if (!isMember && node.$location) {
+      if (typeof node.$location === 'string') // already set for nested 'items'
+        return;
+      loc = locationString( node.$location, true );
+      if (!node.SELECT) // compatibility: $location of query both inside and as sibling of SELECT
+        reveal( node, '$location', debugLocation( loc, !node.$generated ) );
+    }
+    else if (prop === true || prop === 'returns') { // in dictionary or returns
+      loc = debugLocation( loc + '^' );
+      node.$location = loc;
+    }
+    else if (prop === 'items') {
+      let iloc = loc + '[]';
+      let obj = node;
+      while (obj) {
+        // should not appear in --enrich-csn, only for _origin info
+        Object.defineProperty( obj, '$location', { value: iloc, enumerable: false } );
+        obj = obj.items;
+        iloc += '[]';
+      }
+    }
+    if (Array.isArray( node )) {
+      for (const item of node)
+        setLocations( item, isMember, loc );
+    }
+    else {
+      for (const name of Object.getOwnPropertyNames( node ))
+        setLocations( node[name], isMember || name, loc );
+    }
+  }
 }
 
+
 function reveal( node, prop, value ) {
   Object.defineProperty( node, prop, {
     value,
@@ -268,26 +332,4 @@ function reveal( node, prop, value ) {
   } );
 }
 
-function setLocations( node, prop, loc ) {
-  if (!node || typeof node !== 'object')
-    return;
-  const isMember = artifactProperties.includes( prop );
-  if (!isMember && node.$location) {
-    loc = locationString( node.$location, true );
-    reveal( node, '$location', loc );
-  }
-  else if (prop === true) {
-    loc += '^';
-    node.$location = loc;
-  }
-  if (Array.isArray( node )) {
-    for (const item of node)
-      setLocations( item, isMember, loc );
-  }
-  else {
-    for (const name of Object.getOwnPropertyNames( node ))
-      setLocations( node[name], isMember || name, loc );
-  }
-}
-
 module.exports = enrichCsn;

package/lib/model/revealInternalProperties.js

@@ -36,7 +36,7 @@ const kindsRepresentedAsLinks = {
   // represent table alias in from / join-args property as link:
   $tableAlias: tableAliasAsLink,
   // represent "navigation elemens" in _combined as links:
-  $navElement: (art, parent) => art._parent && parent !== art._parent.elements,
+  $navElement: (art, parent) => art._parent && parent !== art._parent.elements && art._parent.kind !== 'aspect',
   // represent mixin in $tableAliases as link:
   mixin: tableAliasAsLink,
   // represent $projection as link, as it is just another search name for $self:
@@ -50,7 +50,16 @@ function tableAliasAsLink( art, parent, name ) {
       parent === art._parent.$tableAliases[name].$duplicates);
 }
 
-function revealInternalProperties( model, name ) {
+/**
+ * Reveal internal properties of `model` for the given artifact name (or path).
+ * `path` could be a definition name or a `/`-separated XSN path such as
+ * `name.space/S/E/elements/a/type/scope/`.
+ *
+ * @param {XSN.Model} model
+ * @param {string} [nameOrPath]
+ * @returns {string}
+ */
+function revealInternalProperties( model, nameOrPath ) {
   const transformers = {
     messages: m => m,
     name: shortenName,
@@ -76,6 +85,7 @@ function revealInternalProperties( model, name ) {
     $tableAliases: dictionary,
     $duplicates: duplicates,
     $keysNavigation: dictionary,
+    targetAspect,
     $layerNumber: n => n,
     $extra: e => e,
     _layerRepresentative: s => s.realname,
@@ -89,7 +99,7 @@ function revealInternalProperties( model, name ) {
     $messageFunctions: () => '‹some functions›',
   }
   unique_id = 1;
-  return revealXsnPath(name, model);
+  return revealXsnPath(nameOrPath, model);
 
   // Returns the desired artifact/dictionary in the XSN.
   //
@@ -119,7 +129,7 @@ function revealInternalProperties( model, name ) {
 
     path = path.split('/');
     if (path.length === 1) {
-      return reveal( xsn.definitions[path] );
+      return reveal( xsn.definitions[path] || xsn.vocabularies && xsn.vocabularies[path] );
     }
 
     // with the code below, we might miss the right transformer function
@@ -259,6 +269,12 @@ function revealInternalProperties( model, name ) {
     return r;
   }
 
+  function targetAspect( node, parent ) {
+    if (node.elements && unique_id && node.__unique_id__ == null)
+      Object.defineProperty( node, '__unique_id__', { value: ++unique_id } );
+    return reveal( node, parent );
+  }
+
   function duplicates( node, parent ) {
     return reveal( node, parent, parent.name && parent.name.id );
   }
@@ -272,10 +288,12 @@ function artifactIdentifier( node, parent ) {
   let outer = unique_id ? '##' + node.__unique_id__ : '';
   if (node._outer) {
     if (node.$inferred === 'REDIRECTED')
-      outer = '/redirected';
+      outer = '/redirected' + outer;
     else
-      outer = (node._outer.items === node) ? '/items'
-            : (node._outer.returns === node) ? '/returns' : '/returns/items';
+      outer = (node._outer.items === node) ? '/items' + outer
+            : (node._outer.returns === node) ? '/returns' + outer
+            : (node._outer.targetAspect === node) ? '/target' + outer
+            : '/returns/items' + outer;
     node = node._outer;
   }
   if (node === parent)
@@ -305,7 +323,10 @@ function artifactIdentifier( node, parent ) {
       return 'source:' + quoted( node.location && node.location.file ) +
         '/using:' + quoted( node.name.id )
     default: {
-      return ((node._main || node).kind || '<kind>') + ':' + msg.artName( node ) + outer;
+      let main = node._main;
+      while (main && main._outer) // anonymous aspect
+        main = main._outer._main;
+      return ((main || node).kind || '<kind>') + ':' + msg.artName( node ) + outer;
     }
   }
 }

package/lib/model/sortViews.js

@@ -1,5 +1,6 @@
 'use strict';
 const {setDependencies} = require('./csnUtils');
+const { ModelError } = require("../base/error");
 
 /**
  * @typedef {Object} Layers
@@ -91,7 +92,7 @@ module.exports = function({sql, csn}){
   const { layers, leftover } = sortTopologically(csn, _dependents, _dependencies);
   cleanup.forEach(fn => fn());
   if(leftover.length > 0)
-    throw new Error('Unable to build a correct dependency graph! Are there cycles?');
+    throw new ModelError('Unable to build a correct dependency graph! Are there cycles?');
 
   const result = [];
   // keep the "artifact name" - needed for to.hdi sorting

package/lib/modelCompare/compare.js

@@ -6,13 +6,14 @@ const {
   forEachMember,
   hasAnnotationValue
 } = require('../model/csnUtils');
+const { isBetaEnabled } = require('../base/model');
 
 /**
  * Compares two models, in HANA-transformed CSN format, to each other.
  *
  * @param beforeModel the before-model
  * @param afterModel the after-model
- * @param {import('../api/main.js').hdiOptions|false} options
+ * @param {HdiOptions|false} options
  * @returns {object} the sets of deletions, extensions, and migrations of entities necessary to transform the before-model
  * to the after-model, together with all the definitions of the after-model
  */
@@ -26,8 +27,8 @@ function compareModels(beforeModel, afterModel, options) {
   const migrations = []; // element changes/removals or changes of entity properties
 
   // There is currently no use in knowing the added entities only. If this changes, hand in `addedEntities` to `getArtifactComparator` below.
-  forEachDefinition(afterModel, getArtifactComparator(beforeModel, null, null, elementAdditions, migrations));
-  forEachDefinition(beforeModel, getArtifactComparator(afterModel, null, deletedEntities, null, null));
+  forEachDefinition(afterModel, getArtifactComparator(beforeModel, options, null, null, elementAdditions, migrations));
+  forEachDefinition(beforeModel, getArtifactComparator(afterModel, options, null, deletedEntities, null, null));
 
   const returnObj = Object.create(null);
   returnObj.definitions = afterModel.definitions;
@@ -44,23 +45,23 @@ function validateCsnVersions(beforeModel, afterModel, options) {
   let afterVersionParts = afterVersion && afterVersion.split('.');
 
   if (!beforeVersionParts || beforeVersionParts.length < 2) {
-    const { error, throwWithError } = makeMessageFunction(beforeModel, options, 'modelCompare');
+    const { error, throwWithAnyError } = makeMessageFunction(beforeModel, options, 'modelCompare');
     error(null, null, `Invalid CSN version: ${beforeVersion}`);
-    throwWithError();
+    throwWithAnyError();
   }
   if (!afterVersionParts || afterVersionParts.length < 2) {
-    const { error, throwWithError } = makeMessageFunction(afterModel, options, 'modelCompare');
+    const { error, throwWithAnyError } = makeMessageFunction(afterModel, options, 'modelCompare');
     error(null, null, `Invalid CSN version: ${afterVersion}`);
-    throwWithError();
+    throwWithAnyError();
   }
   if (beforeVersionParts[0] > afterVersionParts[0] && !(options && options.allowCsnDowngrade)) {
-    const { error, throwWithError } = makeMessageFunction(afterModel, options, 'modelCompare');
+    const { error, throwWithAnyError } = makeMessageFunction(afterModel, options, 'modelCompare');
     error(null, null, `Incompatible CSN versions: ${afterVersion} is a major downgrade from ${beforeVersion}. Is @sap/cds-compiler version ${require('../../package.json').version} outdated?`);
-    throwWithError();
+    throwWithAnyError();
   }
 }
 
-function getArtifactComparator(otherModel, addedEntities, deletedEntities, elementAdditions, migrations) {
+function getArtifactComparator(otherModel, options, addedEntities, deletedEntities, elementAdditions, migrations) {
   return function compareArtifacts(artifact, name) {
     function addElements() {
       const elements = {};
@@ -70,7 +71,11 @@ function getArtifactComparator(otherModel, addedEntities, deletedEntities, eleme
       }
     }
     function changePropsOrRemoveOrChangeElements() {
-      const relevantProperties = ['doc'];
+      const relevantProperties = [
+        { name: 'doc' },
+        { name: '@sql.prepend' },
+        { name: '@sql.append' },
+      ];
       const changedProperties = {};
 
       const removedElements = {};
@@ -79,8 +84,8 @@ function getArtifactComparator(otherModel, addedEntities, deletedEntities, eleme
       const migration = { migrate: name };
 
       relevantProperties.forEach(prop => {
-        if (artifact[prop] !== otherArtifact[prop]) {
-          changedProperties[prop] = changedElement(artifact[prop], otherArtifact[prop] || null);
+        if (artifact[prop.name] !== otherArtifact[prop.name] && (!prop.beta || isBetaEnabled(options, prop.beta))) {
+          changedProperties[prop.name] = changedElement(artifact[prop.name], otherArtifact[prop.name] || null);
         }
       });
       if (Object.keys(changedProperties).length > 0) {
@@ -150,7 +155,7 @@ function isPersistedAsTable(artifact) {
       && !hasAnnotationValue(artifact, '@cds.persistence.exists');
 }
 
-function getElementComparator(otherArtifact, addedElements = null, changedElements = null) {
+function getElementComparator(otherArtifact, addedElementsDict = null, changedElementsDict = null) {
   return function compareElements(element, name) {
     if (element._ignore) {
       return;
@@ -159,19 +164,19 @@ function getElementComparator(otherArtifact, addedElements = null, changedElemen
     const otherElement = otherArtifact.elements[name];
     if (otherElement && !otherElement._ignore) {
       // Element type changed?
-      if (!changedElements) {
+      if (!changedElementsDict) {
         return;
       }
       if (relevantTypeChange(element.type, otherElement.type) || typeParametersChanged(element, otherElement)) {
         // Type or parameters, e.g. association target, changed.
-        changedElements[name] = changedElement(element, otherElement);
+        changedElementsDict[name] = changedElement(element, otherElement);
       }
 
       return;
     }
 
-    if (addedElements) {
-      addedElements[name] = element;
+    if (addedElementsDict) {
+      addedElementsDict[name] = element;
     }
   }
 }

package/lib/optionProcessor.js

@@ -11,7 +11,9 @@ const optionProcessor = createOptionProcessor();
 optionProcessor
   .option('-h, --help')
   .option('-v, --version')
+  .option('    --options <file>')
   .option('-w, --warning <level>', ['0', '1', '2', '3'])
+  .option('    --quiet')
   .option('    --show-message-id')
   .option('    --no-message-context')
   .option('    --color <mode>', ['auto', 'always', 'never'])
@@ -22,16 +24,15 @@ optionProcessor
   .option('    --trace-parser')
   .option('    --trace-parser-amb')
   .option('    --trace-fs')
+  .option('    --error <id-list>')
+  .option('    --warn <id-list>')
+  .option('    --info <id-list>')
+  .option('    --debug <id-list>')
   .option('-E, --enrich-csn')
   .option('-R, --raw-output <name>')
   .option('    --internal-msg')
   .option('    --beta-mode')
   .option('    --beta <list>')
-  .option('    --integrity-not-validated')
-  .option('    --integrity-not-enforced')
-  .option('    --assert-integrity <mode>', [ 'true', 'false', 'individual' ])
-  .option('    --assert-integrity-type <type>', [ 'RT', 'DB' ], { ignoreCase: true })
-  .option('    --constraints-as-alter <boolean>')
   .option('    --deprecated <list>')
   .option('    --hana-flavor')
   .option('    --direct-backend')
@@ -59,17 +60,21 @@ optionProcessor
   General options
    -h, --help               Show this help text
    -v, --version            Display version number and exit
+       --quiet              Don't emit anything, neither results nor messages.
    -w, --warning <level>    Show messages up to <level>
                               0: Error
                               1: Warnings
                               2: (default) Info
                               3: Debug
+       --options <file>     Use the given JSON file as input options.
+                            The key 'cdsc' of 'cds' is used. If not present 'cdsc' is used.
+                            Otherwise, the JSON as-is is used as options.
        --show-message-id    Show message ID in error, warning and info messages
        --no-message-context Print messages as single lines without code context (useful for
-                            redirecting output to other processes). Default is to print human
+                            redirecting output to other processes). Default is to print human-
                             readable text similar to Rust's compiler with a code excerpt.
        --color <mode>       Use colors for warnings. Modes are:
-                              auto: (default) Detect color support of the tty.
+                              auto: (default) Detect color support of the TTY.
                               always:
                               never:
    -o, --out <dir>          Place generated files in directory <dir>, default is "-" for <stdout>
@@ -87,6 +92,13 @@ optionProcessor
        --trace-parser-amb   Trace parser ambiguities
        --trace-fs           Trace file system access caused by "using from"
 
+  Severity options
+    Use these options to reclassify messages.  Option argument is a comma separated list of message IDs.
+       --error <id-list>    IDs that should be reclassified to errors.
+       --warn  <id-list>    IDs that should be reclassified to warnings.
+       --info  <id-list>    IDs that should be reclassified to info messages.
+       --debug <id-list>    IDs that should be reclassified to debug messages.
+
   Internal options (for testing only, may be changed/removed at any time)
    -E, --enrich-csn         Show non-enumerable CSN properties and locations of references
    -R, --raw-output <name>  Write XSN for definition "name" and error output to <stdout>,
@@ -99,22 +111,6 @@ optionProcessor
                               hanaAssocRealCardinality
                               mapAssocToJoinCardinality
                               ignoreAssocPublishingInUnion
-       --integrity-not-enforced          If this option is supplied, referential constraints are NOT ENFORCED.
-                                         This option is also applied to result of "cdsc manageConstraints"
-       --integrity-not-validated         If this option is supplied, referential constraints are NOT VALIDATED.
-                                         This option is also applied to result of "cdsc manageConstraints"
-       --assert-integrity      <mode>    Turn DB constraints on/off:
-                                           true        : (default) Constraints will be generated for all associations if
-                                                         the assert-integrity-type is set to DB
-                                           false       : No constraints will be generated
-                                           individual  : Constraints will be generated for selected associations
-       --assert-integrity-type <type>  Specifies how the referential integrity checks should be performed:
-                                           RT : (default) No database constraint for an association
-                                               if not explicitly demanded via annotation
-                                           DB : Create database constraints for associations
-       --constraints-as-alter <boolean>  If set to 'true', the foreign key constraints will be rendered as
-                                         "ALTER TABLE ADD CONSTRAINT" statement rather than being part of the
-                                         "CREATE TABLE" statement
        --deprecated <list>  Comma separated list of deprecated options.
                             Valid values are:
                               noElementsExpansion
@@ -124,6 +120,7 @@ optionProcessor
                               renderVirtualElements
                               unmanagedUpInComponent
                               createLocalizedViews
+                              redirectInSubQueries
        --hana-flavor        Compile with backward compatibility for HANA CDS (incomplete)
        --parse-only         Stop compilation after parsing and write result to <stdout>
        --fallback-parser <type>  If the language cannot be deduced by the file's extensions, use this
@@ -168,6 +165,10 @@ optionProcessor.command('H, toHana')
   .option('-u, --user <user>')
   .option('-s, --src')
   .option('-c, --csn')
+  .option('    --integrity-not-validated')
+  .option('    --integrity-not-enforced')
+  .option('    --assert-integrity <mode>', ['true', 'false', 'individual'])
+  .option('    --assert-integrity-type <type>', ['RT', 'DB'], { ignoreCase: true })
   .help(`
   Usage: cdsc toHana [options] <files...>
 
@@ -191,6 +192,17 @@ optionProcessor.command('H, toHana')
    -u, --user <user>          Value for the "$user" variable
    -s, --src                  (default) Generate HANA CDS source files "<artifact>.hdbcds"
    -c, --csn                  Generate "hana_csn.json" with HANA-preprocessed model
+   --integrity-not-enforced   If this option is supplied, referential constraints are NOT ENFORCED.
+   --integrity-not-validated  If this option is supplied, referential constraints are NOT VALIDATED.
+   --assert-integrity <mode>  Turn DB constraints on/off:
+                                true        : (default) Constraints will be generated for all associations if
+                                              the assert-integrity-type is set to DB
+                                false       : No constraints will be generated
+                                individual  : Constraints will be generated for selected associations
+   --assert-integrity-type <type>   Specifies how the referential integrity checks should be performed:
+                                           RT : (default) No database constraint for an association
+                                               if not explicitly demanded via annotation
+                                           DB : Create database constraints for associations
 `);
 
 optionProcessor.command('O, toOdata')
@@ -206,6 +218,7 @@ optionProcessor.command('O, toOdata')
   .option('-c, --csn')
   .option('-f, --odata-format <format>', ['flat', 'structured'])
   .option('-n, --names <style>', ['plain', 'quoted', 'hdbcds'])
+  .option('-s, --service-names <list>')
   .help(`
   Usage: cdsc toOdata [options] <files...>
 
@@ -236,6 +249,8 @@ optionProcessor.command('O, toOdata')
                                         but element names flattened with underscores
                               hdbcds  : Names as HANA CDS would generate them from the same CDS
                                         source (like "quoted", but using element names with dots)
+    -s, --service-names <list>    List of comma-separated service names to be rendered
+                                  (default) empty, all services are rendered 
 `);
 
 optionProcessor.command('C, toCdl')
@@ -259,6 +274,11 @@ optionProcessor.command('Q, toSql')
   .option('-l, --locale <locale>')
   .option('-s, --src <style>', ['sql', 'hdi'])
   .option('-c, --csn')
+  .option('    --integrity-not-validated')
+  .option('    --integrity-not-enforced')
+  .option('    --assert-integrity <mode>', ['true', 'false', 'individual'])
+  .option('    --assert-integrity-type <type>', ['RT', 'DB'], { ignoreCase: true })
+  .option('    --constraints-in-create-table')
   .help(`
   Usage: cdsc toSql [options] <files...>
 
@@ -291,6 +311,20 @@ optionProcessor.command('Q, toSql')
                                          the HDI plugin name. Can only be used in combination with
                                          "hana" dialect.
    -c, --csn                  Generate "sql_csn.json" with SQL-preprocessed model
+   --integrity-not-enforced   If this option is supplied, referential constraints are NOT ENFORCED.
+   --integrity-not-validated  If this option is supplied, referential constraints are NOT VALIDATED.
+   --assert-integrity <mode>  Turn DB constraints on/off:
+                                true        : (default) Constraints will be generated for all associations if
+                                              the assert-integrity-type is set to DB
+                                false       : No constraints will be generated
+                                individual  : Constraints will be generated for selected associations
+   --assert-integrity-type <type>   Specifies how the referential integrity checks should be performed:
+                                      RT : (default) No database constraint for an association
+                                           if not explicitly demanded via annotation
+                                      DB : Create database constraints for associations
+   --constraints-in-create-table    If set, the foreign key constraints will be rendered as
+                                    part of the "CREATE TABLE" statements rather than as separate
+                                    "ALTER TABLE ADD CONSTRAINT" statements
 `);
 
 optionProcessor.command('toRename')
@@ -321,13 +355,14 @@ optionProcessor.command('manageConstraints')
   .option('    --drop')
   .option('    --alter')
   .option('    --violations')
+  .option('    --integrity-not-validated')
+  .option('    --integrity-not-enforced')
   .help(`
   Usage: cdsc manageConstraints [options] <files...>
 
   (internal, subject to change): Generate SQL DDL ALTER TABLE statements to add / modify
-  referential constraints on an existing model.
-  Combine with options "--integrity-not-enforced" and "--integrity-not-validated"
-  to switch off foreign key constraint enforcement / validation.
+  referential constraints on an existing model. This can also be used to
+  generate SELECT statements which list all referential integrity violations.
 
   Options
    -h, --help             Display this help text
@@ -347,6 +382,8 @@ optionProcessor.command('manageConstraints')
       --alter             Generate "ALTER TABLE <table> ALTER CONSTRAINT <constraint>" statements
       --violations        Generates SELECT statements which can be used to list
                           referential integrity violations on the existing data
+      --integrity-not-enforced   If this option is supplied, referential constraints are NOT ENFORCED.
+      --integrity-not-validated  If this option is supplied, referential constraints are NOT VALIDATED.
 `);
 
 optionProcessor.command('toCsn')