aboutsummaryrefslogtreecommitdiffstats
path: root/doc/expert/pre_hexp
diff options
context:
space:
mode:
authorJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 19:21:41 +0000
committerJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 19:21:41 +0000
commit71bdb35d52747e6d7d9f55df4524d57c2966be94 (patch)
tree480ee5eefccc40d5f3331cc52d66f722fd19bfb9 /doc/expert/pre_hexp
parentb41263ea7578fa9742486135c762803b52794105 (diff)
downloadlout-71bdb35d52747e6d7d9f55df4524d57c2966be94.tar.gz
Lout 3.17.
git-svn-id: http://svn.savannah.nongnu.org/svn/lout/trunk@2 9365b830-b601-4143-9ba8-b4a8e2c3339c
Diffstat (limited to 'doc/expert/pre_hexp')
-rw-r--r--doc/expert/pre_hexp29
1 files changed, 29 insertions, 0 deletions
diff --git a/doc/expert/pre_hexp b/doc/expert/pre_hexp
new file mode 100644
index 0000000..937e746
--- /dev/null
+++ b/doc/expert/pre_hexp
@@ -0,0 +1,29 @@
+@Section
+ @Title { "@HExpand" and "@VExpand" }
+ @Tag { hexpand }
+@Begin
+@PP
+hexpand. @Index { @@HExpand symbol }
+vexpand. @Index { @@VExpand symbol }
+expansion @Index { Expansion of object }
+The @@HExpand symbol causes its right parameter to be as wide as it
+possibly could be without violating a @@Wide symbol or intruding into
+the space occupied by neighbouring gaps or objects. The @@VExpand
+symbol is similar, but it affects height. For example, in the object
+@ID @Code {
+"8i @Wide 11i @High {"
+" //1i ||1i @HExpand @VExpand x ||1i"
+" //1i"
+"}"
+}
+object @Code x could have any size up to six inches wide by nine inches
+high, so the @@HExpand and @@VExpand symbols cause it to have exactly
+this size. This is important, for example, if @Code x contains
+@Code "|1rt" or {@Code "/1rt"}; without the expansion these might not
+move as far across or down as expected.
+@PP
+As Section {@NumberOf size} explains in detail, most objects are
+already as large as they possibly could be. Consequently these symbols
+are needed only rarely. @@HExpand includes a @@OneCol effect, and
+@@VExpand includes a @@OneRow effect.
+@End @Section