code: private boolean comment( FormattableContainer container ) {
          char ch = read();
          switch( ch ) {
  //            case '/': // line comments will be skip
  //                reader.skipLine();
  //                return true;
              case '*': // block comments
                  StringBuilder builder = new StringBuilder();
                  builder.append( "/*" );
                  boolean wasAsterix = false;
                  for( ;; ) {
                      ch = read();
                      builder.append( ch );
                      switch( ch ) {
                          case '*':
                              wasAsterix = true;
                              break;
                          case '/':
                              if( wasAsterix ) {
                                  if( container != null ) {
                                      container.add( new Comment( trim( builder ) ) );
                                  }
                                  return true;
                              }
                              //$FALL-THROUGH$
                          default:
                              wasAsterix = false;
                      }
                  }
              default:
                  back( ch );
                  return false;
          }
      }
docs: Parse comments
  
  @param container optional container for the parsed comments
  
  @return return true, if a comment was parsed, false if the slash must be parse anywhere else