Link to relevant page (if any): https://prosody.im/doc/ports
What's wrong and how can it be improved?
I find no mention of the options use_ipv6 and use_ipv4, which would probably make sense to have documented on this page. Should probably word it to recommend using those settings instead of changing `interfaces` to e.g. disable IPv4 in an IPv6-only environment or vice versa.
Thanks for the patch.
When I wrote this, I was intending to rewrite the whole section to make it clearer when the `use_ipv` settings are more appropriate to use than `interfaces`, as it can currently be read to imply that `interfaces` could be used to disable IPv6 or IPv4 entirely, but it would be incomplete.
Changes
tags Patch
eerielili
on
Re Zash,
Thanks for the feedback. I've modified the patch, the use_ipv* are put first and marked as recommended.
Link to relevant page (if any): https://prosody.im/doc/ports What's wrong and how can it be improved? I find no mention of the options use_ipv6 and use_ipv4, which would probably make sense to have documented on this page. Should probably word it to recommend using those settings instead of changing `interfaces` to e.g. disable IPv4 in an IPv6-only environment or vice versa.
I've added this blurb at the end of the "Default interfaces" section: https://git.les-miquelots.net/prosody-patches/tree/doc_ports-document-useipv4-useipv6-option.patch
Thanks for the patch. When I wrote this, I was intending to rewrite the whole section to make it clearer when the `use_ipv` settings are more appropriate to use than `interfaces`, as it can currently be read to imply that `interfaces` could be used to disable IPv6 or IPv4 entirely, but it would be incomplete.
ChangesRe Zash, Thanks for the feedback. I've modified the patch, the use_ipv* are put first and marked as recommended.