Re: [rfa/doc] Updates to gdbint.texinfo

Andrew Cagney
2001-07-04T11:25:00Z

>> + behavour.}
>
>
> There's a typo in the last word.

And I did use Ispell this time :-/

>> ! @end example
>> !
>> ! and not:
>> > + @example

>
> The "and not:" part above needs a @noindent before it.

Done.

>> + @subsection File Names
>> +
>> + Any file that is used to build @value{GDBN} on either DJGPP or Cygwin
>> + must be 8.3 compliant.
>
>
> I suggest to add here that file names which match but for the letter
> case will make trouble on DOS and Windows, even if long file names are
> supported.

I reworded it. It talks about the build process.

@subsection File Names

Any file used when building the core of @value{GDBN} must be in lower
case. Any file used when building the core of @value{GDBN} must be 8.3
unique. These requirements apply to both source and generated files.

@emph{Pragmatics: The core of @value{GDBN} must be buildable on many
platforms including DJGPP and MacOS/HFS. Every time an unfriendly file
is introduced to the build process both @file{Makefile.in} and
@file{configure.in} need to be modified accordingly. Compare the
convoluted conversion process needed to transform @file{COPYING} into
@file{copying.c} with the conversion needed to transform
@file{version.in} into @file{version.c}.}

Any file non 8.3 compliant file (that is not used when building the core
of @value{GDBN}) must be added to @file{gdb/config/djgpp/fnchange.lst}.

@emph{Pragmatics: This is clearly a compromise.}

When @value{GDBN} has a local version of a system header file (ex
@file{string.h}) the file name based on the POSIX header prefixed with
@file{gdb_} (@file{gdb_string.h}).

For other files @samp{-} is used as the separator.