docs: private void outputIndexEntry(final IndexTerm term, final XMLStreamWriter serializer) throws XMLStreamException {
  
          final List<IndexTermTarget> targets = term.getTargetList();
  
          boolean foundIndexTerm = false;
          boolean foundIndexsee = false;
  
          String indexSeeRefTerm = null;
  
          /*
           * Use the cloned List to find the index-see reference in the list. If
           * found use that target URI for the href value, otherwise return a
           * warning to the build. RFE 2987769 Eclipse index-see
           */
          final int termCloneNum = termCloneList.size();
  
          // Index-see and index-see-also terms should also generate links to its
          // target
          // Otherwise, the term won't be displayed in the index tab.
          if (!targets.isEmpty()) {
              for (final IndexTermTarget target : targets) {
                  final String targetUri = target.getTargetURI();
                  final String targetName = target.getTargetName();
                  if (targetUri == null) {
                      serializer.writeStartElement("topic");
                      serializer.writeAttribute("title", target.getTargetName());
                      serializer.writeEndElement(); // topic
                  } else if (targetName != null && targetName.trim().length() > 0) {
                      /*
                       * Check to see if the target Indexterm is a "see"
                       * reference.Added inIndexsee so we know that we are still
                       * processing contentfrom a referenced indexterm.
                       */
                      if (term.getTermPrefix() != null || inIndexsee) {
                          indexSeeRefTerm = term.getTermName();
                          inIndexsee = true;
                          foundIndexsee = true;
                          // Find the term with an href.
                          for (int j = 0; j < termCloneNum; j++) {
                              final IndexTerm termClone = termCloneList.get(j);
                              if (term.getTermName().equals(termClone.getTermName())) {
                                  foundIndexTerm = true;
                                  if (termClone.getTargetList().size() > 0) {
                                      serializer.writeStartElement("topic");
                                      final IndexTermTarget indexTermTarget = termClone.getTargetList().get(0);
                                      serializer.writeAttribute("href", replaceExtName(indexTermTarget.getTargetURI()));
                                      if (indexTermTarget.getTargetName() != null && !indexTermTarget.getTargetName().trim().isEmpty()) {
                                          serializer.writeAttribute("title", indexTermTarget.getTargetName());
                                      }
                                      serializer.writeEndElement(); // topic
                                  }
                                  /*
                                   * We found the term we are looking for, but it
                                   * does not have a target name (title). We need
                                   * to take a look at the subterms for the
                                   * redirect and
                                   */
                                  termCloneList = termClone.getSubTerms();
                                  break;
                              }
                          }// end for
                          // If there are no subterms, then we are done.
                          if (term.getSubTerms().size() == 0) {
                              inIndexsee = false;
                          }
                      } else {
                          serializer.writeStartElement("topic");
                          serializer.writeAttribute("href", replaceExtName(targetUri));
                          if (targetName.trim().length() > 0) {
                              serializer.writeAttribute("title", target.getTargetName());
                          }
                          serializer.writeEndElement(); // topic
                      }
                  }
              }//end for
              if (!foundIndexTerm && foundIndexsee && indexSeeRefTerm != null && !indexSeeRefTerm.equals("***")){
                  logger.warn(MessageUtils.getMessage("DOTJ050W", indexSeeRefTerm.trim()).toString());
              }
          }
  
      }