diff --git a/README.md b/README.md index 63a7f44..21ed96f 100644 --- a/README.md +++ b/README.md @@ -113,7 +113,9 @@ identifier; this is as per the [spec](https://docs.oasis-open.org/mqtt/mqtt/v3.1 not received, disconnecting` errors). * When QOS1+ subscriptions have been created previously and you connect with `CleanSession` set to false it is possible that the broker will deliver retained messages before `Subscribe` can be called. To process these messages either -configure a handler with `AddRoute` or set a `DefaultPublishHandler`. +configure a handler with `AddRoute` or set a `DefaultPublishHandler`. If there is no handler (or `DefaultPublishHandler`) +then inbound messages will not be acknowledged. Adding a handler (even if it's `opts.SetDefaultPublishHandler(func(mqtt.Client, mqtt.Message) {})`) +is highly recommended to avoid inadvertently hitting inflight message limits. * Loss of network connectivity may not be detected immediately. If this is an issue then consider setting `ClientOptions.KeepAlive` (sends regular messages to check the link is active). * Reusing a `Client` is not completely safe. After calling `Disconnect` please create a new Client (`NewClient()`) rather @@ -193,4 +195,4 @@ Discussion of the Paho clients takes place on the [Eclipse paho-dev mailing list General questions about the MQTT protocol are discussed in the [MQTT Google Group](https://groups.google.com/forum/?hl=en-US&fromgroups#!forum/mqtt). -There is much more information available via the [MQTT community site](http://mqtt.org). \ No newline at end of file +There is much more information available via the [MQTT community site](http://mqtt.org).