Document listen inside inet_listener

[allan2]

This replaces inet_listener_address with inet_listener_listen.

I kept the setting_types.IPADDR value type as-is.

Resolves #1347

[cmouse]

its not inet_listener_listen. its listen inside inet_listener.

[allan2]

PR title updated. The fix should be the same, no?

[seyfidin]

If listen is configured within an inet_listener block, default_login_user, default_internal_user, and default_internal_group must be redefined inside the listener, as global values are not inherited.

[cmouse]

If listen is configured within an inet_listener block, default_login_user, default_internal_user, and default_internal_group must be redefined inside the listener, as global values are not inherited.

No, this is definately not required. Also all settings are global so there is no inheriting going on.

[cmouse]

PR title updated. The fix should be the same, no?

the problem with this is that there is no setting called inet_listener_listen.

:FILTER settings_filter_name="inet_listener/imap" AND settings_filter_name="service/imap-login"
listen/127.0.0.2=yes # stop list

is how this setting is applied. I'm not sure yet what the correct way to document this is but we'll take a look.

[sirainen]

I added some explanation & link now in #1350