commit 094769f

doc: Fix typos, improve wording somewhat

 1@@ -43,19 +43,18 @@ The user interface of senpai consists of 4 parts.  Starting from the bottom:
 2 The *buffer list*, shows joined channels.  The special buffer *home* is where
 3 private messages and server notices are shown.
 4 
 5-On the row above, *input field* is where you type in messages or commands (see
 6-*COMMANDS*).  By default, when you type a message, senpai will send a
 7-notification to the current channel and other will be able to know you are
 8-typing.
 9+On the row above, the *input field* is where you type in messages or commands
10+(see *COMMANDS*).  By default, when you type a message, senpai will inform
11+others in the channel that you are typing.
12 
13 On the row above, the *status line* (or... just a line if nothing is
14-happening...) is where typing indicator are shown (e.g. "dan- is typing...").
15+happening...) is where typing indicators are shown (e.g. "dan- is typing...").
16 
17-Finally, the *timeline* is displayed on the rest of the screen.  There are
18-several types of messages in the timeline:
19+Finally, the *timeline* is displayed on the rest of the screen.  Several types
20+of messages are in the timeline:
21 
22 - User messages are shown with their nicknames,
23-- User actions (*/me*) are shown with an asterisk (*\**) followed by the user
24+- User actions (*/me*) are shown with an asterisk (*\**) followed by the user's
25   nickname,
26 - Status messages, such as joins, parts, topics and name lists, are shown with
27   two dashes (*--*),
28@@ -94,40 +93,40 @@ several types of messages in the timeline:
29 
30 # COMMANDS
31 
32-If the user types and sends a message that starts with a slash (*/*), it will
33-instead be interpreted as a command:
34+If you type and send a message that starts with a slash (*/*), it will instead
35+be interpreted as a command:
36 
37 	/_name_ argument1 argument2...
38 
39 _name_ is matched case-insensitively.  It can be one of the following:
40 
41 *J*, *JOIN* <channel>
42-	Joins the given channel.
43+	Join the given channel.
44 
45 *PART* [channel]
46 	Part the given channel, defaults to the current one if omitted.
47 
48 *NAMES*
49-	Shows the member list of the current channel.  Powerlevels (such as _@_ for
50+	Show the member list of the current channel.  Powerlevels (such as _@_ for
51 	"operator", or _+_ for "voice") are shown in green.
52 
53 *TOPIC* [topic]
54-	If _topic_ is omitted, shows the topic of the current channel and, if
55+	If _topic_ is omitted, show the topic of the current channel and, if
56 	available, the person who set it and the time when it has been set.
57 
58 	Otherwise, change the topic of the current channel to _topic_.
59 
60 *MSG* <target> <content>
61-	Sends _content_ to _target_.
62+	Send _content_ to _target_.
63 
64 *R* <content>
65-	Reply to the last person who sent you a private message.
66+	Reply to the last person who sent a private message.
67 
68 *ME* <content>
69-	Sends a message prefixed with your nick (a user action).
70+	Send a message prefixed with your nick (a user action).
71 
72 *QUOTE* <raw message>
73-	Sends _raw message_ verbatim.
74+	Send _raw message_ verbatim.
75 
76 # SEE ALSO
77 

 1@@ -14,8 +14,8 @@ Some settings are required, the others are optional.
 2 
 3 *addr* (required)
 4 	The address (_host:port_) of the IRC server.  senpai only supports TLS
 5-	connections and thus the user must specify the TLS port of the server (in
 6-	most cases, 6697 or 7000).
 7+	connections and thus you must specify the TLS port of the server (in most
 8+	cases, 6697 or 7000).
 9 
10 *nick* (required)
11 	Your nickname, sent with a _NICK_ IRC message. It mustn't contain spaces or
12@@ -37,8 +37,8 @@ Some settings are required, the others are optional.
13 	when said by others.  By default, senpai will use your current nickname.
14 
15 *on-highlight*
16-	A command to be executed via _sh_ when the user is highlighted.  The
17-	following format specifiers are expanded with respect to the highlight:
18+	A command to be executed via _sh_ when you are highlighted.  The following
19+	format specifiers are expanded with respect to the highlight:
20 
21 [[ *Format specifier*
22 :< *Description*
23@@ -46,6 +46,8 @@ Some settings are required, the others are optional.
24 :  literal %
25 |  %b
26 :  buffer where the message appeared
27+|  %h
28+:  equals 1 if _%b_ is the current buffer, 0 otherwise
29 |  %m
30 :  content of the message
31 |  %n
32@@ -66,7 +68,9 @@ user: senpai
33 ```
34 
35 A more advanced configuration file that enables SASL authentication, sends
36-notifications on highlight and decrease the width of the nick column to 12:
37+notifications on highlight and decreases the width of the nick column to 12
38+(note: _swaymsg_ is specific to sway, a wayland compositor.  Use whatever you
39+need to know if the terminal emulator that runs senpai has focus):
40 
41 ```
42 addr: chat.freenode.net:6697