From 85d44b58e75782c3e3ee8f092a0debd7dc0c371f Mon Sep 17 00:00:00 2001 From: Anders Svensson Date: Sat, 24 Jan 2015 11:24:33 +0100 Subject: Improve language consistency in diameter(1) In particular, do away with unnecessary articles in the first sentence of item lists. --- lib/diameter/doc/src/diameter.xml | 62 ++++++++++++++++++++------------------- 1 file changed, 32 insertions(+), 30 deletions(-) (limited to 'lib/diameter/doc') diff --git a/lib/diameter/doc/src/diameter.xml b/lib/diameter/doc/src/diameter.xml index 538011b789..638c1c4c2b 100644 --- a/lib/diameter/doc/src/diameter.xml +++ b/lib/diameter/doc/src/diameter.xml @@ -111,7 +111,7 @@ Defined in &dict_data_types;.

application_alias() = term()

-A name identifying a Diameter application in +Name identifying a Diameter application in service configuration. Passed to &call; when sending requests defined by the application.

@@ -129,7 +129,7 @@ ExtraArgs = list()

-A module implementing the callback interface defined in &man_app;, +Module implementing the callback interface defined in &man_app;, along with any extra arguments to be appended to those documented. Note that extra arguments specific to an outgoing request can be @@ -156,7 +156,7 @@ Has one the following types.

{alias, &application_alias;}

-A unique identifier for the application in the scope of the +Unique identifier for the application in the scope of the service. Defaults to the value of the dictionary option if unspecified.

@@ -165,7 +165,7 @@ unspecified.

{dictionary, atom()}

-The name of an encode/decode module for the Diameter +Name of an encode/decode module for the Diameter messages defined by the application. These modules are generated from files whose format is documented in &man_dict;.

@@ -174,7 +174,7 @@ These modules are generated from files whose format is documented in {module, &application_module;}

-The callback module with which messages of the Diameter application are +Callback module in which messages of the Diameter application are handled. See &man_app; for the required interface and semantics.

 @@ -182,7 +182,7 @@ See &man_app; for the required interface and semantics.

{state, term()}

-The initial callback state. +Initial callback state. The prevailing state is passed to some &man_app; callbacks, which can then return a new state. @@ -192,7 +192,7 @@ Defaults to the value of the alias option if unspecified.

{call_mutates_state, true|false}

-Specifies whether or not the &app_pick_peer; +Whether or not the &app_pick_peer; application callback can modify the application state. Defaults to false if unspecified.

@@ -209,7 +209,7 @@ probably avoid it.

{answer_errors, callback|report|discard}

-Determines the manner in which incoming answer messages containing +Manner in which incoming answer messages containing decode errors are handled.

@@ -233,7 +233,7 @@ Defaults to discard if unspecified.

{request_errors, answer_3xxx|answer|callback}

-Determines the manner in which incoming requests are handled when an +Manner in which incoming requests are handled when an error other than 3007 (DIAMETER_APPLICATION_UNSUPPORTED, which cannot be associated with an application callback module), is detected.

@@ -293,7 +293,7 @@ Multiple options append to the argument list.

{filter, &peer_filter;}

-A filter to apply to the list of available peers before passing it to +Filter to apply to the list of available peers before passing it to the &app_pick_peer; callback for the application in question. Multiple options are equivalent a single all filter on the corresponding list of filters. @@ -311,7 +311,7 @@ Defaults to 5000.

detach

-Causes &call; to return ok as +Cause &call; to return ok as soon as the request in question has been encoded, instead of waiting for and returning the result from a subsequent &app_handle_answer; or @@ -427,7 +427,7 @@ configuration passed to &start_service; or &add_transport;.

peer_filter() = term()

-A filter passed to &call; in order to select candidate peers for a +Filter passed to &call; in order to select candidate peers for a &app_pick_peer; callback. Has one of the following types.

@@ -1032,7 +1032,7 @@ case the corresponding callbacks are applied until either all return {capx_timeout, &dict_Unsigned32;}

-The number of milliseconds after which a transport process having an +Number of milliseconds after which a transport process having an established transport connection will be terminated if the expected capabilities exchange message (CER or CEA) is not received from the peer. For a connecting transport, the timing of connection attempts is @@ -1079,7 +1079,7 @@ transport.

