1 file changed, 9 insertions, 2 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 1b127e5..5cd9e91 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -169,8 +169,15 @@ email-filter::
 
 embedded::
 	Flag which, when set to "1", makes cgit generate an HTML fragment
-	suitable for embedding in other HTML pages. Default value: "0". See
-	also: "enable-header".
+	suitable for embedding in other HTML pages. cgit then writes no document
+	head, so css, js, favicon, robots and head-include have no effect. The
+	host page, or the header and footer files around the fragment, has to
+	link cgit.css itself, load cgit.js with defer, and carry a robots meta
+	tag if one is wanted. cgit.css gives the fragment its own background and
+	colour scheme, which follows the visitor's light or dark preference
+	whatever the host page does, so a host page that is always light can pin
+	it with the rule div#cgit.cgit-embedded { color-scheme: light; }.
+	Default value: "0". See also: "enable-header".
 
 enable-blame::
 	Flag which, when set to "1", lets cgit provide a "blame" page for files