code: protected boolean shouldAddToIndexMap(Element element) {
          if (utils.isHidden(element)) {
              return false;
          }
  
          if (utils.isPackage(element))
              // Do not add to index map if -nodeprecated option is set and the
              // package is marked as deprecated.
              return !(noDeprecated && configuration.utils.isDeprecated(element));
          else
              // Do not add to index map if -nodeprecated option is set and if the
              // element is marked as deprecated or the containing package is marked as
              // deprecated.
              return !(noDeprecated &&
                      (configuration.utils.isDeprecated(element) ||
                      configuration.utils.isDeprecated(utils.containingPackage(element))));
      }
docs: Should this element be added to the index map?