Re: [RFA]: File-I/O patch, Documentation

[Andrew Cagney <ac131313 at redhat dot com>]

[added Eli]

> On Sat, Mar 01, 2003 at 09:58:44PM -0500, Andrew Cagney wrote:
>
> > Well the texinfo.  I read the reference as a reference to something 
> > completly separate.
> >
> > Can you please expand the paragraph to reference: Protocol specific 
> > representation of datatypes.
>
>
> Uhm... sorry but is it possible that you didn't read the texinfo file
> created by my patch send the week before but instead the one from
> December?  I just looked through the doc and I was a bit surprised
> to see that there isn't any reference to B.1 but instead there's
> already a "(see @ref{Integral datatypes}, for details)" in it.

Yes.  I'm having a `bad hair' day :-(

> I've attached the new version of my patch with the following changes:
>
> - Using M packets for memory transfer is redefined so that the target
>   should expect M or X packets.  The current implementation (my patch)
>   uses only X packets so far.  I forgot that in the original document.
>
> - The "Integral datatypes" chapter contains a hint that these datatypes
>   are passed as big endian when part of a memory transfer of a compound
>   type.
>
> - The "Integral datatypes" chapter defines time_t as seconds since Epoch.
>
> - A new "File-I/O Examples" chapter.

I just tried to build a pdf file using this patch and it died with:

(/usr/share/texmf/pdftex/plain/misc/pdfcolor.tex) fonts, page headings,
tables, conditionals, indexing, sectioning, toc, environments, defuns, 
macros,
cross references, (/usr/share/texmf/tex/plain/dvips/epsf.tex) localization,
and turning on texinfo input format.) (./gdb.aux
! Missing @endcsname inserted.
<to be read again>
                   @
<argument> The `F@
                   request packet-title
@xrdef  dot  dot  dot  at endgroup @expandafter @gdef @csname X#1
                                                  @endcsname
l.862 'xrdef {The `F' request packet-title}
                                           {The \code {F} request packet}
?

Changing the line:

	@subsection The @code{F} request packet

(and a second very similar in a similar way) to:

	@subsection The `F' request packet

fixed the problem.  This has me totally puzzled since other @subsection 
lines use @..{} and work fine.

Eli?

Andrew

PS: pdftex on a RHAT 7.2 system.