From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 45589 invoked by alias); 12 Apr 2017 20:10:31 -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 45511 invoked by uid 89); 12 Apr 2017 20:10:30 -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,SPF_PASS autolearn=ham version=3.3.2 spammy=bite, claim X-HELO: sesbmg23.ericsson.net Received: from sesbmg23.ericsson.net (HELO sesbmg23.ericsson.net) (193.180.251.37) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 12 Apr 2017 20:10:28 +0000 Received: from ESESSHC024.ericsson.se (Unknown_Domain [153.88.183.90]) by (Symantec Mail Security) with SMTP id 02.B2.27378.3B98EE85; Wed, 12 Apr 2017 22:10:27 +0200 (CEST) Received: from EUR01-VE1-obe.outbound.protection.outlook.com (153.88.183.145) by oa.msg.ericsson.com (153.88.183.90) with Microsoft SMTP Server (TLS) id 14.3.339.0; Wed, 12 Apr 2017 22:09:51 +0200 Authentication-Results: sourceware.org; dkim=none (message not signed) header.d=none;sourceware.org; dmarc=none action=none header.from=ericsson.com; Received: from [142.133.50.178] (192.75.88.130) by HE1PR07MB1722.eurprd07.prod.outlook.com (10.166.124.152) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1034.5; Wed, 12 Apr 2017 20:09:48 +0000 Subject: Re: [PATCH 2/2] doc: Improve documentation about MI thread output To: Eli Zaretskii References: <20170412180610.2565-1-simon.marchi@ericsson.com> <20170412180610.2565-2-simon.marchi@ericsson.com> <83y3v5igdx.fsf@gnu.org> <83tw5tifpq.fsf@gnu.org> CC: From: Simon Marchi Message-ID: Date: Wed, 12 Apr 2017 20:10:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 In-Reply-To: <83tw5tifpq.fsf@gnu.org> Content-Type: text/plain; charset="windows-1252" Content-Transfer-Encoding: 7bit X-ClientProxiedBy: MWHPR10CA0009.namprd10.prod.outlook.com (10.172.48.19) To HE1PR07MB1722.eurprd07.prod.outlook.com (10.166.124.152) X-MS-Office365-Filtering-Correlation-Id: 7a8e3a61-48db-4908-d9e2-08d481dfdfa5 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(22001)(201703131423075)(201703031133081);SRVR:HE1PR07MB1722; X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1722;3:5e5SDyp22snsrF3OdZjEOgiDhiQXbY7rWnfHn7sBy+DK0wunDmXWj+KxNXGAw+TsGBmwXxdPucTUBGEdGCymTYz8eUV9zlbyWMf9AdNYwdGNsN+ySSm2YqykKxVD6YuiJ55hoxXj3XUnWh1ej0xW28lDl6mW2oAyeAVTUF2Y/y9GONmvfMardIWtZ57hA57UqAq2Woia404JOT8GYLRbX1JD0XYy46KOkzF1uSIGMs0d4v596XP25mUB2GM2NZVsw5OCq7Ovk/uMPuzzL10z94BJxBgVWtBJdDlv0c4Vs08nU9eJ9PumBUeZe32mpqA70VESa/nGgu5eMnkZyHF5NQ==;25:RZZuLl8QaeGjEE0j47J0mDyGq5r2Iv8v4pjzlEjjzWLSCgM0WChjqnPp7pW71FeTM+LDwsKQVdL+VnESxN/Yi/BI0lmkfBHwFNKTr8r3V6TjNiW9OhWJP8ETxTFutINq+eW7XgPMoyUvZjtFiqZs+40ic2U4rgkJF275SkNyj4XXlCgoswx6p9bukpSxXeRSYy9Yt2GI+LFVoWblo2XASTkwn7lo6nCedLTKb4lJiqiZUx4qM1TiXL8KQTtqLojDX8yU1oagYMKSWxNtxryMz5YRSh7D0v8dS0Ie/5c9DezInfF8uWagva5An659L50GBaIgNlUDtCB1DRYsobaHTrFwmlk5sOP4uIrgWZ7doF3+iKjVS46/dmxlcHlcE9RGDnd+It9wUcK6E/5jsx4yEKGzVHU9KCy1Ac3eC/BUJp7XWScViQmsV/kQ9OKiaolusbGGg9a1LL2pkZ0XRhw69/eu8o7F+vkTqSPDk4noLho= X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1722;31:cjnjP+EDq49LjVR9ZrmJsJrP6ZLevLy0kJAj0d1M48wArWlgvjEUmP+fJExCEjGzKXxDfhjs3PX1OE+5xx2v5YcIbfD4qm6MzSeTp6woY7u0HjWSbxRi7vQlWCEPDDW6nfdFI3/uBbHkvgU4WGKaKDovwvhdQjava51mJ52dwmcUW82j/DU4Agp8VEkrDBqENJNMNiZ3iU0fFbhhN6MRwOoTXiG1ZLIv8ZPQK94sQSRvdCQmIwBwCwk3eMLFhzW6aXzXyrUn/813dZSsb0Eztg==;20:tGiikeOku1skL0Ci2mTRD8WsqgYmXBEKMHMVrDsvX414q/XdpejSM97qMC80hvlGUeWs09zkb9LgqawoHqnvYNTAaXEAIOq/si7DO30MqK2aZVp13sSYCr3NfYI+i60wLFYX6/kj9hcdEqLEsYNbcJbARCVP/u28WPzXqga36SMfdyJY2GQQ/zvl0150MqvhSX6Rfs0KxBziL52QsWK8XZ0MoAYCQD+1ddj94c7Kb01OT5rq9eL7S00PQ/XodKVKML3VvTlrd6mfWIbyRsREghL8bgAhSMDYZl3V6FQLOOk6dQ8ow1l/CP0UTs2a5enG3+9vb1GGNutXDsCzeFCw16n2WE6spnUp0+UUoW8m4Xr8ijGLQkeGxhhirYKartuG36f92RfEa6Qh2E9xtzJKEN9JRFceTQQ1DbUp/8GHQVedDYJAyvGCfOcp75lA3iI+D2VkRk/WOSdpf0sI7RJkDndWXdtmkDqo0wKug6AqdssTOne1wz4PHaa9jWQLu7S4 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(37575265505322); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040450)(601004)(2401047)(8121501046)(5005006)(93006095)(93001095)(10201501046)(3002001)(6041248)(201703131423075)(201702281528075)(201703061421075)(20161123564025)(20161123555025)(20161123562025)(20161123560025)(6072148);SRVR:HE1PR07MB1722;BCL:0;PCL:0;RULEID:;SRVR:HE1PR07MB1722; X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1722;4:SwI9O47yh8fyn3rvylEmIU/2ECfjcoXCC/Nq4xGD5U5Z/Le/oIr2zDvhd3jsDp1grPF8WqiZbFWNnRYEq6RL7fk29YfbDJZ6zGA/iuGCR/OeClXrXZR43lTKHTMvhfZ+ubvZ+6GeBy9kf5Ih0lFjbYfqxV3yyCovq3UTUoFOdtwM4LMB8+vMrOQZcKb4vLfnxu0GxW4LOaXgnaMTVj9AX01+FofOC/+KVo+0que0SxnRLqPtPvYs61XO33Hk8ELMitwRIJbLiuu/rgdrURqU1odB6KK6q3cpqOU0iUC4HGsi+o7PlU8+Kml9w933xnxU1G5LGhfmNyCp6DeUMeZ/qxJU6DBL9WYyT4NniicXPPwZhJ/fk9K1wt3xcjqMV2ucrhL+fzsCMhfw1QWsqP2CktBBGUiroUBKxLW4P68qyd8AqJ9lJOLDJ70AXzTa7HeSE9wEoEId/xpps2pCCgTvs8RUChZ3Hlm/12D2QCuzaF77g3eTnhiRhbH1OOGRp3tWRGyXS+3rV6IfZ+rQV+qeUnQM8iU3bwlqMRq8lyuPI9be+SFFdEu/A9jTLJ2zN8tQnAkP/q2rugsiIxun/TOJBRyh60hiG479F5xx1Z+xyuGEc9Z+XxkDFhWr4y/h5rgzsRVrIjPkBKVhOH1F/hms/ukkEnF3xam+SA1NNwLNzg6Qo6f8MRi0MPHVikPRrLTy9w2BprASJIYXZ3KEARoCoO/iCswddDoHbyCP1w7tCzyos4/4EJZifK10mDISUsPbRgJ/ZGN7spmAErbBNVVjSA== X-Forefront-PRVS: 027578BB13 X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10009020)(4630300001)(6049001)(6009001)(39840400002)(39450400003)(39860400002)(39400400002)(39410400002)(39850400002)(377454003)(377424004)(24454002)(83506001)(189998001)(65806001)(2906002)(86362001)(36756003)(66066001)(65956001)(230700001)(110136004)(6116002)(3846002)(305945005)(5660300001)(47776003)(38730400002)(2950100002)(42186005)(50466002)(31686004)(25786009)(33646002)(4001350100001)(53936002)(31696002)(23746002)(6246003)(81166006)(8676002)(93886004)(6666003)(6486002)(53546009)(64126003)(4326008)(90366009)(6916009)(76176999)(54356999)(229853002)(50986999)(78286005);DIR:OUT;SFP:1101;SCL:1;SRVR:HE1PR07MB1722;H:[142.133.50.178];FPR:;SPF:None;MLV:sfv;LANG:en; X-Microsoft-Exchange-Diagnostics: =?Windows-1252?Q?1;HE1PR07MB1722;23:zArZgGMPfkjnVNDKtkfsuFOeuo/q97LCOMlte?= =?Windows-1252?Q?qs0ZCaqsgcuGEvQyMI6Cmw90r94JQ1a6YP8kQyZWqBNKWuqBPoL6i2/8?= =?Windows-1252?Q?VSy8NRX/U9IzpaEt/xWBUYtoN6Rk5YoDYzIqrRvobBFz3zl5Cn7MDjWE?= =?Windows-1252?Q?6oaQoy8BaUyH7q6INRmFKkoy/1snUU3jXu3a1qdv3HOFRXGwi/TtRDK5?= =?Windows-1252?Q?/vHHgxYqfQYoN38Piz2Pv6L8nZuNDpfen8Gt+7epYNPfiyWtMV2uo1F4?= =?Windows-1252?Q?m16xlliIEkQKbpYTQgTEKe0dg4isExSKmCc7yFNOaErmtKTCPJZCu43A?= =?Windows-1252?Q?vq0bQrloscRtVcodOhEAnM5zIVVQd+S8Q9tsXHk/SXQj3aWTZL2R6co3?= =?Windows-1252?Q?5N02a7ZfNtJ1l/ly9sCQT9sLdJ/8VWx//qSQA+N60M14D7Ltht6kCTXf?= =?Windows-1252?Q?OwDcFsR9CKe43amy8gd61zX7OGLulaLL+SV9G0QwkxrtTK9/CBHPs3Ot?= =?Windows-1252?Q?ntWn3Tur0CwqgUiBj29Kjo3Z9F4QUnYBuO9NnbFwuFggJrt+PmiXiON9?= =?Windows-1252?Q?DIjN8Pfa8ELENpBt8cLQEbk+HuCjlo7UviJzm79laawdT/lAtkVPLeDn?= =?Windows-1252?Q?oYAfIbVzBI53BdSg00g+mWGwLJOvjLYhy+8DCiRpDBLnNFIh502mwzvW?= =?Windows-1252?Q?KnmOkRGS1gLja/srspRILGCWVecnOHKDLZyoAaQ/920tWAvW+m0Ya3Xl?= =?Windows-1252?Q?Odsm4TU2sC1xwKHCbVWAHMXIOJrxbvRnQ9IdG+RLJlc+YXNazXL9J08O?= =?Windows-1252?Q?LMNM8wPCz8vOYytBNTZXuKtQij1849salso2Ria/CNJzp4EzOGfSQkyo?= =?Windows-1252?Q?fJnci1cWZiOEU+/TfMWOVlWXHTeW5NdmzTcm2CFjw2X+8u1jI4buk4Jl?= =?Windows-1252?Q?vyHTpAwhhm4wStpkzZ1nJh7e2l5ETYH0QwAR+nDSipPWhWe3GwU8NYez?= =?Windows-1252?Q?ODFD/UEG//IpaQrbGYqkM3+M/xYJC6mRnj8Bg2bl0ybSG/BUvfVmCfDt?= =?Windows-1252?Q?EQQxGvWbfAeknqh40qdSUnRARCzRF1vlVBqFW/vJtC9sszw1Haknpxo0?= =?Windows-1252?Q?mwqqVyWPAxZRy+jFle5fP77RLSGYkSfoxGqy5iS9ga3Q7xy4OPQhvhHD?= =?Windows-1252?Q?x/v3oc+vTb5yZ/vbXUb/VlucSnpWDDMdwZHppCId+pBp5YLVg/y5VZIn?= =?Windows-1252?Q?ZyfgIz0+0fjCjUrVtnPI0WzVKJqGsv7vF3MkvfXSx9q86L+GJXJHZOZc?= =?Windows-1252?Q?NzkkQKHR4aEfwvYdJnwMo8jfe+EyT6lT3uA4/VuarctiwnJYjYHxz8YH?= =?Windows-1252?Q?CLvEq8WWDEUFOdnG1GgwlxQ32sC3VW3uEz0ZRwHo2FAhGpt5GXocu3FH?= =?Windows-1252?Q?XiBASxmPEesm8obkKW4?= X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1722;6:enWiZsRpKMI2Q+6F9WASiSQmOvfN8hjrd2OpUBfkN6/RabRX3VZ5savTIl5zZ0+VEvtjimbDHelJzbnlupQORk+Qg88A1kZjDIpvZSRvdZ0NR176+TuKU4UsDG1ziH3rrIJLZOJPGCt+in8UzkgM707niNCizkVujW1Q2j6ZTThg9ERhosDpcFO/v7PYmyq68RkY63tlGVGnVXluBVM5Qd4gzTbA9VFf6XAykmBH88SXg0BcbMpJAri0Puxf8hml6j/uI2+qSLFPWOPJCbskRDFe2Tp4vFgHGRuSOVFC0dlCFabWJbdUvsNwMuFlIk5SYU7Tb35r4VWMaodblKSJE1j5RPD8Zb0TOaGhrBc/v2nKJZZCBMINhNvgpQ7pUUGLe+k6b1QBYI4M9PBMZWTtVyo/iE711uL8pLa6kFPzOFcNEaWXlNe/U403QPpaKpMlkXhL+qyBUQ5nQmhmdYpO4Q==;5:CjDC6ADOyXZs6t+ZP2X7dZvUtKbsJRh90y9LyiCvkLvxUtG1GydlpjQbJ7JGtX1Gq2wozwzHjNZZGMIAdLPN0YCD4FE8lRAO3U/1ud6o8wTzW+uVcoySY6VPIxn0yym98uuXeaxojEgjvmGUR2PAwg==;24:jaxQxQSX96mFy5uRZafJsUbpAJB5nQgHKg16/LxGfCR8bGoCqmjkZW57qED2g+1FZOwPAolgaHQNG/rcq7fHHqVY1y4pFH3n+Qr58sACtuU= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1722;7:qOhTPeAQRXxr/ZCFDy+JIDvtZioQGnYPDO+Hg4+nxHBva3jzAIzeBFUoTTDzmosJD+XWp0vn3rU+7un/kYLMPib7ILf02cRIGQJsfEr5Iy6Tb/sNe26h/A7aQYpIF0k6qS42T8vVvNPCGtfBzz1S7Psca6pZt9atsoAe9+GyQIif87+qohSyfPVWQfrBYGG+i95PkfxuKLVKL9z6C0Cv99Oc0HMZDAgyTteP+b59P66Az5w0vuK4znWdh0n/PmJAm51N5owX6KV6c69e+c0eW6LeH3lnHSkZmQaAl+E0zkobTGJGsG3bzeWsUsB6dnnU33hVvrVej1qc4z60CYUXqw== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Apr 2017 20:09:48.5912 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR07MB1722 X-OriginatorOrg: ericsson.com X-IsSubscribed: yes X-SW-Source: 2017-04/txt/msg00369.txt.bz2 On 17-04-12 03:33 PM, Eli Zaretskii wrote: >> From: Simon Marchi >> Date: Wed, 12 Apr 2017 15:26:08 -0400 >> >>>> +there is a selected thread and no @var{thread-id} argument was passed to the >>> >>> How can there not be a selected thread? >> >> When the currently selected inferior is not running. The obvious case is the initial >> state of gdb. But it's also possible to have threads but none is selected, for example >> when you add a second inferior and switch to it, while the first inferior is running. >> >> The field is output if inferior_ptid != null_ptid, so maybe there are other situations >> I am not aware of where there isn't a current thread. > > I think we need to describe at least the most "popular" situations > where this happens. The initial state of GDB is not an interesting > case, but others are. In particular, IMO it would be good to state > that when there's only one inferior being debugged that has been run > already, there will always be a selected thread. I agree that we could give an example of situation where there _isn't_ a selected thread. Readers may, like you did, find that it's an odd claim and wonder how it's possible that there isn't a selected thread. But I don't think it's useful (and maybe even counterproductive) to try to define some situation where the field will always be present. The important thing that users of this API need to know is that the field may not be there. This will encourage them to program defensively and check whether the field is present before trying to use it. If we try to define a green zone where the field is supposedly always be present, it will incite some people to skip the check, which will potentially come back and bite them if the behavior of GDB changes or there's a situation we haven't thought of where it can happen. Simon