Re: [rfa/doco] Srink the overlay diagram

[Andrew Cagney <ac131313 at cygnus dot com>]

> On Mon, 21 Jan 2002, Andrew Cagney wrote:
> 
> 
>> One of the things giving overfull hboxes is JimB's overlay diagram.  The 
>> attached patch srinks it a little.
>> 
>> ok?
> 
> 
> Yes, but:
> 
> 
>> ! To map an overlay, copy its code from the larger address space to the
>> ! instruction address space.  Since the overlays shown here all use the
>> ! same mapped address, only one may be mapped at a time.
>> @end group
>> @end example
> 
> 
> Why is this text inside the @example?  If that's because of the desire
> to have the text always follow the diagram, I don't see anything that
> would prevent us from using @need instead of @group.  Am I missing
> something?


I don't know.  I just work here :-)

I think the @group is needed around the actual diagram, I don't know 
about the accompanying text.


> In general, it's bad to have free text inside @example, since TeX
> doesn't fill such text.  So typesetting that is prone to unexpected
> problems whenever you change the output dimensions slightly (e.g.,
> with @smallbook etc.).  It's best to avoid that entirely.


What do you suggest? :-)

Andrew