From 74cb2e054f87458d2725ec07539bff171e3da442 Mon Sep 17 00:00:00 2001 From: Badlop Date: Thu, 11 Jan 2024 13:23:45 +0100 Subject: [PATCH] Rephrase sentences to avoid using "allow to + verb" --- src/ejabberd_options_doc.erl | 10 +++++----- src/mod_block_strangers.erl | 2 +- src/mod_muc.erl | 2 +- src/mod_muc_log.erl | 2 +- src/mod_pubsub.erl | 6 +++--- src/mod_register.erl | 2 +- src/mod_sip.erl | 2 +- 7 files changed, 13 insertions(+), 13 deletions(-) diff --git a/src/ejabberd_options_doc.erl b/src/ejabberd_options_doc.erl index 55fe3c983..c93a771fe 100644 --- a/src/ejabberd_options_doc.erl +++ b/src/ejabberd_options_doc.erl @@ -381,7 +381,7 @@ doc() -> "authenticate using: the old Jabber Non-SASL (XEP-0078), " "SASL PLAIN, SASL DIGEST-MD5, and SASL SCRAM-SHA-1/256/512(-PLUS). "), "", ?T("* 'scram': The password is not stored, only some information " - "that allows to verify the hash provided by the client. " + "required to verify the hash provided by the client. " "It is impossible to obtain the original plain password " "from the stored information; for this reason, when this " "value is configured it cannot be changed to plain anymore. " @@ -702,7 +702,7 @@ doc() -> #{value => ?T("FieldName"), desc => ?T("By default, the JID is defined in the '\"jid\"' JWT field. " - "This option allows to specify other JWT field name " + "In this option you can specify other JWT field name " "where the JID is defined.")}}, {jwt_key, #{value => ?T("FilePath"), @@ -903,8 +903,8 @@ doc() -> {?T("Whether to use 'new' SQL schema. All schemas are located " "at . " "There are two schemas available. The default legacy schema " - "allows to store one XMPP domain into one ejabberd database. " - "The 'new' schema allows to handle several XMPP domains in a " + "stores one XMPP domain into one ejabberd database. " + "The 'new' schema can handle several XMPP domains in a " "single ejabberd database. Using this 'new' schema is best when " "serving several XMPP domains and/or changing domains from " "time to time. This avoid need to manage several databases and " @@ -1417,7 +1417,7 @@ doc() -> "contains the header 'X-Forwarded-For'. You can specify " "'all' to allow all proxies, or specify a list of IPs, " "possibly with masks. The default value is an empty list. " - "This allows, if enabled, to be able to know the real IP " + "Using this option you can know the real IP " "of the request, for admin purpose, or security configuration " "(for example using 'mod_fail2ban'). IMPORTANT: The proxy MUST " "be configured to set the 'X-Forwarded-For' header if you " diff --git a/src/mod_block_strangers.erl b/src/mod_block_strangers.erl index 7859e0291..baeef36af 100644 --- a/src/mod_block_strangers.erl +++ b/src/mod_block_strangers.erl @@ -256,7 +256,7 @@ mod_options(_) -> mod_doc() -> #{desc => - ?T("This module allows to block/log messages coming from an " + ?T("This module blocks and logs any messages coming from an " "unknown entity. If a writing entity is not in your roster, " "you can let this module drop and/or log the message. " "By default you'll just not receive message from that entity. " diff --git a/src/mod_muc.erl b/src/mod_muc.erl index 0ea78870b..b6f9fc3ff 100644 --- a/src/mod_muc.erl +++ b/src/mod_muc.erl @@ -1679,7 +1679,7 @@ mod_doc() -> #{value => ?T("Options"), note => "improved in 22.05", desc => - ?T("This option allows to define the desired " + ?T("Define the " "default room options. Note that the creator of a room " "can modify the options of his room at any time using an " "XMPP client with MUC capability. The 'Options' are:")}, diff --git a/src/mod_muc_log.erl b/src/mod_muc_log.erl index d5a8d461f..d9eef97d2 100644 --- a/src/mod_muc_log.erl +++ b/src/mod_muc_log.erl @@ -1043,7 +1043,7 @@ mod_doc() -> {dirname, #{value => "room_jid | room_name", desc => - ?T("Allows to configure the name of the room directory. " + ?T("Configure the name of the room directory. " "If set to 'room_jid', the room directory name will " "be the full room JID. Otherwise, the room directory " "name will be only the room name, not including the " diff --git a/src/mod_pubsub.erl b/src/mod_pubsub.erl index 7cc1d0170..87a73c9be 100644 --- a/src/mod_pubsub.erl +++ b/src/mod_pubsub.erl @@ -4414,7 +4414,7 @@ mod_doc() -> "items. Value is 'true' or 'false'. If not defined, " "pubsub does not cache last items. On systems with not" " so many nodes, caching last items speeds up pubsub " - "and allows to raise user connection rate. The cost " + "and allows you to raise the user connection rate. The cost " "is memory usage, as every item is stored in memory.")}}, {max_item_expire_node, #{value => "timeout() | infinity", @@ -4469,7 +4469,7 @@ mod_doc() -> {pep_mapping, #{value => "List of Key:Value", desc => - ?T("This allows to define a list of key-value to choose " + ?T("In this option you can provide a list of key-value to choose " "defined node plugins on given PEP namespace. " "The following example will use 'node_tune' instead of " "'node_pep' for every PEP node with the tune namespace:"), @@ -4494,7 +4494,7 @@ mod_doc() -> "follows standard XEP-0060 implementation."), ?T("- 'pep' plugin adds extension to handle Personal " "Eventing Protocol (XEP-0163) to the PubSub engine. " - "Adding pep allows to handle PEP automatically.")]}}, + "When enabled, PEP is handled automatically.")]}}, {vcard, #{value => ?T("vCard"), desc => diff --git a/src/mod_register.erl b/src/mod_register.erl index c7edb66df..29624508a 100644 --- a/src/mod_register.erl +++ b/src/mod_register.erl @@ -652,7 +652,7 @@ mod_doc() -> {access_from, #{value => ?T("AccessName"), desc => - ?T("By default, 'ejabberd' doesn't allow to register new accounts " + ?T("By default, 'ejabberd' doesn't allow the client to register new accounts " "from s2s or existing c2s sessions. You can change it by defining " "access rule in this option. Use with care: allowing registration " "from s2s leads to uncontrolled massive accounts creation by rogue users.")}}, diff --git a/src/mod_sip.erl b/src/mod_sip.erl index 13fcfa6c4..1e649579a 100644 --- a/src/mod_sip.erl +++ b/src/mod_sip.erl @@ -390,7 +390,7 @@ mod_doc() -> #{value => "true | false", desc => ?T("Always insert \"Record-Route\" header into " - "SIP messages. This approach allows to bypass " + "SIP messages. With this approach it is possible to bypass " "NATs/firewalls a bit more easily. " "The default value is 'true'.")}}, {flow_timeout_tcp,