commands.org
... ...
@@ -116,7 +116,7 @@ title: Commands | Pluckeye
116 116
117 117
* delay
118 118
119
- /Main article: [[delay]]/
119
+ /Main article: [[delay#setting-the-delay][Delay]]/
120 120
121 121
* delays
122 122
delay.org
... ...
@@ -4,65 +4,70 @@ title: The Delay | Pluckeye
4 4
5 5
The Pluckeye delay is the most important Pluckeye setting.
6 6
7
-When the delay is 0 (nil), any change to Pluckeye settings takes
8
-effect immediately. For example, all of the following commands will
9
-have immediate effect.
7
+* The effect of the delay
10 8
11
-#+BEGIN_SRC sh
12
- pluck + allow a.com
13
- pluck + allow everything
14
- pluck + block everything
15
- pluck uninstall
16
-#+END_SRC
9
+ When the delay is 0 (sometimes represented as "nil"), any change to your Pluckeye configuration will take
10
+ effect immediately. For example, you could add any of the following [[rules]] to your configuration, and they would take effect immediately:
17 11
18
-However, when the delay is not 0 (nil), *any changes to settings that
19
-will result in greater access will be delayed*.
12
+ #+BEGIN_EXAMPLE
13
+ allow a.com
14
+ allow everything
15
+ block everything
16
+ #+END_EXAMPLE
20 17
21
-For example, even after the following sequence of commands is ran,
22
-full access to b.com will still not be granted until 3 seconds have
23
-elapsed.
18
+ You could also uninstall Pluckeye immediately.
24 19
25
-#+BEGIN_SRC sh
26
- pluck delay 3
27
- pluck + allow b.com
28
-#+END_SRC
20
+ However, when the delay is not 0 (nil), *any changes to your configuration that
21
+ will result in greater access will be delayed*. (Other changes will still take immediate effect.)
29 22
30
-Immediately after =pluck + allow b.com=, full access to b.com will
31
-still be denied. But after 3 seconds have elapsed, full access to
32
-b.com will be granted, and the =allow b.com= setting is said to have
33
-become /effective/.
23
+ For example, if your delay was set to 3 seconds and you added the rule ~allow b.com~, the rule would not take effect (i.e., ~b.com~ would not be allowed) until 3 seconds after you added it, since this change increases what you can access.
34 24
35
-Note that *any decreases to the delay* must also endure the delay
36
-period.
25
+ #+BEGIN_SRC sh
26
+ pluck delay 3
27
+ pluck + allow b.com
28
+ #+END_SRC
37 29
38
-So if the delay is 3 seconds, after requesting the delay be set to 0,
39
-3 seconds must still elapse before the effective delay actually becomes 0.
40
-E.g.,
30
+ However, if you /removed/ the rule ~allow b.com~, this change /would/ take effect immediately (since it /decreases/ your access), and ~b.com~ would cease to be allowed.
41 31
42
-#+BEGIN_SRC sh
43
- pluck delay 3
44
- pluck delay 0
45
- # the delay remains 3 seconds until 3 seconds have elapsed
46
-#+END_SRC
32
+ Note that *any decreases to your delay* must also endure the delay
33
+ period.
47 34
48
-In addition, disabling the [[system][system feature]] (changing the installation level in older versions) or uninstalling requires
49
-that the delay be 0. So, the following will /not/ result in Pluckeye
50
-being uninstalled.
35
+ So if your delay is 3 seconds, after requesting the delay be set to 0,
36
+ 3 seconds must still elapse before the effective delay actually becomes 0.
51 37
52
-#+BEGIN_SRC sh
53
- pluck delay 1
54
- pluck uninstall
55
-#+END_SRC
38
+ In addition, disabling the [[system][system feature]] (changing the installation level in older versions) or uninstalling requires
39
+ that the delay be 0. So if you set your delay to 1 second and then try to uninstall Pluckeye using the button in the browser extension settings or using the uninstall command (~pluck uninstall~ in a [[how-to-open-a-console-window.org][console window]]), Pluckeye will refuse to uninstall. You must first set the delay to 0 and wait for this change to become effective.
56 40
57
-But this sequence of commands will (assuming the delay is 3 seconds):
41
+ See [[tips]] for some other tips on the delay and related features.
58 42
59
-#+BEGIN_SRC sh
60
- pluck delay 0
61
- sleep 3 # sleep for 3 seconds so the effective delay becomes 0
62
- pluck uninstall
63
-#+END_SRC
43
+* Setting the delay
44
+
45
+** Using the browser extension
46
+
47
+*** v1.0+
48
+
49
+ 1. Click the Pluck button (in the top right corner of your browser).
50
+ 2. In the new tab that opens, click "config" in the navigation bar at the top.
51
+ 3. Click the "delay" button that shows your current delay.
52
+ 4. Enter the new delay you want.
53
+ 5. Click "Apply".
54
+ 6. If you have decreased the delay, wait for the new delay to come into effect.
55
+
56
+** Using a console
64 57
65
-See [[tips]] for some other tips on the delay and related features.
58
+ Use the delay command to set the delay in a [[how-to-open-a-console-window.org][console window]]. For example, to set the delay to 10 seconds, run:
59
+
60
+ #+BEGIN_SRC sh
61
+ pluck delay 10 seconds
62
+ #+END_SRC
63
+
64
+ You can also use this command to check what your current delay is. If you run
65
+
66
+ #+BEGIN_SRC sh
67
+ pluck delay
68
+ #+END_SRC
69
+
70
+ it will show you your current delay, converted to seconds.
66 71
67 72
* Varying the delay by time of day
68 73
... ...
@@ -74,7 +79,9 @@ See [[tips]] for some other tips on the delay and related features.
74 79
pluck when 12-24 delay 7200
75 80
#+END_SRC
76 81
77
-* Delay patterns (advanced, Pluckeye 1.0+)
82
+ See [[hrs3]] for more on the time format used.
83
+
84
+* Delay patterns (advanced, Pluck 1.0+)
78 85
79 86
Delay patterns are somewhat complex, hard to describe, and to use
80 87
them well may require some significant thought. If those hurdles