summary refs log tree commit diff stats
diff options
context:
space:
mode:
-rw-r--r--doc/ranger.17
-rw-r--r--doc/ranger.pod7
2 files changed, 10 insertions, 4 deletions
diff --git a/doc/ranger.1 b/doc/ranger.1
index 1bbcd349..dcfc3b95 100644
--- a/doc/ranger.1
+++ b/doc/ranger.1
@@ -357,8 +357,11 @@ Also try:
 \& pydoc ranger.api
 .Ve
 .PP
-The \fIexamples\fR directory contains several sample plugins, including a well
-documented hello-world plugin using hooks in a compatibility-friendly way.
+Note that you should \s-1NOT\s0 simply overwrite a function unless you know what
+you're doing.  Instead, save the existing function and call it from your new
+one.  This way, multiple plugins can use the same hook.  There are several
+sample plugins in the \fIexamples/\fR directory, including a hello-world plugin
+that describes this procedure.
 .SH "KEY BINDINGS"
 .IX Header "KEY BINDINGS"
 Key bindings are defined in the file \fIranger/config/rc.conf\fR.  Check this
diff --git a/doc/ranger.pod b/doc/ranger.pod
index 219d2f0b..bab92412 100644
--- a/doc/ranger.pod
+++ b/doc/ranger.pod
@@ -257,8 +257,11 @@ Also try:
 
  pydoc ranger.api
 
-The F<examples> directory contains several sample plugins, including a well
-documented hello-world plugin using hooks in a compatibility-friendly way.
+Note that you should NOT simply overwrite a function unless you know what
+you're doing.  Instead, save the existing function and call it from your new
+one.  This way, multiple plugins can use the same hook.  There are several
+sample plugins in the F<examples/> directory, including a hello-world plugin
+that describes this procedure.
 
 
 
container.bookmarks.html?h=v1.1.0&id=4e01caf19cfbc798862e6b8b2dbd77328c8f99a2'>^
f07bb12f ^








1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122