diff --git a/Markdown.pl b/Markdown.pl
index a62b5bf..69930ac 100755
--- a/Markdown.pl
+++ b/Markdown.pl
@@ -4337,6 +4337,11 @@ Wrap the output in a full document stub (i.e. has C, C
and C
tags). The style sheet I be included in the C section unless the
B<--no-stylesheet> option is also used.
+The C<< >> value for a document produced with the B<--stub> option
+comes from the first markdown markup C that's generated unless YAML
+processing has been enabled (the default) and a C YAML value has
+been set in which case that always takes precedence.
+
=item B<-h>, B<--help>