File 0799-snmp-doc-Fix-dead-links.patch of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 0799-snmp-doc-Fix-dead-links.patch of Package erlang (Revision ee5107dd2cb9269b862e70debf0422c2)

Currently displaying revision ee5107dd2cb9269b862e70debf0422c2 , Show latest

From eda134ded2bdcf3d035a866ea07e1bf9e1f24d4a Mon Sep 17 00:00:00 2001
From: Micael Karlberg <bmk@erlang.org>
Date: Mon, 21 Oct 2019 12:21:28 +0200
Subject: [PATCH] [snmp|doc] Fix dead links

When the man page for the application was changed from
'snmp (App)' to 'SNMP (App)' links to that page failed
(since they used lower case).
Solved by instead linking to the snmp config chapter
of the user's guide (snmp_config).
---
 lib/snmp/doc/src/notes.xml                         | 10 +++----
 lib/snmp/doc/src/notes_history.xml                 | 32 ++++++++++------------
 lib/snmp/doc/src/snmp_app.xml                      | 11 ++++++++
 .../doc/src/snmpa_network_interface_filter.xml     |  2 +-
 4 files changed, 31 insertions(+), 24 deletions(-)

diff --git a/lib/snmp/doc/src/notes.xml b/lib/snmp/doc/src/notes.xml
index 83d356d6f1..d445dbf677 100644
--- a/lib/snmp/doc/src/notes.xml
+++ b/lib/snmp/doc/src/notes.xml
@@ -409,11 +409,11 @@
 <item>
 [agent] Enable SNMP to create missing database directories. 
 	 Add 
-	 <seealso marker="snmp_app#db_init_error">
+	 <seealso marker="snmp_config#db_init_error">
 	 {db_init_error, create_db_and_dir}</seealso> option to SNMP 
-	 <seealso marker="snmp_app#manager_opts_and_types">manager</seealso> 
+	 <seealso marker="snmp_config#manager_opts_and_types">manager</seealso> 
 	 and
-	 <seealso marker="snmp_app#agent_opts_and_types">agent</seealso>. 
+	 <seealso marker="snmp_config#agent_opts_and_types">agent</seealso>. 
 	 This allows them to create any missing parent directories for
 	 <c>db_dir</c>, rather than treating any missing directories 
 	 as a fatal error.
@@ -1086,7 +1086,7 @@
 limit the number of varbinds that can be included in 
 a Get-BULK response message. This is specified by the 
 new config option, 
- <seealso marker="snmp_app#agent_gb_max_vbs">gb_max_vbs</seealso>. 
+ <seealso marker="snmp_config#agent_gb_max_vbs">gb_max_vbs</seealso>. 
 
 Own Id: OTP-9700
 </item>
@@ -1145,7 +1145,7 @@
 limit the number of varbinds that can be included in 
 a Get-BULK response message. This is specified by the 
 new config option, 
- <seealso marker="snmp_app#agent_gb_max_vbs">gb_max_vbs</seealso>. 
+ <seealso marker="snmp_config#agent_gb_max_vbs">gb_max_vbs</seealso>. 
 
 Own Id: OTP-9700
 </item>
diff --git a/lib/snmp/doc/src/notes_history.xml b/lib/snmp/doc/src/notes_history.xml
index cae9630ff9..d66d464e1c 100644
--- a/lib/snmp/doc/src/notes_history.xml
+++ b/lib/snmp/doc/src/notes_history.xml
@@ -211,8 +211,6 @@
 <seealso marker="snmp_config#audit_trail_log">Audit Trail Log</seealso> 
 config option. 
 See the 
- <seealso marker="snmp_app#configuration_params">reference manual</seealso> 
- or the 
 <seealso marker="snmp_config#configuration_params">Configuring the application</seealso> 
 chapter of the User's Guide for further info. 
 
@@ -272,8 +270,6 @@
 <seealso marker="snmp_config#audit_trail_log">Audit Trail Log</seealso> 
 config option. 
 See the 
- <seealso marker="snmp_app#configuration_params">reference manual</seealso> 
- or the 
 <seealso marker="snmp_config#configuration_params">Configuring the application</seealso> 
 chapter of the User's Guide for further info. 
 
@@ -416,7 +412,7 @@
 See also the Configuring chapter of
 the User's Guide to see how to configure this feature. 
 See the 
- <seealso marker="snmp_app#configuration_params">configuration</seealso> 
+ <seealso marker="snmp_config#configuration_params">configuration</seealso> 
 chapter for more info about the filter options.
 Own Id: OTP-8228
 	 Aux Id: Seq 11411
@@ -486,7 +482,7 @@
 <seealso marker="snmpa#update_mibs_cache_age">update_mibs_cache_age/1,2</seealso> and 
 <seealso marker="snmpa#update_mibs_cache_gclimit">update_mibs_cache_gclimit/1,2</seealso> for more info. 
 See also the 
- <seealso marker="snmp_app#configuration_params">configuration</seealso> 
+ <seealso marker="snmp_config#configuration_params">configuration</seealso> 
 chapter for more info about the mib server cache options.
 Own Id: OTP-8182
 	 Aux Id: Seq 11383
@@ -499,7 +495,7 @@
 make it possible to configure the username the agent reacts to. 
 Default is <c>""</c>. 
 See the 
