doc updates

org.springframework.integration/src/main/java/org/springframework/integration/channel/PollableChannel.java

@@ -20,6 +20,8 @@ import org.springframework.integration.core.Message;
 import org.springframework.integration.core.MessageChannel;
 
 /**
+ * Interface for Message Channels from which Messages may be actively received through polling.
+ * 
  * @author Mark Fisher
  */
 public interface PollableChannel extends MessageChannel {
@@ -27,8 +29,7 @@ public interface PollableChannel extends MessageChannel {
 	/**
 	 * Receive a message from this channel, blocking indefinitely if necessary.
 	 * 
-	 * @return the next available {@link Message} or <code>null</code> if
-	 * interrupted
+	 * @return the next available {@link Message} or <code>null</code> if interrupted
 	 */
 	Message<?> receive();
 

org.springframework.integration/src/main/java/org/springframework/integration/channel/SubscribableChannel.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2008 the original author or authors.
+ * Copyright 2002-2010 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,6 +21,8 @@ import org.springframework.integration.message.MessageHandler;
 
 /**
  * Interface for any MessageChannel implementation that accepts subscribers.
+ * The subscribers must implement the {@link MessageHandler} interface and
+ * will be invoked when a Message is available.
  * 
  * @author Mark Fisher
  */