From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 114368 invoked by alias); 12 Apr 2017 21:13:06 -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 114353 invoked by uid 89); 12 Apr 2017 21:13:06 -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=claim X-HELO: sessmg23.ericsson.net Received: from sessmg23.ericsson.net (HELO sessmg23.ericsson.net) (193.180.251.45) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 12 Apr 2017 21:13:04 +0000 Received: from ESESSHC024.ericsson.se (Unknown_Domain [153.88.183.90]) by (Symantec Mail Security) with SMTP id A9.6D.19549.0689EE85; Wed, 12 Apr 2017 23:13:04 +0200 (CEST) Received: from EUR01-DB5-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 23:12:17 +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 HE1PR07MB1724.eurprd07.prod.outlook.com (10.166.124.154) 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 21:12:13 +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> <83o9w1icug.fsf@gnu.org> CC: From: Simon Marchi Message-ID: Date: Wed, 12 Apr 2017 21:13: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: <83o9w1icug.fsf@gnu.org> Content-Type: text/plain; charset="windows-1252" Content-Transfer-Encoding: 7bit X-ClientProxiedBy: DM5PR18CA0044.namprd18.prod.outlook.com (10.173.208.30) To HE1PR07MB1724.eurprd07.prod.outlook.com (10.166.124.154) X-MS-Office365-Filtering-Correlation-Id: ac1fd036-65f5-427f-c21a-08d481e897dd X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(22001)(201703131423075)(201703031133081);SRVR:HE1PR07MB1724; X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1724;3:ak6cn2wWeCItL63P1aGgY/KVBgclwXAXK5nM5y/PvaGjv0lnmlQGo0F/kvaKWAgzqv+fSTs/Vpn+dWXZ+xe2bh3fVJ+STL0qWh6Hg5imPY0BEVotDzdcmsnhfwTcVeQjTy+ntGSAzjJeXKNSQa0Lbm4qCjnHEaKMayRRdujP6XY+LURVwCxqiW8p1AAPcv9zi+bBvUn4C/STZsTr4HvHmSIhw/RC2LlTMGWiSvw94601rYz0Z7pIIgO+bbNQVJD8Xqi583Pk6SFs524EZlUHChKgeO9lY9dHrCeNRGlq31sfOp3P32dn+78uPOaCPac2pytz91TSIIEy6QoriZGP0A==;25:ktcdMmpBb25SiGTSOwIr+KOym+FssOJR8L+YE1GlvpRl2fZh7EQJ+FHQnWNgjsNxHOeyXZ4xV3Wd4LvLf/OsAexJlrNXX5rrUIx926fk3oP8inXH+hIEE041rO1S/2yiJYuaz1tU7wQUpgG50hHSdH29pgw2hD3VZBJIoZqIfTTwusdCg51WG/OTO9bUy/x8if46YqFQexcZ53dzTaBi7sRs0a/VFSLSZEjEe8tiNy0HMt+1BOEi75UFLvlA0d+phZZBK1pPbGOo+2YSsqodd4PQ+UObGUE4+2dynyNIGTxFoZUIU78V2hl57hVCYYkYtuA5Tl9509C2gi/kOU2mSbA8taiFD4bcA2xVojxkZ8EsfRYlPlhJk73YRAKwtc8c0EKsBXlmt1dT/hYgXU5tgsXcngdmZ+6p0JFWX91q9yCh6zsrx9ELxz3jPrU/XuKgCsVwkQbaUu0+9O4JygZ0647j7m3Pj0STWgtUut7oe5Y= X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1724;31:2T+P0F0I8QG/dV8omYdtfhmCEPTZECJnn+Ik6uVJ3hsxsshjwQAsV+I3OKzrpMopb2JBgJNEXjlFoi6WrQOlE+oZqUpQaHF5eKOgmF3rbh3XCAqZB9+37eE8XiHPG1eSKhYHOBqCukZf48jNfT50DmLn42zHV8YJKIkTFEycxvNBbaP55ncr9J7cJh0xhsJmJXVMwbNso4t9Xa/8voKanUAmMX3X34V16kJcJrKhUvwEJImYUadUYU4PtBKDDUQrjbu4GLzcciOrSr6M/y6NFA==;20:AO7M+vS0bkWtEnwma/taKEEmPvdXK+7wMQvDoZAXI4DeP65ZTL3OyauT1xaqDRiepR46XIarbrdJZBvmrYIxYrtt688PVGtfY8vAPKB5NDu2pqqbDgZGSNgfp3jSqGnUHgjNa7VQYu9b3t8MWGdXtswSwZ0AsoAWi+vM/1p858M44FnMNlUJjWtcx3hv+TfmE+RLd72+FSoR94BHhL24ABuzBAC13cWRTzL12C8vH5Tg82OTruqI8qa16p/LTsaB9nJwGuTMpIQB1mpfOBcAk2zWXwBYBeMGkZZ1BvIuhV118x+PpKqqst45Gy4dm2UGZa4Gsve6viUBfT7oovIlIxSbBFBA1Fs7MID39iIwddGRQgld2aN6cct7i0cgie0sDx4OGbp4ARu7qByKpGWBM0QyXCdi0Xom6GN3JMtLjtJngDdzLDP6RLgOBOnke1dO62FD12H3Oa9H751312/POuLdufT1B9pJUCVQtSOVr7SJnsyh3sddBzwbicY9M1jO X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040450)(601004)(2401047)(8121501046)(5005006)(93006095)(93001095)(10201501046)(3002001)(6041248)(201703131423075)(201702281528075)(201703061421075)(20161123562025)(20161123555025)(20161123560025)(20161123564025)(6072148);SRVR:HE1PR07MB1724;BCL:0;PCL:0;RULEID:;SRVR:HE1PR07MB1724; X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1724;4:si4aUwzXeC8v1zaaGDQwvxCeaATwpqm9DW+PRNwbgW3q2YO3lR0VVgBsFkjeuygzjs4JXqE8+fHWnND8jnBvNY3CWh21BsKBStUT79UY32oQstd2m+zBZpvy0BoAB/xHk6DLe1puJA4nfETuE7UaOwRKPaLgcJ2SmlKaladDX2CdHJ/4wDvwtoOO1IYnpJiQzFYOih02KNNcFNktP44ZHv9kyX9LMLe3Qi1GQrq0i/TlO0BWeZgJmyCyNuId48hLtXxNSfr7M3iuqwxjsQc6yCtJsP/2dBPSfDjS9uwzfL15f8iNSagc1Gi60yhoNKFBkVAm9vZYNkYH8SYvAnQDNGkasGnBlzGnfbdEqP7voeTIiCwEvhxD/eCGy1SGh68Zj5ObXzcWIAhwYrLnGuF9mS5cTxalWaU4u0+omrEnk4YwqoD6xdzHk+whrD/YMY3AsiHi5MMcmJAgBl4LaW+KrIixKH4/tqEQK2sBf2F/rtxX6sWacEIKloNRwjTN7dR5uqeXeU8GbC0vFRODigogQXjgiSEMFDhJj027+7JLGp6GSvfYHN7c0pz2ZUo86vxUindnpKDUaO1EoQOfzE/9jGdwFBSxJg24TZfcUlOMLlpnmWxA5ZjZQ+WubonBPzGsIlSe5Ex5D9xrGRtmU9sMuPQy5PcOW9LzFzKf/Inu7GO05N6B0gGrZ4rPlP3PAo2lA0rE33/YZKqndS1z/sP/qg== X-Forefront-PRVS: 027578BB13 X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10009020)(4630300001)(6049001)(6009001)(39850400002)(39450400003)(39400400002)(39410400002)(39840400002)(39860400002)(24454002)(76104003)(377424004)(377454003)(50466002)(23746002)(81166006)(42186005)(8676002)(53936002)(50986999)(53546009)(4001350100001)(6246003)(36756003)(86362001)(189998001)(25786009)(31686004)(90366009)(47776003)(6666003)(76176999)(2950100002)(6486002)(33646002)(54356999)(229853002)(31696002)(3846002)(6916009)(230700001)(93886004)(65956001)(4326008)(305945005)(6116002)(83506001)(64126003)(66066001)(65806001)(110136004)(2906002)(38730400002)(5660300001)(78286005);DIR:OUT;SFP:1101;SCL:1;SRVR:HE1PR07MB1724;H:[142.133.50.178];FPR:;SPF:None;MLV:sfv;LANG:en; X-Microsoft-Exchange-Diagnostics: =?Windows-1252?Q?1;HE1PR07MB1724;23:LsjCkbUTAB18R2El86SXdSfMWPbTOA9FLivEv?= =?Windows-1252?Q?wIxf7GdNAMuStd5NIUiJAv945Yqctuv+hPTp5jg78RduQlDKg6bjD7bI?= =?Windows-1252?Q?hcAJrEvUgNuMXZqaONJOi4KNaeEttMID7/rEqjUGAlEJHa9T36yLwZc8?= =?Windows-1252?Q?wQOyUyaLfjRqPtMgtBEWYxDcTu6OrONAiT3DHx1H/zzyJrm/m4E82G3e?= =?Windows-1252?Q?379ctEW95XOx8h1iLTqCgSGY/f7IOdjo2yLTzGrOVKr93gbLgZdUazNj?= =?Windows-1252?Q?fDItkccBv3YvL9uKMdTgJD0cofODgnQCVPt+y3uKIyhMbEfzcAF81B9E?= =?Windows-1252?Q?CTQkodOAm1Pz1Mq2MtrnF6nFkJrm197EBcNZFtH4USmwQRHZDm4LhN7L?= =?Windows-1252?Q?P/ko6/8B8gqYLu/PF/2Syxt9thEugPXkyDOQLAyvRX0PXweDtcU+akWM?= =?Windows-1252?Q?52ux41WxaHkBb+Jox8zl75qFDaYfpJ0BfuAxonEY9nW1ZbgST5iVSu9+?= =?Windows-1252?Q?39orOURK3/3+ou6CZTQwr9xgHD8dxTe4EmwwVC2q+Idz5D4SchxjWURm?= =?Windows-1252?Q?oEVaYf7XT9ayidu0tb1bkzg52I2k67dbqwibCc+ljkRTEL92eDDcusv3?= =?Windows-1252?Q?VnzG+a6EVFl48YgBnFExSRit6WIoi4+qP3PVemmzLo4VH/sOKx47s0Xd?= =?Windows-1252?Q?acb2lXQd7hJdQapNiIPQCc/4tBS7x5iN50CPIoVbd3lVI0sQsgo3CV6j?= =?Windows-1252?Q?EwC/TyJhZhPm8a2CHXAoEqt7+Bw+b4kGmx+X5/NTfh5nIlOTwWs8u7xC?= =?Windows-1252?Q?3+uPy5fPuPGcNBCj0FdTeauJD9l88X+eCHZeOhp5sp5J97GiFMzMIZNN?= =?Windows-1252?Q?1XWk6HL9LZnNqVL6ikyRHR4caTdmnrgQIm9st/l5RdZ6z6ZTwX7+Izgm?= =?Windows-1252?Q?r8/TS0s/R/hvJyWBUFyUMoVOYdyvKXtPWMPhlbHkPYKIdKTkr3C+JJYJ?= =?Windows-1252?Q?vzGNV7CxDpaM4BCiOcJVJ6DvMFzdXjaaoI2QVcDSjrH058M6MvADv+xc?= =?Windows-1252?Q?e3r1PWSAgU9P+WB920VyB3Y+jVzNvsFngwTl2KzXJiwYAllK9qdO2edY?= =?Windows-1252?Q?fXiSHP+cZLqm35Nml5wNcWZ/atBD0Ngu4p9HZYcg2Uc2gByUmEW+INsz?= =?Windows-1252?Q?9CNEeLVgV+p2NMqopepUJfZpvKrVhfc0aTZXfIkZAOV2BdzWqBVZSViu?= =?Windows-1252?Q?qlVfaNOxj1FCfJXXdu2izt2Dfe7JpCTezHUU2K5nRv1HVrdX31id5Hvd?= =?Windows-1252?Q?YRTShjMTEUJc03gSSmlKc0T1KZzCd8wbzr9CZLHWWgcUDcMtaKZAGHJR?= =?Windows-1252?Q?FarraP0RKxzT6GfhQGrvVkVycRhn1CixLeHSN4AYC0740PRTAoZPOkGS?= =?Windows-1252?Q?cZO9UfD+FlSuHsCCvpFfeAj/dzcV9ksD0YJA1LkZA=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1724;6:y2O5RxZxRN7Cc2rMES5jyi+4kLXbHatHaCsSN/BDuw4AiNhHTfiS0PXfbc1CS0/60ExVLl2Xi1Go95cmFTN4HIf8jDtaPmgnlVBTS1NOf0qTCZOTotRKqYUvEgWjrLXieid3H+XyaIXcmBjPYGX+rLb5CPRFBtGazwOFxtETk5spw+ClGBD1A4RrLCdWLowIueCRRI+V20Jl7chB8KbI38+s7LPgPvUIgbPXQ1FhQJ4kYh28WpTmnsT1/fAF7EuII0ehYTgVYM57r0VlW8XW8oYKeBWiwNVfRY4ZeV/yc/KrDKY+P+Rfw5zDIwGtJjUgmlhJWDLkw7UyXeq3lZkJAjTU24Y7JrQXURniTH5pvJUJJZC0mOTq7bdNxl0wsF/Q2HrL2/DtQuk3/Pd+1/gjXMMD7/VUXCMu9JtWIOCsNN+/EKggPZcJJjUioohJ/xvdJYQtASjP0oXo//BVTCp2Lw==;5:yTZvV7feYRsIBjvmST9LG2uJ44V50ItjyUqULhnXq/xOu594jKvS0f+snakUvTlKF5hVe3O6h7ZqrSg34R3L75BBlCG+4HZSIKybYIE/ywHCuI1FlWUqYgkbEQ4uAk/uE6yUXUnXn/53OxbdhGrCIQ==;24:jr0G4GQeI2OgY6lxy1FaGeHfFUmxLLBO4Gcs/6/QAvK/e6knQNXxVzW+wgoddLvOvKBsidq2Jj+JD96o8xXjoue8vckdtSTThIL3V9hsrQ4= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1;HE1PR07MB1724;7:wlAd+u5vq8SDWu9ZlwQ4nYHz2xmHHwaG/LUz+bJd9mpO5p4IYR+bSy1PaUPKIDoduGoYlaraif9/vIqmQ4m/pcRrGllpu4PLqk02hNAtVpk/Kczp8+eRpvAV/0G26fKWh9fNUwJYUp+jk4rVeP92uTZ2snblqrdLd/Z99WLsG8TsXTNOO5NHUS7I2Qdx1mUKBIewDp7x0yxixpOcize761cDvMbQWhn1ejk4mjp4uVPMJNCY3ebiVnTcHpNXmw/wfRfxSNWEaDwME+PblVL372pyOT5L6P0/iERARPFmMjyUTU2KQvjM7wWksvC7eVrnN97PjnG9f7WyOPLImTfFTA== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Apr 2017 21:12:13.9015 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR07MB1724 X-OriginatorOrg: ericsson.com X-IsSubscribed: yes X-SW-Source: 2017-04/txt/msg00371.txt.bz2 On 17-04-12 04:35 PM, Eli Zaretskii wrote: > IME, defensive programming aside, knowing that some field could or > could not appear is not always enough, sometimes you also need to > understand the semantics and the significance of whether it does or > doesn't, because you might need to interpret that in some way, e.g. to > present some meaningful message to a human user. I agree that a clarification would be helpful to understand to make sense of the description. I just don't want it to be interpreted as a formal specification of when the field appears. That's why I'm not comfortable with a claim such as "the field will always be present when X and Y". What do you think of? @item current-thread-id The global id of the currently selected thread. This field is omitted if there is no selected thread (for example, when the selected inferior is not running, and therefore has no threads) or if a @var{thread-id} argument was passed to the command. > That said, I'm not going to argue. It's up to you. Thanks, Simon