docs: public void renameValue(String oldValue, String newValue, Locale locale) throws CmsIllegalArgumentException {
  
          CmsXmlHtmlValue oldXmlHtmlValue = (CmsXmlHtmlValue)getValue(oldValue, locale);
          if (oldXmlHtmlValue == null) {
              throw new CmsIllegalArgumentException(
                  Messages.get().container(Messages.ERR_XML_PAGE_NO_ELEM_FOR_LANG_2, oldValue, locale));
          }
  
          if (hasValue(newValue, locale)) {
              throw new CmsIllegalArgumentException(
                  Messages.get().container(Messages.ERR_XML_PAGE_LANG_ELEM_EXISTS_2, newValue, locale));
          }
          if (newValue.indexOf('[') >= 0) {
              throw new CmsIllegalArgumentException(
                  Messages.get().container(Messages.ERR_XML_PAGE_CONTAINS_INDEX_1, newValue));
          }
  
          // get the element
          Element element = oldXmlHtmlValue.getElement();
  
          // update value of the element attribute 'NAME'
          element.addAttribute(ATTRIBUTE_NAME, newValue);
  
          // re-initialize the document to update the bookmarks
          initDocument(m_document, m_encoding, getContentDefinition());
      }