This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
Re: [rfa/doco] Srink the overlay diagram
- From: Andrew Cagney <ac131313 at cygnus dot com>
- To: Eli Zaretskii <eliz at is dot elta dot co dot il>
- Cc: gdb-patches at sources dot redhat dot com
- Date: Mon, 21 Jan 2002 14:45:56 -0500
- Subject: Re: [rfa/doco] Srink the overlay diagram
- References: <Pine.SUN.3.91.1020121115741.16755L-100000@is>
> 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