EDIT

            $elements_render_array = compose_cdm_descriptionElements($node->descriptionElements, $node->feature, $taxon_uuid);

                  //TODO it woud be better if we could use compose_cdm_descriptionElements() directly instead of the below stuff

                      // FIXME use compose_cdm_descriptionElementTextData()

        $text_data_render_array = compose_cdm_descriptionElementTextData($text_data_element, $asListElement, $text_data_element->feature->uuid);

        $distribution_element_render_array = compose_cdm_descriptionElement_Distribution($distributionElements);

  function compose_cdm_descriptionElementTextData($element, $asListElement, $feature_uuid) {

   * Returns HTML for the texts in a description $elements.

   *

   * Joins the texts in $elements and encloses with a HTML tag.

   * @param  $elements

  function compose_cdm_feature_block_elements($elements, $feature, $glue = '', $sort = FALSE, $enclosing_tag = 'ul') {

  /**

   * Composes block of common names for the given DescriptionElements $elements which must be of the feature CommonName

   *

   * @parameter $elements

   *  an array of CDM DescriptionElements either of type CommonName or TextData

   * @parameter $feature

   *  the common feature of all $elements, must be CommonName

   *

   * @return

   *   A drupal render array

   *

   * @ingroup compose

   */

  function compose_cdm_common_names($elements, $feature, $weight = FALSE) {

    $common_name_out = '';

    $common_name_feature_elements = array();

    $textData_commonNames = array();

    $footnote_key_suggestion = 'common-names-feature-block';

    $feature_block_settings = get_feature_block_settings(UUID_COMMON_NAME);

    $element_tag_name = cdm_feature_block_element_tag_name($feature_block_settings);

    if (is_array($elements)) {

      foreach ($elements as $element) {

        if ($element->class == 'CommonTaxonName') {

          // common name without a language or area, should not happen but is possible

          $language_area_key = '';

          if (isset($element->language->representation_L10n)) {

            $language_area_key .= '<b>' . $element->language->representation_L10n . '</b>';

          }

          if(isset($element->area->titleCache) && strlen($element->area->titleCache) > 0){

            $language_area_key .= ($language_area_key ? ' '  : '') . '(' . $element->area->titleCache . ')';

          }

          if(isset($common_names[$language_area_key][$element->name])) {

            // same name already exists for language and areae combination, se we merge the description elements

            cdm_merge_description_elements($common_names[$language_area_key][$element->name], $element);

          } else{

            // otherwise add as new entry

            $common_names[$language_area_key][$element->name] = $element;

          }

        }

        elseif ($element->class == 'TextData') {

          $textData_commonNames[] = $element;

        }

      }

    }

    // Handling common names.

    if (isset($common_names) && count($common_names) > 0) {

      // Sorting the array based on the key (language, + area if set).

      // Comment @WA there are common names without a language, so this sorting

      // can give strange results.

      ksort($common_names);

      // loop over set of elements per language area

      foreach ($common_names as $language_area_key => $elements) {

        ksort($elements); // sort names alphabetically

        $per_language_area_out = array();

        // loop over set of individual elements

        foreach ($elements as $element) {

          if ($element->name) {

            $annotations_and_sources = handle_annotations_and_sources($element, $feature_block_settings, $element->name, $footnote_key_suggestion);

            $source_references_markup = '';

            if(!empty($annotations_and_sources['source_references'])){

              $source_references_markup = ' ' . join(', ', $annotations_and_sources['source_references']);

            }

            $per_language_area_out[] = '<' . $element_tag_name. ' class="' . html_class_attribute_ref($element) . '">'

              . $element->name . $source_references_markup . $annotations_and_sources['foot_note_keys'] . '</' . $element_tag_name. '>';

          }

        } // End of loop over set of individual elements

        $common_name_feature_elements[] = ($language_area_key ? $language_area_key . ': ' : '' ) . join(', ', $per_language_area_out);

      } // End of loop over set of elements per language area

      $common_name_feature_elements_render_array = compose_cdm_feature_block_elements(

        $common_name_feature_elements,

        $feature,

        '; ',

        FALSE,

        $feature_block_settings['as_list']

      );

      $common_name_out .= $common_name_feature_elements_render_array['#markup'];

    }

    // Handling commons names as text data.

    $text_data_out = array();

    foreach ($textData_commonNames as $text_data_element) {

      /* footnotes are not handled correctly in compose_cdm_descriptionElementTextData,

         need to set 'common-names-feature-block' as $footnote_key_suggestion */

      RenderHints::setFootnoteListKey($footnote_key_suggestion);

      $text_data_render_array = compose_cdm_descriptionElementTextData($text_data_element, TRUE, $text_data_element->feature->uuid);

      $text_data_out[] = drupal_render($text_data_render_array);

    }

    $common_name_out_text_data = compose_cdm_feature_block_elements(

      $text_data_out,

      $feature

    );

    $footnotes = theme('cdm_footnotes', array('footnoteListKey' => 'BIBLIOGRAPHY-' . $footnote_key_suggestion));

    $footnotes .= theme('cdm_footnotes', array('footnoteListKey' => $footnote_key_suggestion)); // FIXME is this needed at all?

    $footnotes .= theme('cdm_annotation_footnotes', array('footnoteListKey' => $footnote_key_suggestion));

    return  markup_to_render_array(

      '<div class="common_names_as_common_names">' . $common_name_out . '</div>'

      .'<div class="common_names_as_text_data">' . $common_name_out_text_data['#markup'] . '</div>'

      .$footnotes,

      $weight

    );

  }

  function compose_cdm_descriptionElements($descriptionElements, $feature) {

              $text_data_render_array = compose_cdm_descriptionElementTextData($descriptionElement, $asListElement, $descriptionElement->feature->uuid);

  function compose_cdm_descriptionElement_Distribution($descriptionElements, $enclosingTag = "span"){

   * this function should produce markup as the compose_cdm_descriptionElement_Distribution()

   * @see compose_cdm_descriptionElement_Distribution()