- <seealso marker="snmp_app#configuration_params">configuration</seealso> 
+ <seealso marker="snmp_config#configuration_params">configuration</seealso> 
 chapter for more info about the discovery options.
 Own Id: OTP-8120
 	 Aux Id: Seq 11361
@@ -674,7 +670,7 @@
 of these problems. 
 Introduced various options for controlling the discovery
 process. See the 
- <seealso marker="snmp_app#configuration_params">configuration</seealso> 
+ <seealso marker="snmp_config#configuration_params">configuration</seealso> 
 chapter for more info about the discovery options.
 Own Id: OTP-8020
 	 Aux Id: Seq 11295
@@ -1058,7 +1054,8 @@
 [agent] A simple lookup cache has been added to improve 
 the mib server lookup performance. 
 This can be disabled with the mib_server 
- <seealso marker="snmp_app">cache</seealso> option. 
+	 <seealso marker="snmp_config#agent_ms_cache">cache</seealso>
+	 option. 
 Own Id: OTP-7346
 </item>
 
@@ -1328,7 +1325,7 @@
 <list type="bulleted">
 <item>
 [manager] The configuration option 
- <seealso marker="snmp_app">inform_request_behaviour</seealso>
+ <seealso marker="snmp_config#manager_irb">inform_request_behaviour</seealso>
 was not properly parsed, which caused the manager to revert 
 to the default value, <c>auto</c>. 
 Own Id: OTP-7219
@@ -1561,7 +1558,7 @@
 network interface filter module. This module must implement the 
 <seealso marker="snmpa_network_interface_filter">network interface filter behaviour</seealso>. 
 See also the 
- <seealso marker="snmp_app#configuration_params">Configuring the application</seealso> 
+ <seealso marker="snmp_config#configuration_params">Configuring the application</seealso> 
 chapter of the User's Guide to see how to configure this 
 feature. 
 	 Own Id: OTP-6649
@@ -2047,9 +2044,8 @@
 <item>
 Added a config option, <c>sndbuf</c>, for the net_if-module(s). 
 See 
- <seealso marker="snmp_app">application configuration</seealso> or
- <seealso marker="snmp_config">running the application</seealso> 
- for more info (look for manager_net_if_options and 
+ <seealso marker="snmp_config#configuration_params">Configure the application</seealso> 
+ for more info (look for manager_net_if_options and
 agent_net_if_options). 
 Own Id: OTP-6137
 </item>
@@ -2366,7 +2362,7 @@
 </item>
 <item>
 Improved handling of audit trail logs.
- See the <seealso marker="snmp_app">atl_repair</seealso> 
+ See the <seealso marker="snmp_config">atl_repair</seealso> 
 config for more info.
 Own Id: OTP-5771
 </item>
@@ -2407,7 +2403,7 @@
 <list type="bulleted">
 <item>
 [manager] Introduced the 
- <seealso marker="snmp_app">inform request behaviour</seealso> 
+ <seealso marker="snmp_config#manager_irb">inform request behaviour</seealso> 
 configuration option to allow the user to specify
 how/when the manager shall acknowledge inform-request's.
 Own Id: OTP-5733
@@ -3093,7 +3089,7 @@
 <seealso marker="snmpm_user">user behaviour</seealso> 
 could be overridden (default user is the module
 <c>snmpm_user_default</c>). 
- See <seealso marker="snmp_app">application configuration</seealso> or
+ See 
 <seealso marker="snmp_config#configuration_params">configuration params</seealso>.
 Own Id: OTP-5299
 </item>
@@ -3380,7 +3376,7 @@
 works (if only the agent is used), it is no
 longer documented and will eventually be 
 eliminated.
- See <seealso marker="snmp_app">application configuration</seealso> or
+ See 
 <seealso marker="snmp_config#configuration_params">configuration params</seealso> for more info.
 </item>
 <item>
diff --git a/lib/snmp/doc/src/snmp_app.xml b/lib/snmp/doc/src/snmp_app.xml
index dc78810eef..54a7eafe76 100644
--- a/lib/snmp/doc/src/snmp_app.xml
+++ b/lib/snmp/doc/src/snmp_app.xml
@@ -50,6 +50,17 @@
 </item>
 </list>
 
+ 
+
+
 </description>
 
 <section>
diff --git a/lib/snmp/doc/src/snmpa_network_interface_filter.xml b/lib/snmp/doc/src/snmpa_network_interface_filter.xml
index 02c7d291dd..9a9123231b 100644
--- a/lib/snmp/doc/src/snmpa_network_interface_filter.xml
+++ b/lib/snmp/doc/src/snmpa_network_interface_filter.xml
@@ -76,7 +76,7 @@
 (<c>snmpa_net_if</c>). The default filter accepts all messages.
 A network interface filter can e.g. be used during testing or for load 
 regulation. If the intended use is load regulation, see also 
- <seealso marker="snmp_app#configuration_params">req_limit</seealso> and 
+ <seealso marker="snmp_config#agent_ni_req_limit">req_limit</seealso> and 
 the function 
 <seealso marker="snmpa#register_notification_filter">register_notification_filter</seealso>. 
 Legacy network interface filter modules used arguments on the form
-- 
2.16.4

Places

File 0799-snmp-doc-Fix-dead-links.patch of Package erlang (Revision ee5107dd2cb9269b862e70debf0422c2)

Places