From ac602b5c0d0be8ecd78f3a1a8638f53d10be2c82 Mon Sep 17 00:00:00 2001 From: Ben <43026681+bwp91@users.noreply.github.com> Date: Wed, 10 Apr 2024 21:08:08 +0100 Subject: [PATCH] update doc links in README --- CHANGELOG.md | 1 + README.md | 26 +++++++++++++------------- docs/classes/CiaoService.html | 22 +++++++++++----------- docs/classes/Responder.html | 6 +++--- docs/enums/Protocol.html | 4 ++-- docs/enums/ServiceEvent.html | 6 +++--- docs/enums/ServiceType.html | 4 ++-- docs/functions/getResponder.html | 2 +- docs/index.html | 26 +++++++++++++------------- docs/interfaces/MDNSServerOptions.html | 6 +++--- docs/interfaces/ServiceOptions.html | 22 +++++++++++----------- docs/types/ResponderOptions.html | 2 +- docs/types/ServiceTxt.html | 2 +- docs/variables/default.html | 2 +- 14 files changed, 66 insertions(+), 65 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 10c38d3..0fb4613 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,3 +14,4 @@ All notable changes to `@homebridge/ciao` will be documented in this file. This - updated eslint rule - update to match renamed `latest` branch - regenerate docs +- update doc links in README diff --git a/README.md b/README.md index c4a0ff1..7426e3e 100644 --- a/README.md +++ b/README.md @@ -84,34 +84,34 @@ service.destroy(); ## Documentation -The full documentation can be found [here](https://developers.homebridge.io/ciao/globals.html). +The full documentation can be found [here](https://developers.homebridge.io/ciao/modules.html). ### API overview This section links to the most important aspects of the documentation as used in the example above. -First of all the [getResponder](https://developers.homebridge.io/ciao/globals.html#getresponder) function -should be used to get a reference to a [Responder](https://developers.homebridge.io/ciao/classes/responder.html) object. -The function takes some optional [options](https://developers.homebridge.io/ciao/interfaces/mdnsserveroptions.html) +First of all the [getResponder](https://developers.homebridge.io/ciao/functions/getResponder.html) function +should be used to get a reference to a [Responder](https://developers.homebridge.io/ciao/classes/Responder.html) object. +The function takes some optional [options](https://developers.homebridge.io/ciao/interfaces/MDNSServerOptions.html) to configure the underlying mdns server. -The [createService](https://developers.homebridge.io/ciao/classes/responder.html#createservice) method of the `Responder` -object can now be used to create a new [CiaoService](https://developers.homebridge.io/ciao/classes/ciaoservice.html) -supplying the desired [configuration](https://developers.homebridge.io/ciao/interfaces/serviceoptions.html) +The [createService](https://developers.homebridge.io/ciao/classes/Responder.html#createService) method of the `Responder` +object can now be used to create a new [CiaoService](https://developers.homebridge.io/ciao/classes/CiaoService.html) +supplying the desired [configuration](https://developers.homebridge.io/ciao/interfaces/ServiceOptions.html) as the first parameter. You might have a look at the -_[restrictedAddresses](https://developers.homebridge.io/ciao/interfaces/serviceoptions.html#restrictedAddresses)_ -(and _[disableIpv6](https://developers.homebridge.io/ciao/interfaces/serviceoptions.html#disableIpv6)_) configuration +_[restrictedAddresses](https://developers.homebridge.io/ciao/interfaces/ServiceOptions.html#restrictedAddresses)_ +(and _[disabledIpv6](https://developers.homebridge.io/ciao/interfaces/ServiceOptions.html#disabledIpv6)_) configuration if you don't want to advertise on all available addresses/network interfaces. -The [advertise](https://developers.homebridge.io/ciao/classes/ciaoservice.html#advertise) method can now be called +The [advertise](https://developers.homebridge.io/ciao/classes/CiaoService.html#advertise) method can now be called on the `service` object to start advertising the service on the network. -An application should ideally listen to the [NAME_CHANGE](https://developers.homebridge.io/ciao/enums/serviceevent.html#name_changed) +An application should ideally listen to the [NAME_CHANGED](https://developers.homebridge.io/ciao/enums/ServiceEvent.html#NAME_CHANGED) event, in oder to persist any changes happening to the service name resulting of the conflict resolution algorithm. -The method [updateTxt](https://developers.homebridge.io/ciao/classes/ciaoservice.html#updatetxt) can be used +The method [updateTxt](https://developers.homebridge.io/ciao/classes/CiaoService.html#updateTxt) can be used to update the contest of the txt exposed by the service. Any application SHOULD hook up a listener on events like SIGTERM or SIGINT and call the -[shutdown](https://developers.homebridge.io/ciao/classes/responder.html#shutdown) method of the responder object. +[shutdown](https://developers.homebridge.io/ciao/classes/Responder.html#shutdown) method of the responder object. This will ensure, that goodbye packets are sent out on all connected network interfaces and all hosts on the network get instantly notified of the shutdown. Otherwise, stale data will remain in the caches of surrounding mdns browsers. diff --git a/docs/classes/CiaoService.html b/docs/classes/CiaoService.html index 0d6170b..f4cdc04 100644 --- a/docs/classes/CiaoService.html +++ b/docs/classes/CiaoService.html @@ -7,7 +7,7 @@
A CiaoService class is always bound to a Responder and can be created using the Responder.createService method in the Responder class. Once the instance is created, advertise can be called to announce the service on the network.
-This method must be called if you want to free the memory used by this service. The service instance is not usable anymore after this call.
If the service is still announced, the service will first be removed from the network by calling end.
-Sets or updates the txt of the service.
The updated txt record.
If set to true no announcement is sent for the updated record.
-
This method must be called if you want to free the memory used by this service. +