X-Authentication-Warning: delorie.com: mail set sender to djgpp-workers-bounces using -f
Date: Mon, 10 Nov 2003 13:55:08 +0200 (EET)
From: Esa A E Peuha <peuha AT cc DOT helsinki DOT fi>
Sender: peuha AT sirppi DOT helsinki DOT fi
To: DJGPP workers <djgpp-workers AT delorie DOT com>
Subject: Re: djgpp: djgpp/src/libc/go32/makefile,overflow.S
In-Reply-To: <3FACDD1E.4950D38B@phekda.freeserve.co.uk>
Message-ID: <Pine.OSF.4.58.0311101328470.17387@sirppi.helsinki.fi>
References: <200311070952 DOT hA79qp0D028636 AT delorie DOT com> <3FACDD1E DOT 4950D38B AT phekda DOT freeserve DOT co DOT uk>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

On Sat, 8 Nov 2003, Richard Dawe wrote:

> Could you put some text at the start of this file, explaining what its purpose
> is, please?

Would it be enough to describe this in overflow.txh instead?  Something
like this:

@c ----------------------------------------------------------------------
@node Stack overflow handler, signal
@vindex __djgpp_stack_overflow_eip
@findex __djgpp_stack_overflow_exit
@subheading Syntax

@example
unsigned int __djgpp_stack_overflow_eip;
void __djgpp_stack_overflow_exit(void);
@end example

@subheading Description

This is the stack overflow handler, intended to be used only by
compiler-generated code.  This will exit with suitable error message.

@subheading Return Value

This function does not return.

@subheading Portability

@portability !ansi, !posix


> Perhaps we need an entry in "What's Changed" too. Perhaps we don't, since gcc
> doesn't use this functionality yet. I'm not sure. Esa, what do you think?

I think we should document what we have, whether it's used or not.

Index: wc204.txi
===================================================================
RCS file: /cvs/djgpp/djgpp/src/docs/kb/wc204.txi,v
retrieving revision 1.162
diff -c -r1.162 wc204.txi
*** wc204.txi	8 Nov 2003 12:19:40 -0000	1.162
--- wc204.txi	10 Nov 2003 11:52:10 -0000
***************
*** 1032,1034 ****
--- 1032,1038 ----
  @code{strftime} now uses the date format (for @code{%x})
  and time format (for @code{%X}) from the current locale.
  This means that @code{%T} and @code{%X} are no longer equivalent.
+
+ @vindex __djgpp_stack_overflow_eip AT r{ added}
+ @findex __djgpp_stack_overflow_exit AT r{ added}
+ The stack overflow handler was added.


-- 
Esa Peuha
student of mathematics at the University of Helsinki
http://www.helsinki.fi/~peuha/