1 files changed, 21 insertions, 0 deletions

diff --git a/doc/snac.8 b/doc/snac.8
index e28c6fd..b96899e 100644
--- a/doc/snac.8
+++ b/doc/snac.8
@@ -230,6 +230,27 @@ for details. Further, every user can have a private CSS file in their
 that will be served instead of the server-wide one.
 It's not modifiable from the web interface to avoid users
 shooting themselves in the foot by destroying everything.
+.Ss Custom Emojis
+From version 2.51, support for customized Emojis in posts is available
+(previously, they were hardcoded). Emojis are read from the
+.Pa emojis.json
+file in the instance base directory, as a JSON object of key / value
+pairs (if this file does not exist, it will be created with
+the predefined set). Each key in the object contains the text to be found (e.g.,
+the :-) for a smiling face), and its associated value, the text string that
+will replace it (in this example case, the HTML entity for the Unicode codepoint
+for the smiley or the Emoji itself as text).
+.Pp
+Emoji values can also be URLs to image files; in this case, they will not be
+substituted in the post content, but added to the 'tag' array as an ActivityPub
+standard 'Emoji' object (it's recommendable that the Emoji key be enclosed in
+colons for maximum compatilibity with other ActivityPub implementations, like
+e.g. :happydoggo:). These images can be served from an external source or from the
+.Pa static
+directory of the instance admin.
+.Pp
+If you want to disable any Emoji substitution, leave it as a 0 byte file
+or with an empty JSON object ({}).
 .Ss SPAM Mitigation
 There have been some SPAM attacks on the Fediverse and, as too many
 instances and server implementations out there still allow automatic