/**
* Interface for publishing YANG-modeled notifications.
+ *
* <p>
* Users of this interface can publish any YANG-modeled notification which will
* be delivered to all subscribed listeners.
+ *
* <p>
- * Prefered way of publishing of notifications is done by invoking {@link #publish(Object)}.
+ * Preferred way of publishing of notifications is done by invoking {@link #publish(Object)}.
*
* <p>You may consider using {@link #publish(Object, ExecutorService)} if and only if
* your use-case requires customized execution policy or run-to-completion
* The metadata required to deliver a notification to the correct listeners is
* extracted from the published notification.
*
- *
+ * <p>
* FIXME: Consider clarification of execution/delivery policy, how it will be
* affected by Actor model and cluster-wide notifications.
*
- * @param <N>
- * the type of notifications
+ * @param <N> the type of notifications
*/
+@Deprecated
public interface NotificationPublishService<N> {
/**
* Publishes a notification and notifies subscribed listeners. All listener
* notifications are done via a default executor.
+ *
* <p>
* <b>Note:</b> This call will block when the default executor is saturated
* and the notification queue for this executor is full.
/**
* Publishes a notification and notifies subscribed listeners. All listener
* notifications are done via the provided executor.
+ *
* <p>
- * <b>Note:</b> Use only if ineccessary. Consider using
+ * <b>Note:</b> Use only if necessary. Consider using
* {@link #publish(Object)} for most use-cases.
*
* <p>