1mNAME0m
       pack - Geometry manager that packs around edges of cavity

1mSYNOPSIS0m
       1mpack 4m22moption24m 4marg24m ?4marg24m 4m...24m?


1mDESCRIPTION0m
       The  1mpack  22mcommand  is  used to communicate with the packer, a geometry
       manager that arranges the children of a parent by packing them in order
       around  the edges of the parent.  The 1mpack 22mcommand can have any of sev-
       eral forms, depending on the 4moption24m argument:

       1mpack 4m22mslave24m ?4mslave24m 4m...24m? ?4moptions24m?
              If the first argument to 1mpack 22mis a window name (any value start-
              ing  with  ``.''), then the command is processed in the same way
              as 1mpack configure22m.

       1mpack configure 4m22mslave24m ?4mslave24m 4m...24m? ?4moptions24m?
              The arguments consist of the names of one or more slave  windows
              followed  by  pairs  of arguments that specify how to manage the
              slaves.  See ``THE PACKER ALGORITHM'' below for details  on  how
              the  options  are used by the packer.  The following options are
              supported:

              1m-after 4m22mother0m
                     4mOther24m must the name of another window.  Use its master as
                     the  master  for  the  slaves, and insert the slaves just
                     after 4mother24m in the packing order.

              1m-anchor 4m22manchor0m
                     4mAnchor24m must be a valid anchor position such as 1mn  22mor  1msw22m;
                     it  specifies where to position each slave in its parcel.
                     Defaults to 1mcenter22m.

              1m-before 4m22mother0m
                     4mOther24m must the name of another window.  Use its master as
                     the  master  for  the  slaves, and insert the slaves just
                     before 4mother24m in the packing order.

              1m-expand 4m22mboolean0m
                     Specifies whether the slaves should be expanded  to  con-
                     sume  extra  space in their master.  4mBoolean24m may have any
                     proper boolean value, such as 1m1 22mor 1mno22m.  Defaults to 0.

              1m-fill 4m22mstyle0m
                     If a slave's parcel is larger than its  requested  dimen-
                     sions,  this  option  may  be  used to stretch the slave.
                     4mStyle24m must have one of the following values:

                      1mnone   22mGive the slave its requested dimensions plus  any
                             internal padding requested with 1m-ipadx 22mor 1m-ipady22m.
                             This is the default.

                      1mx      22mStretch the slave horizontally to fill the entire
                             width   of  its  parcel  (except  leave  external
                             padding as specified by 1m-padx22m).

                      1my      22mStretch the slave vertically to fill  the  entire
                             height  of  its  parcel  (except  leave  external
                             padding as specified by 1m-pady22m).

                      1mboth   22mStretch the slave both  horizontally  and  verti-
                             cally.

              1m-in 4m22mother0m
                     Insert  the  slave(s) at the end of the packing order for
                     the master window given by 4mother24m.

              1m-ipadx 4m22mamount0m
                     4mAmount24m specifies how much horizontal internal padding  to
                     leave  on  each  side  of the slave(s).  4mAmount24m must be a
                     valid screen distance, such as 1m2 22mor 1m.5c22m.  It defaults  to
                     0.

              1m-ipady 4m22mamount0m
                     4mAmount24m  specifies  how  much vertical internal padding to
                     leave on each side of the slave(s).  4mAmount24m  defaults  to
                     0.

              1m-padx 4m22mamount0m
                     4mAmount24m  specifies how much horizontal external padding to
                     leave on each side of the slave(s).  4mAmount24m  defaults  to
                     0.

              1m-pady 4m22mamount0m
                     4mAmount24m  specifies  how  much vertical external padding to
                     leave on each side of the slave(s).  4mAmount24m  defaults  to
                     0.

              1m-side 4m22mside0m
                     Specifies  which  side of the master the slave(s) will be
                     packed against.  Must be 1mleft22m,  1mright22m,  1mtop22m,  or  1mbottom22m.
                     Defaults to 1mtop22m.

              If  no  1m-in22m,  1m-after 22mor 1m-before 22moption is specified then each of
              the slaves will be inserted at the end of the packing  list  for
              its  parent unless it is already managed by the packer (in which
              case it will be left where it is).  If one of these  options  is
              specified  then all the slaves will be inserted at the specified
              point.  If any of the slaves are already managed by the geometry
              manager  then any unspecified options for them retain their pre-
              vious values rather than receiving default values.

       1mpack forget 4m22mslave24m ?4mslave24m 4m...24m?
              Removes each of the 4mslave24ms from the packing order for its master
              and  unmaps their windows.  The slaves will no longer be managed
              by the packer.

       1mpack info 4m22mslave0m
              Returns a list whose  elements  are  the  current  configuration
              state  of the slave given by 4mslave24m in the same option-value form
              that might be specified to 1mpack configure22m.  The first  two  ele-
              ments of the list are ``1m-in 4m22mmaster24m'' where 4mmaster24m is the slave's
              master.

       1mpack propagate 4m22mmaster24m ?4mboolean24m?
              If 4mboolean24m has a true boolean value such as 1m1 22mor 1mon 22mthen  propa-
              gation  is  enabled for 4mmaster24m, which must be a window name (see
              ``GEOMETRY PROPAGATION'' below).  If 4mboolean24m has a false boolean
              value  then  propagation  is  disabled for 4mmaster24m.  In either of
              these cases an empty string is returned.  If 4mboolean24m is  omitted
              then  the command returns 1m0 22mor 1m1 22mto indicate whether propagation
              is currently enabled for  4mmaster24m.   Propagation  is  enabled  by
              default.

       1mpack slaves 4m22mmaster0m
              Returns  a  list  of  all of the slaves in the packing order for
              4mmaster24m.  The order of the slaves in the  list  is  the  same  as
              their  order in the packing order.  If 4mmaster24m has no slaves then
              an empty string is returned.


