From 165e38050c81ee6700232527c72dec96000cdd2b Mon Sep 17 00:00:00 2001 From: default Date: Tue, 11 Feb 2025 09:16:50 +0100 Subject: Updated documentation. --- doc/snac.8 | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/snac.8 b/doc/snac.8 index 7e3213b..c0a110c 100644 --- a/doc/snac.8 +++ b/doc/snac.8 @@ -23,8 +23,12 @@ Ultrix machine in your grandfather basement, probably MacOS) support hard links on their native filesystems. Don't do fancy things like moving the subdirectories to different filesystems. Also, if you move your .Nm -installation to another server, do it with a tool that respect hard -link counts. Remember: +installation to another server, do it with a tool that keeps hard +links, like +.Xr tar 1 +or +.Xr rsync 1 +with the -H switch. Remember: .Nm is a very UNIXy program that loves hard links. .Ss Building and Installation -- cgit v1.2.3 From 292b2fd1224a40fd3fa5bc33248a7b11316abc22 Mon Sep 17 00:00:00 2001 From: default Date: Thu, 13 Feb 2025 19:44:21 +0100 Subject: Force the Content-Security-Policy header, instead of just suggesting it in the docs. --- doc/snac.8 | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/snac.8 b/doc/snac.8 index c0a110c..7a7352c 100644 --- a/doc/snac.8 +++ b/doc/snac.8 @@ -198,9 +198,7 @@ By setting this to true, no inbox collection is done. Inbox collection helps being discovered from remote instances, but also increases network traffic. .It Ic http_headers If you need to add more HTTP response headers for whatever reason, you can -fill this object with the required header/value pairs. For example, for enhanced -XSS security, you can set the "Content-Security-Policy" header to "script-src ;" -to be totally sure that no JavaScript is executed. +fill this object with the required header/value pairs. .It Ic show_instance_timeline If this is set to true, the instance base URL will show a timeline with the latest user posts instead of the default greeting static page. If other information -- cgit v1.2.3 From 0af0c28633f5c1788965861928edb8acd9f62ed2 Mon Sep 17 00:00:00 2001 From: Menelmacar Date: Mon, 17 Feb 2025 08:33:12 +0000 Subject: doc/snac8: elaborate regex blocking It seems regex blocking only works with lower case letters, since the case will be ignored anyway this is fine. This updates the documentation to express this. --- doc/snac.8 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/snac.8 b/doc/snac.8 index 7a7352c..f1e5590 100644 --- a/doc/snac.8 +++ b/doc/snac.8 @@ -329,8 +329,9 @@ These weapons of mass destruction can be written into the file in the server base directory, one per line; if this file exists, all posts' content will be matched (after being stripped of HTML tags) against these regexes, one by one, and any match will make the post to -be rejected. If you don't know about regular expressions, don't use this -option (or learn about them in some tutorial, there are gazillions of +be rejected. Use lower case, the regex will be case insensitive by default. +If you don't know about regular expressions, don't use this +option (or learn about them inw some tutorial, there are gazillions of them out there), as you and your users may start missing posts. Also, given that every regular expression implementation supports a different set of features, consider reading the documentation about the one -- cgit v1.2.3