summary refs log tree commit diff stats
path: root/doc/ranger.pod
diff options
context:
space:
mode:
authorhut <hut@lavabit.com>2012-12-03 23:39:14 +0100
committerhut <hut@lavabit.com>2012-12-04 23:32:21 +0100
commit9a17dde6ec166935165d53d858d6fb31868f814f (patch)
tree35063e23876b31dcc9f1ea8110a7beb84dd3635e /doc/ranger.pod
parentadff84a4645953d3c2feb929eecfd67badc99eff (diff)
downloadranger-9a17dde6ec166935165d53d858d6fb31868f814f.tar.gz
doc/ranger.1: add a warning about overwriting hooks
Diffstat (limited to 'doc/ranger.pod')
-rw-r--r--doc/ranger.pod7
1 files changed, 5 insertions, 2 deletions
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.