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

[Andrew Cagney <ac131313 at cygnus dot com>]

>> + 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.