From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-28210-listarch-gdb-patches=sources.redhat.com@sources.redhat.com>
Received: (qmail 9183 invoked by alias); 26 Oct 2003 17:35:54 -0000
Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sources.redhat.com>
List-Archive: <http://sources.redhat.com/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sources.redhat.com>
List-Help: <mailto:gdb-patches-help@sources.redhat.com>, <http://sources.redhat.com/ml/#faqs>
Sender: gdb-patches-owner@sources.redhat.com
Received: (qmail 9176 invoked from network); 26 Oct 2003 17:35:53 -0000
Received: from unknown (HELO gollum.inter.net.il) (192.114.186.22)
  by sources.redhat.com with SMTP; 26 Oct 2003 17:35:53 -0000
Received: from zaretski ([80.230.156.233])
	by gollum.inter.net.il (Mirapoint Messaging Server MOS 3.3.7-GR)
	with ESMTP id BRX89570;
	Sun, 26 Oct 2003 19:35:39 +0200 (IST)
Date: Sun, 26 Oct 2003 17:35:00 -0000
From: "Eli Zaretskii" <eliz@elta.co.il>
To: Michael Elizabeth Chastain <mec@shout.net>
Message-Id: <1659-Sun26Oct2003193033+0200-eliz@elta.co.il>
CC: gdb-patches@sources.redhat.com, drow@mvista.com
In-reply-to: <200310261459.h9QExPlc022980@duracef.shout.net> (message from
	Michael Elizabeth Chastain on Sun, 26 Oct 2003 09:59:25 -0500)
Subject: Re: [rfa/doc/threads] thread breakpoints and system calls
Reply-to: Eli Zaretskii <eliz@elta.co.il>
References:  <200310261459.h9QExPlc022980@duracef.shout.net>
X-SW-Source: 2003-10/txt/msg00771.txt.bz2

> Date: Sun, 26 Oct 2003 09:59:25 -0500
> From: Michael Elizabeth Chastain <mec@shout.net>
> 
> Looking for approval from a thread guy such as Daniel J for content,
> and Eli Z for syntax.

Approved, with one gotcha: the GNU project standards discourage the
use of ``illegal'' for anything other than actions that break the law.
So I would rewrite the following sentence:

> + It is legal behavior for a system call to return early, so @value{GDBN}
> + does not cause your program to behave illegally.

like this:

  It is perfectly okay for a system call to return early, so @value{GDBN}
  does not cause your problem to behave erratically.

I would also suggest to add that the early return is due to a signal
(SIGTRAP, right?) caused by the breaking breakpoint.  This will help
programmers who know that a system call can return early due to a
signal to understand better what's going on.

Thanks.