1mTHE PACKER ALGORITHM0m
       For each master the packer maintains an ordered list of  slaves  called
       the  4mpacking24m  4mlist24m.  The 1m-in22m, 1m-after22m, and 1m-before 22mconfiguration options
       are used to specify the master for each slave and the slave's  position
       in  the  packing  list.   If none of these options is given for a slave
       then the slave is added to the end of the packing list for its  parent.

       The  packer  arranges  the  slaves for a master by scanning the packing
       list in order.  At the time it processes each slave, a rectangular area
       within  the  master is still unallocated.  This area is called the 4mcav-0m
       4mity24m;  for the first slave it is the entire area of the master.

       For each slave the packer carries out the following steps:

       [1]    The packer allocates a rectangular 4mparcel24m for  the  slave  along
              the  side  of  the cavity given by the slave's 1m-side 22moption.  If
              the side is top or bottom then the width of the  parcel  is  the
              width  of  the  cavity and its height is the requested height of
              the slave plus the 1m-ipady 22mand 1m-pady 22moptions.  For  the  left  or
              right  side the height of the parcel is the height of the cavity
              and the width is the requested  width  of  the  slave  plus  the
              1m-ipadx  22mand  1m-padx  22moptions.  The parcel may be enlarged further
              because of the 1m-expand 22moption (see ``EXPANSION'' below)

       [2]    The packer chooses the dimensions of the slave.  The width  will
              normally  be  the  slave's requested width plus twice its 1m-ipadx0m
              option and the height will normally  be  the  slave's  requested
              height  plus  twice  its  1m-ipady  22moption.  However, if the 1m-fill0m
              option is 1mx 22mor 1mboth 22mthen the width of the slave is  expanded  to
              fill  the width of the parcel, minus twice the 1m-padx 22moption.  If
              the 1m-fill 22moption is 1my 22mor 1mboth 22mthen the height of  the  slave  is
              expanded  to fill the width of the parcel, minus twice the 1m-pady0m
              option.

       [3]    The packer positions the slave over its parcel.  If the slave is
              smaller than the parcel then the 1m-anchor 22moption determines where
              in the parcel the slave will be placed.  If 1m-padx  22mor  1m-pady  22mis
              non-zero,  then the given amount of external padding will always
              be left between the slave and the edges of the parcel.

       Once a given slave has been packed, the area  of  its  parcel  is  sub-
       tracted  from  the cavity, leaving a smaller rectangular cavity for the
       next slave.  If a slave doesn't use all of its parcel, the unused space
       in  the  parcel  will  not be used by subsequent slaves.  If the cavity
       should become too small to meet the needs of a  slave  then  the  slave
       will  be  given  whatever  space  is left in the cavity.  If the cavity
       shrinks to zero size, then all remaining slaves  on  the  packing  list
       will  be unmapped from the screen until the master window becomes large
       enough to hold them again.


1mEXPANSION0m
       If a master window is so large that there will be extra space left over
       after  all of its slaves have been packed, then the extra space is dis-
       tributed uniformly among all of the slaves for which the 1m-expand 22moption
       is  set.   Extra  horizontal  space is distributed among the expandable
       slaves whose 1m-side 22mis 1mleft 22mor 1mright22m, and extra vertical space  is  dis-
       tributed among the expandable slaves whose 1m-side 22mis 1mtop 22mor 1mbottom22m.


1mGEOMETRY PROPAGATION0m
       The packer normally computes how large a master must be to just exactly
       meet the needs of its slaves, and  it  sets  the  requested  width  and
       height  of the master to these dimensions.  This causes geometry infor-
       mation to propagate up through a window hierarchy to a top-level window
       so  that  the entire sub-tree sizes itself to fit the needs of the leaf
       windows.  However, the 1mpack propagate 22mcommand may be used to  turn  off
       propagation  for  one or more masters.  If propagation is disabled then
       the packer will not set the requested width and height of  the  packer.
       This  may  be  useful  if, for example, you wish for a master window to
       have a fixed size that you specify.


1mRESTRICTIONS ON MASTER WINDOWS0m
       The master for each slave  must  either  be  the  slave's  parent  (the
       default)  or  a  descendant of the slave's parent.  This restriction is
       necessary to guarantee that the slave can be placed over  any  part  of
       its master that is visible without danger of the slave being clipped by
       its parent.


1mPACKING ORDER0m
       If the master for a slave is not its parent then  you  must  make  sure
       that the slave is higher in the stacking order than the master.  Other-
       wise the master will obscure the slave and it will  appear  as  if  the
       slave  hasn't  been packed correctly.  The easiest way to make sure the
       slave is higher than the master is to create the master  window  first:
       the most recently created window will be highest in the stacking order.
       Or, you can use the 1mraise 22mand 1mlower 22mcommands  to  change  the  stacking
       order of either the master or the slave.


1mKEYWORDS0m
