From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26438 invoked by alias); 18 Sep 2014 09:59:16 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 26412 invoked by uid 89); 18 Sep 2014 09:59:15 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.5 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.2 X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-GCM-SHA384 encrypted) ESMTPS; Thu, 18 Sep 2014 09:59:14 +0000 Received: from int-mx10.intmail.prod.int.phx2.redhat.com (int-mx10.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id s8I9xBxu013597 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 18 Sep 2014 05:59:11 -0400 Received: from blade.nx (ovpn-116-121.ams2.redhat.com [10.36.116.121]) by int-mx10.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id s8I9xAbn011841; Thu, 18 Sep 2014 05:59:11 -0400 Received: from blade.nx (localhost [127.0.0.1]) by blade.nx (Postfix) with ESMTP id 6530C2640D8; Thu, 18 Sep 2014 10:59:10 +0100 (BST) From: Gary Benson To: gdb-patches@sourceware.org Cc: Pedro Alves , Doug Evans Subject: [PATCH 2/3] Update target_stop's documentation Date: Thu, 18 Sep 2014 09:59:00 -0000 Message-Id: <1411034346-868-3-git-send-email-gbenson@redhat.com> In-Reply-To: <1411034346-868-1-git-send-email-gbenson@redhat.com> References: <1411034346-868-1-git-send-email-gbenson@redhat.com> X-IsSubscribed: yes X-SW-Source: 2014-09/txt/msg00614.txt.bz2 This commit updates target_stop's documentation to clarify that it is asynchronous. gdb/ChangeLog: * target.c (target_stop): Updated comment. --- gdb/ChangeLog | 4 ++++ gdb/target.h | 6 ++++-- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/gdb/target.h b/gdb/target.h index 2ea7a2d..24fb757 100644 --- a/gdb/target.h +++ b/gdb/target.h @@ -1573,8 +1573,10 @@ extern int target_thread_alive (ptid_t ptid); extern void target_find_new_threads (void); /* Make target stop in a continuable fashion. (For instance, under - Unix, this should act like SIGSTOP). This function is normally - used by GUIs to implement a stop button. */ + Unix, this should act like SIGSTOP). Note that this function is + asynchronous: it does not wait for the target to become stopped + before returning. If this is the behaviour you want please use + target_stop_and_wait. */ extern void target_stop (ptid_t ptid); -- 1.7.1