From: David Kastrup <dak@gnu.org>
Date: Sun, 12 Aug 2012 09:03:47 +0000 (+0200)
Subject: Document "landscape" and "portrait" suffixes for paper size
X-Git-Tag: release/2.17.0-1~34
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=40512052df3dffc2f9fb79641e9df975c5e23354;p=lilypond.git

Document "landscape" and "portrait" suffixes for paper size
---

diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely
index dba9dbbae2..96d307c5ad 100644
--- a/Documentation/notation/spacing.itely
+++ b/Documentation/notation/spacing.itely
@@ -265,7 +265,18 @@ accordingly.
 #(set-default-paper-size "a6" 'landscape)
 @end example
 
-The music output will @emph{not} be rotated, just the paper size.
+Swapping the paper dimensions @emph{without} having the print rotated
+(like when printing to postcard size, or creating graphics for inclusion
+rather than a standalone document) can be achieved by appending
+@samp{landscape} to the name of the paper size itself:
+
+@example
+#(set-default-paper-size "a6landscape")
+@end example
+
+When the paper size ends with an explicit @samp{landscape} or
+@samp{portrait}, the presence of a @code{'landscape} symbol @emph{only}
+affects print orientation, not the paper dimensions used for layout.
 
 @seealso
 Notation Reference: