Doc: specify which \header blocks generate PDF metadata (issue 300620043 by address@hidden)

[fedelogy]

Reviewers: ,

Description:
Doc: specify which \header blocks generate PDF metadata

Issue 4921

Please review this at https://codereview.appspot.com/300620043/

Affected files (+8, -3 lines):
  M Documentation/notation/input.itely


Index: Documentation/notation/input.itely
diff --git a/Documentation/notation/input.itely  
b/Documentation/notation/input.itely
index  
ce33708eac5f57d1fceff81dee2a776e67349bd6..0bcd8d85cc04f1fd738740751565902c94c12318  
100644
--- a/Documentation/notation/input.itely
+++ b/Documentation/notation/input.itely
@@ -1207,9 +1207,14 @@ Installed Files:

 In addition to being shown in the printed output, @code{\header} variables
 are also used to set PDF metadata (the information displayed by PDF readers
-as the @code{properties} of the PDF file).  For example, setting the
address@hidden property of the @code{header} block @q{Symphony I} will also  
give
-this title to the PDF document.
+as the @code{properties} of the PDF file).  As metadata are applied per
+output file, only @address@hidden blocks located at top level or within  
an
+explicit @address@hidden block will be used to generate PDF metadata;  
while
address@hidden@bs{}header} variables defined in a @address@hidden or
address@hidden@bs{}score} block will appear only in the output.
+
+For example, setting the @code{title} property of the @code{header} block
address@hidden I} will also give this title to the PDF document.

 @example
   @address@hidden