// brief.js
// OK 09 2023
(function () {
  /*global adventurejs A*/
  "use strict";

  /**
   * @augments {adventurejs.Verb}
   * @class brief
   * @ajsnode game.dictionary.verbs.brief
   * @ajsconstruct MyGame.createVerb({ "name": "brief", [...] });
   * @ajsconstructedby adventurejs.Dictionary#createVerb
   * @hideconstructor
   * @ajsinstanceof Verb
   * @ajsnavheading UtilityVerbs
   * @summary Verb meaning show brief room descriptions.
   * @tutorial Scripting_VerbSubscriptions
   * @tutorial Verbs_VerbAnatomy
   * @tutorial Verbs_VerbProcess
   * @tutorial Verbs_ModifyVerbs
   * @tutorial Verbs_WriteVerbs
   * @classdesc
   * <pre class="display border outline">
   * <span class="input">&gt; brief</span>
   * Ok, I'll show shorter room descriptions.
   * </pre>
   * <p>
   * <strong>brief</strong> displays short {@link adventurejs.Room|Room}
   * descriptions if the author has provided them.
   * </p>
   */
  A.Preverbs.brief = {
    name: "brief",
    synonyms: ["brief"],

    /**
     * @ajsverbstructures
     * @memberof brief
     */
    accepts_structures: ["verb"],

    do: function () {
      var input = this.game.getInput();
      if (this.game.settings.verbosity > this.game.settings.min_verbosity) {
        this.game.settings.verbosity -= 1;
      }
      var msg = "Ok, I'll try to show shorter room descriptions. ";
      if (msg) this.game.print(msg, input.output_class);
      return true;
    },
  };
})();