diff mbox series

[4/7] lldpd: note about capabilities

Message ID 20240402130221.58706-4-newtwen+github@gmail.com
State New
Headers show
Series [1/7] lldpd: fixed interface(s) parsing | expand

Commit Message

Paul Donald April 2, 2024, 1:02 p.m. UTC
only available from >= 1.0.15

Signed-off-by: Paul Donald <newtwen+github@gmail.com>
---
 package/network/services/lldpd/files/lldpd.init | 1 +
 1 file changed, 1 insertion(+)

Comments

Jo-Philipp Wich April 2, 2024, 11:15 p.m. UTC | #1
Hi,

What's the purpose of this isolated comment? Either we're shipping version >= 
v1.0.15 so this code is guaranteed to work or we don't, in which case the code 
should not be there. We're not putting such comments next to all other option 
handling code either.

~ Jo
Paul D April 3, 2024, 11:59 a.m. UTC | #2
On 2024-04-03 01:15, Jo-Philipp Wich wrote:
> Hi,
> 
> What's the purpose of this isolated comment? Either we're shipping version >= v1.0.15 so this code is guaranteed to work or we don't, in which case the code should not be there. We're not putting such comments next to all other option handling code either.
Evidence that people think in one direction only.

> ~ Jo

"What's the purpose of having code review at all?"

Comments tell us things. They are *extremely* helpful for those cherry-picking: it is safe to drop such a commit into any older build which has at least that lldpd version.

Hope you can see the value in that.
diff mbox series

Patch

diff --git a/package/network/services/lldpd/files/lldpd.init b/package/network/services/lldpd/files/lldpd.init
index 0334156fee..284c37c2ef 100644
--- a/package/network/services/lldpd/files/lldpd.init
+++ b/package/network/services/lldpd/files/lldpd.init
@@ -120,6 +120,7 @@  write_lldpd_conf()
 	local lldp_mgmt_ip
 	config_get lldp_mgmt_ip 'config' 'lldp_mgmt_ip'
 
+	# Configurable capabilities in lldpd >= v1.0.15
 	local lldp_syscapabilities
 	config_get lldp_syscapabilities 'config' 'lldp_syscapabilities'