-A callback invoked prior to terminating the transport process of a +Callback invoked prior to terminating the transport process of a transport connection having watchdog state OKAY. Applied to application|service|transport and the &transport_ref; and &app_peer; in question: @@ -1095,7 +1095,7 @@ The return value can have one of the following types.

{dpr, [option()]}

-Causes Disconnect-Peer-Request to be sent to the peer, the transport +Send Disconnect-Peer-Request to the peer, the transport process being terminated following reception of Disconnect-Peer-Answer or timeout. An option() can be one of the following.

@@ -1104,7 +1104,7 @@ An option() can be one of the following.

{cause, 0|rebooting|1|busy|2|goaway}

-The Disconnect-Cause to send, REBOOTING, BUSY and +Disconnect-Cause to send, REBOOTING, BUSY and DO_NOT_WANT_TO_TALK_TO_YOU respectively. Defaults to rebooting for Reason=service|application and goaway for Reason=transport.

@@ -1113,7 +1113,7 @@ Defaults to rebooting for Reason=service|application and {timeout, &dict_Unsigned32;}

-The number of milliseconds after which the transport process is +Number of milliseconds after which the transport process is terminated if DPA has not been received. Defaults to 1000.

 @@ -1129,7 +1129,7 @@ Equivalent to {dpr, []}.

close

-Causes the transport process to be terminated without +Terminate the transport process without Disconnect-Peer-Request being sent to the peer.

 @@ -1156,7 +1156,7 @@ Defaults to a single callback returning dpr.

{length_errors, exit|handle|discard}

-Specifies how to deal with errors in the Message Length field of the +How to deal with errors in the Message Length field of the Diameter Header in an incoming message. An error in this context is that the length is not at least 20 bytes (the length of a Header), is not a multiple of 4 (a valid length) or @@ -1192,12 +1192,14 @@ See &man_tcp; for the behaviour of that module.

Number of transport processes to start. -For a listening transport, defines the size of the pool of accepting -transport processes, a larger number being desirable for processing -multiple concurrent peer connection attempts. -For a connecting transport, the &service_opt; -restrict_connections must also be configured on the service in -question to allow multiple connections to the same peer.

+For a listening transport, determines the size of the pool of +accepting transport processes, a larger number being desirable for +processing multiple concurrent peer connection attempts. +For a connecting transport, determines the number of connections to +the peer in question that will be attempted to be establshed: +the &service_opt;: restrict_connections should also be +configured on the service in question to allow multiple connections to +the same peer.

 @@ -1205,7 +1207,7 @@ question to allow multiple connections to the same peer.

{spawn_opt, [term()]}

-An options list passed to &spawn_opt; when spawning a process for an +Options list passed to &spawn_opt; when spawning a process for an incoming Diameter request. Options monitor and link are ignored.

@@ -1218,7 +1220,7 @@ Defaults to the list configured on the service if not specified.

{transport_config, term(), &dict_Unsigned32; | infinity}

-A term passed as the third argument to the &transport_start; function of +Term passed as the third argument to the &transport_start; function of the relevant &transport_module; in order to start a transport process. Defaults to the empty list if unspecified.

@@ -1246,7 +1248,7 @@ To listen on both SCTP and TCP, define one transport for each.

{transport_module, atom()}

-A module implementing a transport process as defined in &man_transport;. +Module implementing a transport process as defined in &man_transport;. Defaults to diameter_tcp if unspecified.

@@ -1266,7 +1268,7 @@ corresponding timeout (see below) or all fail.

{watchdog_config, [{okay|suspect, non_neg_integer()}]}

-Specifies configuration that alters the behaviour of the watchdog +Configuration that alters the behaviour of the watchdog state machine. On key okay, the non-negative number of answered DWR messages before transitioning from REOPEN to OKAY. @@ -1321,7 +1323,7 @@ in predicate functions passed to &remove_transport;.

transport_ref() = reference()

-An reference returned by &add_transport; that +Reference returned by &add_transport; that identifies the configuration.

 -- cgit v1.2.3