figures and tables

[Jeff Kingston]

Please let me have your comments on the following.  It isn't
implemented yet, but I'm pretty sure I know how to do it.

Jeff Kingston
address@hidden
============================================================


                          Location of figures

     The @Figure  symbol has a @Location  option which determines
     where the figure will appear.  Its possible values are

          PageTop       The  figure  will appear  at  the top  of
                        the  following  page,  or,  if  there  is
                        insufficient   space   there  (owing   to
                        other  figures already  present), at  the
                        top  of  the first  subsequent page  with
                        sufficient space.

          PageFoot      The  figure   will  appear  at  the  foot
                        of  the  current page,  or,  if there  is
                        insufficient  space  there,  at  the  top
                        of  the following page  and so on  as for
                        PageTop.

          PageEnd       The  figure  will appear  at  the top  of
                        a  page at  the end  of the  document (or
                        chapter,  appendix  etc. in  the case  of
                        books).

          ColTop        As  for   PageTop,  replacing  `page'  by
                        `column'.

          ColFoot       As  for  PageFoot,  replacing  `page'  by
                        `column'.

          ColEnd        The  figure will  appear in  a column  at
                        the  end  of  the document  (or  chapter,
                        appendix etc. in the case of books).

          Display       The  figure will appear  as a  display at
                        the point it occurs.

          AfterLine     The  figure  will  appear  as  a  display
                        immediately  after the line in  the final
                        printed document in which it occurs.

          TryAfterLine  Preferably   AfterLine,   but  if   there
                        is  insufficient  space  in  the  current
                        column, use ColTop instead.

          Raw           The  figure  will  appear as  an  object,
                        with  no extra spacing,  at the  point it
                        occurs.   This  is  useful, for  example,
                        for  getting  two  figures side  by  side
                        in  one display:   use a  displayed table
                        containing two raw figures.

     The  @Table  symbol  also  has  this  option.   The  default
     location is PageTop, but this can be changed by changing the
     @FigureLocation and @TableLocation setup file options.

          The numbers  assigned to figures and  tables, and their
     ordering in any list of figures or tables, is based on where
     they appear in the final printed document, not on where they
     appear in the  source files.  This is better  for the reader
     in the unusual  case of a fixed figure being  overtaken by a
     floating one.