code: @Nonnull
    public static ESuccess readList (@Nonnull @WillClose final InputStream aIS,
                                     @Nonnull final Collection <String> aTargetList)
    {
      ValueEnforcer.notNull (aIS, "InputStream");
      ValueEnforcer.notNull (aTargetList, "TargetList");
  
      try
      {
        // open file
        final IMicroDocument aDoc = MicroReader.readMicroXML (aIS);
        if (aDoc != null)
        {
          readList (aDoc.getDocumentElement (), aTargetList);
          return ESuccess.SUCCESS;
        }
      }
      catch (final Exception ex)
      {
        if (LOGGER.isWarnEnabled ())
          LOGGER.warn ("Failed to read list resource '" + aIS + "'", ex);
      }
      finally
      {
        StreamHelper.close (aIS);
      }
  
      return ESuccess.FAILURE;
    }
docs: Read a predefined XML file that contains list items.
  
  @param aIS
  The input stream to read from. May not be <code>null</code>.
  Automatically closed no matter whether reading succeeded or not.
  @param aTargetList
  The target collection to be filled. May not be <code>null</code>.
  @return {@link ESuccess#SUCCESS} if reading succeeded,
  {@link ESuccess#FAILURE} if the input stream is no valid XML or any
  other error occurred.