From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 55681 invoked by alias); 12 Dec 2017 21:16:32 -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 55670 invoked by uid 89); 12 Dec 2017 21:16:31 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-3.1 required=5.0 tests=AWL,BAYES_00,SPF_PASS autolearn=ham version=3.3.2 spammy= 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; Tue, 12 Dec 2017 21:16:29 +0000 Received: from ESESSHC019.ericsson.se (Unknown_Domain [153.88.183.75]) by sesbmg23.ericsson.net (Symantec Mail Security) with SMTP id 4A.16.13339.A27403A5; Tue, 12 Dec 2017 22:16:26 +0100 (CET) Received: from EUR01-HE1-obe.outbound.protection.outlook.com (153.88.183.145) by oa.msg.ericsson.com (153.88.183.75) with Microsoft SMTP Server (TLS) id 14.3.352.0; Tue, 12 Dec 2017 22:16:25 +0100 Received: from [142.133.49.104] (192.75.88.130) by DBXPR07MB319.eurprd07.prod.outlook.com (2a01:111:e400:941d::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.302.2; Tue, 12 Dec 2017 21:16:23 +0000 Subject: Re: [PATCH] python doc: Rework Breakpoint.__init__ doc To: Eli Zaretskii CC: References: <1512681799-12535-1-git-send-email-simon.marchi@ericsson.com> <83fu8lwbpa.fsf@gnu.org> <34fa897a804e9427dbe8ae3c107638e2@polymtl.ca> <83vahhuhqo.fsf@gnu.org> <52711e30-004e-3a2c-d77c-e409a1f66d9e@ericsson.com> <83o9n8uxbc.fsf@gnu.org> From: Simon Marchi Message-ID: <0e10cff7-b290-115e-ab68-cfa99916eebf@ericsson.com> Date: Tue, 12 Dec 2017 21:16:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.5.0 MIME-Version: 1.0 In-Reply-To: <83o9n8uxbc.fsf@gnu.org> Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-ClientProxiedBy: BN6PR08CA0077.namprd08.prod.outlook.com (2603:10b6:404:b6::15) To DBXPR07MB319.eurprd07.prod.outlook.com (2a01:111:e400:941d::13) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 3136cf4f-080e-41fc-1fe0-08d541a59976 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(5600026)(4604075)(2017052603307);SRVR:DBXPR07MB319; X-Microsoft-Exchange-Diagnostics: 1;DBXPR07MB319;3:mWa6asgVO31j/xcqlUYvfNfuyfB2ui8HT3Evf/0aGVFoNTFDW8wN2RM8wWNSTx7vX3h0cOnUU9dEPN5XhmAXlKtPn+h+hKynjJUJfwxDQg+c+gduoaC8l+JjdQNUD1sys2dHREMvcwPwikUd6n+qN4+xYtEmyQUCdtI0KiSgBroo8MsrzoZ4Xj3KG6nfkC0ECN16WEq7TYVAWQAIQM87ScwdihrrqIu2gP9Kxy9hUJr5l7tnzkQUG7bPux3uDh2X;25:SxFBx0RBg/zh369+VzK2q0PFrP+QGrYeapbkRwZT7HAwyKAzKuP1ePGT5ivlZttzgusLg53kaVvJwp8SsD3/7WDiZ9Fq7lFGer14/zE5mKZIEnYV53Y8WQi3vunWeuQhhJJ7GqW0n8AtMVavHlSYRpUJdNcSjnuKbwB2UBRyOOeLkOhMORn+twuc52Sj0tzqQ6vyl4y4/4S1zzlBLOBPGWdhikB/jVKM93bXYjAogGc19/A+3aVuZkIYH6Jzjw6mcElMy8Ol6fTgFGno/7sgXlT5g9iGlEvq8nqvHhilGC7MR+AeXXmKBNpoL1BCJ893pBgE9GcoJSDPcWzIEH7BFQ==;31:DLqBDKUU+mk8k8wXXiSB34+/BN7w/EGTs4UN7dLZ5omSfkVEnLv9/2797oaczbUXebZ+R/f9q7ex3OcHmtbomZ51OTysNgcAKUctmWJkoQ46ER3EMs2cx0aDp6fgMZ+H4XL4VKeJtKPtKUYteCGqaUzoIHomoK4GyLHf9n7hMsWsKhTUoVW9h3K3JMQWmDLSULAjgP+MJmR0yUacqrRISPxeybbvBr8S0cxHdEZklvk= X-MS-TrafficTypeDiagnostic: DBXPR07MB319: Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=simon.marchi@ericsson.com; X-Microsoft-Exchange-Diagnostics: 1;DBXPR07MB319;20:pp6+osEEuAMYP082cz1M/2YguBPe8qGLv6slkPn14/BofiTjIYDNIkXoR0jUOwn+4C85e/wy3hMw/I/N1mtZXSvDiPg2mt0pT9S3i9zN6cVWPehlaEy0moarE9mphI9YcffzyYJQ8IhxhpGlC4MGCzVBaZ0t55SdW7YQar2xqeNt3G71hT7lX0QxNm1q7MsS6yYEYJuZn5zyIK57rkGrE8SyuZ8eeldsnsVUt150W4DIcFP/Ln32Wwy/z6chRRohFOHMGz6jVaFyh3IrbXV6gzG4jDPOEv1HO1EjkUuAm77POcBzoYHcO4l8o1IkE/Z/ARhaXsIPRQLAOhTxbc8Tu83gYzJettVJ6EBsDdyC5H4gi6XxUprvdLA1V8gZetAIZbsT5YGlCUzd5nRXby/dMeKMy5FvDnhFfayyoPIYImKKZUN6LVWd1BF269ZgCRzta2K/wuPPsSgtmRpYQHuRWA4tMyoBLxj21Iv6mJpOcb9eTj/Q4iDL0bGuEx8RnMQV;4:+SdEsAcsUlQAfYZDvIoLfEMzLOJxAL42P6cwemR6ODECCEzV9neRVh+hlL0U2hIPTIuchH6DD9UIl0UrOzKCo7OpzGhKJCKkptgj3gPq7cfOLosXJfVmB6i3sc/BrDJ83bYdmcKBRVuoRkGLz1ci41B6evFu3AvDKUW3BpzFmandDdozAFkcfO6wK1xlxt2UZE4NZFUPN/XIp48kRpCs+lzYrIvhXyge93GKgANjNIajhTJGofOpwfz4tSYG/hdiryCRITq8/AROoSAfCNgXbQ== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040450)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(93001095)(3231023)(6041248)(20161123562025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123558100)(20161123555025)(20161123564025)(20161123560025)(6072148)(201708071742011);SRVR:DBXPR07MB319;BCL:0;PCL:0;RULEID:(100000803101)(100110400095);SRVR:DBXPR07MB319; X-Forefront-PRVS: 051900244E X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10009020)(6049001)(376002)(39860400002)(346002)(366004)(199004)(189003)(377424004)(24454002)(97736004)(478600001)(5660300001)(49976008)(6916009)(6666003)(229853002)(36756003)(65826007)(2950100002)(50466002)(53546011)(31696002)(106356001)(81156014)(64126003)(105586002)(86362001)(8676002)(52116002)(81166006)(68736007)(25786009)(6246003)(53936002)(16526018)(305945005)(58126008)(16576012)(8936002)(230700001)(83506002)(316002)(7736002)(6116002)(93886005)(2486003)(23676004)(52146003)(3846002)(2906002)(6486002)(76176011)(31686004)(66066001)(65956001)(4326008)(65806001)(47776003)(386003)(78286006);DIR:OUT;SFP:1101;SCL:1;SRVR:DBXPR07MB319;H:[142.133.49.104];FPR:;SPF:None;PTR:InfoNoRecords;A:1;MX:1;LANG:en; Received-SPF: None (protection.outlook.com: ericsson.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtEQlhQUjA3TUIzMTk7MjM6eU5hNnFsYWE1aGlNVFhCNzhHb1NWMGU0ZHFo?= =?utf-8?B?Vy90Z3JCbTdDVStHSDBFWDBvaGRGREphRnl6V1pGVkIrSnVDVXp5QnZRV0ZU?= =?utf-8?B?MHpTVVg1cXhobGg2T2dnRnJFT2NHSHBZamtROHhPS2hhV2dXYTdCSDRab3Fu?= =?utf-8?B?QW9zNVNwaG9OdzhFdUtnZjRWTFo4UDlMcWZVTGxuQjA0ZnorNkgrMW1qR09l?= =?utf-8?B?M2lWenhCblJ5Q1NqQUYzaDhSNmtFb1AwY0JxemtpeS8yVDBzbUZFZERCOStS?= =?utf-8?B?UHZDajJBUEJyZE4zUklvUExib1lMVmdsMGdsRm12Q256UVhaRUpHaHZQUDc2?= =?utf-8?B?SCtSYTNrZVVONk5mMFVPVjR1RVl4SElYMWpOam1XSTl4M1Z2b0t2RDNVRkJa?= =?utf-8?B?ZHJ3Z1pndTBEa1VFUUY2VUJnOTZ0Y2R2TDR6S0NMcEdtRE1wWDZyNktvQ1hZ?= =?utf-8?B?QkZXbnAvY2wxa0s3ZWZxYm5xcnhzZUVxM2FTejlrek93dHlsUG5XWFJqQXlG?= =?utf-8?B?bGthWjNNRVFUb1VFVVBBM25JYzduamhTc3k5ZlByVENtZHpjWUtZS05rMHpH?= =?utf-8?B?SXVweTUzcExSalpHOElBd0djWVc0MVJyem1kdnRESE95OFErWTFKbzhhQzAx?= =?utf-8?B?TXRFQkdrTW54NTkzOGdzd1BKN2JQMDhvekFUam1wT0FkcHFJSEd2bUFkYkxz?= =?utf-8?B?QS8vLzF1K2thWHVPTjEzVHk0ZmE3L2IwV21SdjdJUTZwMTB2TXBucUtlVUxx?= =?utf-8?B?Wkc0bmlWL1Y0MVVaUFdqdnBTczlLTUw2a24rejhRR0FRbHkybHpvL1VQZnZJ?= =?utf-8?B?WnVMSC9zZFgrOXp2NHpLS1RaNU4xdHMxZVNkWGo3d0huQXFBRzQ0ODNNbTFD?= =?utf-8?B?N1Z6b0FMcGVZcHZKc2RoZDB6ekFuOWM3VjBWSGN4cXo4VFNvZkcvQlJPMnlQ?= =?utf-8?B?K0gxb0x6L0xha3pid0JSRE9HcDhCb2pPQzZDUFdneGNoL1l2dElUUFcycUU1?= =?utf-8?B?YzVIRzZqSWRXNktGM0Y3VTU0bnhKdTYwZXAwVm9HVDV4NzIvaWx3NlMrWnhK?= =?utf-8?B?NkVDczV4TVhtVkZBN29WdU1neWV1VEtRVi8ydDh3MVkxUWM5YkRCdHhqclVw?= =?utf-8?B?RzdCV3dvNjVxZGNhUEJsZzVRancrMnJFM24yMmJKcEFXM3VmblA3Qk5jWDdD?= =?utf-8?B?Rno1aWVRSlpCU3JIb3hZUmRQVlVDc2JxUUJ2b0dyYU9sVENrbTA3L3pCZTV5?= =?utf-8?B?VFNzbHllQnM4dWtqc3JXV1Zlb2kwVXZUMlpZd0VmQnlWR202UWlhUTR3TVFn?= =?utf-8?B?dW9id1ZXaDRCWCtSTklVV2ZaeHlPNHBvUmhtQm1id05hbjRhZkJlbTNVcC8y?= =?utf-8?B?WFA1YVJ4UjB6QVUrVVRNRkErY0hnLzUxS0ZyQVpNeDRVRHpXaTFNMEZGU01T?= =?utf-8?B?c3VZWWdMendZNE1TRnVpSTRtdkgyWW5Yb0lsL285cm8xTkdHYXFENzNQWU1m?= =?utf-8?B?ZytBZUI1SHZjUzE0UmV4UTJJZ1B0U2dhanRBdGIwSlhiMDRUc2lRR1lpWW96?= =?utf-8?B?bWNHdEtzRXVGWjdzNEI5cTBSUEpLS3NmWktjWXhYZ05yVVVyaW1SemtpV1Fp?= =?utf-8?B?Q3k5QUZXMVJHQmplUWJ6dFdRamJHNlpiZXcvSGRyRll1UVlaekwrQ3N1Y1lw?= =?utf-8?B?YUk4QnJlc1g3a2szY2MweEZuWVZyMUt1T3diZlhWaDZSWG9zWHhiR2tMOFcr?= =?utf-8?B?TEVFWEszWFAxSVp1VklnRFZIUSsrTS9mR01NYlJSQ1NKcDFqa0dVUmxUZWFu?= =?utf-8?B?dDM3T1kva2RiM05DMGJyZjhKaVZYVTlhSWlJdFhkVm84OHRIOUl1ZGFXNmg3?= =?utf-8?Q?aclzZZyAtg=3D?= X-Microsoft-Exchange-Diagnostics: 1;DBXPR07MB319;6:z841lm3WnMxfRyQrN/t5NEMSzSnX07DvLFTA1kBuAO7jz09iNbjFEvuAzqAq90VlJPQQ5ICA7cYt/Yg+Hzwp/gm/r5oqcuI7rAk+ONbP/ag5UjPpOD78i010qV9/tz/k3haq5mu/6nbkb+rJS5eapjuW6u2hxyMuGpG+lRnCQ2zKMP+yn386H1UoRPEWyk24ptazuFV0/4ic5YQmGcwaZZkhK9RV6QYWjMRVP9l3Fax154fP+2GYjmGS8GVkapMslqh6R2mGpc73QaIvvmlH2q9BPoK8CzGezahjEVEz19uFKLUaFRg7o3fHAVIM0136EUhpqtiXJ+EXcIq6tRYLhDs9+3uvCsTytgyU6yVPw28=;5:6plWcr+l/Va3ZkAcJBS4Bq6V4eUuj3Df+MtcxPDdA5wbptwxj21yf13UP4li2+y6KU401KxSbUWJeSVMVg+pFfXHi8kLX6tSklPFUnJTuQXvmYxAwCbyDDtL4vUuppjF81gv1jkcw6ofT2UELCu5RslwUYRHI3MhaTeC4XbBOIM=;24:hVgkUXjPvCMWqQ3aYVAAzom/kG5wlbd4VhFCGzbUKwBmowlz6H7uvpk+RtpgjVa1KCTRPvIdcPVUU1+KdMnwwmbKWL6t49llDFJ9SS4w0j0=;7:Jfmj1vdjyv8kG5uWWUGVgw0vWUwtTElvE+O9YsdMSozKa3dMi97Cd8MJaQCuwWkw5SRxId0vbTCwmxTuBf275e0m+XZEuQ+adLl6wVq8TZS3vwrOPF0YdwrpO1KwmkViCIZDNg2BLsnqR6kfa0AgNslPLBFhwpyWHY6E1I+3J9pKYgGgl0ouHKk9akpItINg6qFbMe/oPpZpkoVD32M/CKsqlag4svvdf2igd92XPDl92yaHHhAAjGnbRzo8S5P6 SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Dec 2017 21:16:23.7701 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 3136cf4f-080e-41fc-1fe0-08d541a59976 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 92e84ceb-fbfd-47ab-be52-080c6b87953f X-MS-Exchange-Transport-CrossTenantHeadersStamped: DBXPR07MB319 X-OriginatorOrg: ericsson.com X-IsSubscribed: yes X-SW-Source: 2017-12/txt/msg00284.txt.bz2 On 2017-12-09 03:20 AM, Eli Zaretskii wrote: >> - don't use spec and function/line/label/source at the same time >> - you should choose (exclusively) one form (the one that uses spec) or >> the other (the one that uses function/line/label/source) > > My question was about the 2nd form only: which of the keywords can or > cannot be used together, and what is the semantics of their > combinations? I suspect the rules are the same as with the CLI > command, so I think we should either tell that or add a > cross-reference to where that's described for CLI. We already have a cross-reference to Explicit Locations, which is where the meaning of these parameters is documented. This second form of creating a new breakpoint specifies the explicit location (see Explicit Locations) using key words. The new breakpoint will be created in the specified source file source, at the specified function, label and line. Do you have any comments on v2? Simon