From patchwork Mon Jul 31 09:28:52 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Marchi X-Patchwork-Id: 21821 Received: (qmail 22330 invoked by alias); 31 Jul 2017 09:29:10 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 22312 invoked by uid 89); 31 Jul 2017 09:29:09 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-26.4 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, SPF_PASS autolearn=ham version=3.3.2 spammy=H*r:sk:EUR01-H, H*RU:sk:sessmg2, H*RU:193.180.251.45, Hx-spam-relays-external:sk:sessmg2 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; Mon, 31 Jul 2017 09:29:07 +0000 Received: from ESESSHC014.ericsson.se (Unknown_Domain [153.88.183.60]) by sessmg23.ericsson.net (Symantec Mail Security) with SMTP id 19.C8.24422.F58FE795; Mon, 31 Jul 2017 11:29:04 +0200 (CEST) Received: from EUR01-HE1-obe.outbound.protection.outlook.com (153.88.183.145) by oa.msg.ericsson.com (153.88.183.60) with Microsoft SMTP Server (TLS) id 14.3.352.0; Mon, 31 Jul 2017 11:29:03 +0200 Received: from [147.214.129.241] (192.176.1.81) by DB4PR07MB314.eurprd07.prod.outlook.com (2a01:111:e400:982f::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.1.1304.10; Mon, 31 Jul 2017 09:29:01 +0000 Subject: Re: [PATCH] Fix documentation about rot agent expression bytecode To: References: <1500477367-28117-1-git-send-email-simon.marchi@ericsson.com> From: Simon Marchi Message-ID: <68d07528-db30-0249-32dd-90ad200a832c@ericsson.com> Date: Mon, 31 Jul 2017 11:28:52 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.2.1 MIME-Version: 1.0 In-Reply-To: <1500477367-28117-1-git-send-email-simon.marchi@ericsson.com> X-ClientProxiedBy: DB6P190CA0016.EURP190.PROD.OUTLOOK.COM (2603:10a6:6:2f::29) To DB4PR07MB314.eurprd07.prod.outlook.com (2a01:111:e400:982f::15) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 25522186-4d79-4174-4311-08d4d7f69489 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(22001)(300000502095)(300135100095)(2017030254152)(300000503095)(300135400095)(201703131423075)(201703031133081)(201702281549075)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095); SRVR:DB4PR07MB314; X-Microsoft-Exchange-Diagnostics: 1; DB4PR07MB314; 3:xIzOSM/axnk8ZwS54EbXMnRF0h5U/9Mxr5tWF4BC0Co+rKkPvSkAUQQA8bfbMKaOfy4jVtJa8rEUSka2sGxcJ9ExdwDuaX9WOZXw+hsD275oQcUP7LxUxotAXcw54FIe5NMxKl/nqzE0ryh76l8UF2pGOcbonxYm/3ZjwtYXk5iGlhSV0J+b2qPARKx/dpPAlyhA1rWa7EADHvmzPhWjRXbL/Z1zFH0OoxZdv6s6yaGEyvMcBQF59XWpcOxXne5wuj23U9ZE5NnLHko7huyW0I052MOW+hQyvtAP4KL5SI3yCKKd4helgTsgdKV75YfmynBUWP3HoUfsgQ+td2yMO60snrnFQziuyR3oYZxDSZRjB2WO8F+TDgZNsU7agXlpXcXTnVd8VMEgpP8ygTjxm8dua6PrdjH4RXKs/HonynyXQPlzD5PxACCNAN8iga3aStnaYvr7qZkyY6lSuRwusg0V4IW6pMkpqbEzlyP0UuvmymLrBAAqufB5aGbLcErxWSEpdCErob4P2tVvl57CG63Hh6HxSQHpxYGqyVzCN5b2cJUYSD/IcVWvNTRhAGyf7WBSaNJ3hXKq2FWVqCYkF3G6u98NNXdgmDao8yiDqtHjkzcfP36goyVYtXAjCM17js277Ghkg6pesnIed5/BPDYo7k/w4CwX9XtpZPYpYCm3b7XzxX154IcinJ0Tu8AIqXqC7QUyj4qZXCu8Ku73pzj3KXcHhz8eYbMKBx7nH1nQlZiFJ+1iKYdDR4717R71jRZEaboiqg5rMkxKbepCusTT6Q+oEyegSPUd6udCARA= X-MS-TrafficTypeDiagnostic: DB4PR07MB314: X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtEQjRQUjA3TUIzMTQ7MjU6c1k3K0Z0MldZeEphMnJUWHlyd0IvekYxRWwz?= =?utf-8?B?WHgrYjAzblhDcU5jb0RQZDJuYk1TSUxYNGJiMzZSNXZ2eG1qbFkrVEREeStn?= =?utf-8?B?ZjZCMHhNbVBpb1VvUzNGbzhOTXB2NUJnNXFuKzFaNnFXUDlHbStsdkVTZmhx?= =?utf-8?B?SzFhK2t4R3F6SDA5NGF0UkdCcU8xYjN0ZWE5cXdCeWtFSm1ydnZGOGdjNWtP?= =?utf-8?B?RUNFOGd6TWhFUzF0elUreDdMTWhGWkhOSG02ZWgxbmFOUS9rUGQrcm1KS1BQ?= =?utf-8?B?SWRvb0g4N2V1MTgxRTMvWjRFRlJBSmR0aDVEL0dod04zamZaaDh5ME95Mkoz?= =?utf-8?B?alk0bHNsZ29lanNlSVVheEViOHZUQTBmK1cxdDBuYjV5cmlwWE1vQ3BKN3pW?= =?utf-8?B?Qzh3SjZXZ1d1bkU0UDdpZWk4bmdMOVFuSVlxZjBMdThaOC94TmYyeDUrYm5p?= =?utf-8?B?b2E1SFVGei9aeXN1T3UydStFSFFBaTIxMDVRRzFwWWgxTlN1UDhVNVJvckM4?= =?utf-8?B?WVU0S3ZhY0JqelQyZFlmbWFZRkIxdk9ZS1MxSHk0MVpDNEVKMnp2VGdQd2RO?= =?utf-8?B?R05CSGlGcWlyOXNMTWt6aHZjaXJRTmFMK3RWbm1PaVJ2blcyaGU5QXFDd1E5?= =?utf-8?B?a3NuZm1YUFBqeFBVOHBrUUFmdkNnMVpTT2tFNS9MbW1PZ25MWmpWbXZFTWlZ?= =?utf-8?B?UUw2MkJieEFCcWVwZTN1R0JqandVK3pIRU9lWmt0M0NUY29pV3lQVHBMYXc0?= =?utf-8?B?di9aNjVGcHR4K2hoU0pYME5jbURkVFR0eVNiTFYxNnZpTmYzSVVRMjJWR3RT?= =?utf-8?B?aFF5TjJRcVZ2dzE1UGRTUUc3cUdsTjdjNWVnMnY4ZlpyS24zYUZGYWs1cmt5?= =?utf-8?B?NzgzSFhGODFtM09SUVZLYWh2SG00bk04K1dGQXU2c29UTXcza1ZuNGJZT1Y0?= =?utf-8?B?RWo4bmpTSnFab0NmeUYzR1VsTk9FOWZpOXVlY1g3TklZc3VKWHBMNnl5RFlI?= =?utf-8?B?NmxKbnZEU2JaVFkwMWdUVUpHaXE1L3NETFZ1YWY5VEtXalo4dEUzWFc0bElo?= =?utf-8?B?SURJdUhOSFFJUU81bEhabXVWWGU2ODE4WE5yZFQrcnk4R3dLczVuOSt4MW9L?= =?utf-8?B?QTdMNEs0UlhoVHNPd3UyTS9xc0ltK0NGZzhYUDJJVTZqUlhTL2R2RnJzbFlx?= =?utf-8?B?WHpkMjBFaHprSDBySy85bHNHWjJHQnRaTjg0cnVjckhqY3dQVnZYeDNWWGl5?= =?utf-8?B?UE55K2J3T2tJakd4Wmg1UVdXQWdCcEVOdzF5V0xQTWhiS1NVbFo5VXpDNHRz?= =?utf-8?Q?uqZ16sKZab/GqmmOI8tO+u8jjajQQjg=3D?= X-Microsoft-Exchange-Diagnostics: 1; DB4PR07MB314; 31:hgq2ugXrXk79LoCBdH2nt6nDaxnmUxN0yUCZiZO2Bl063WYQM49oRTPuVck/aKGKlVRE9fwsyWHS2MH/ZfBPsTuWzq6/eF4Sg4h8Ls9l1Ps/OT9i57zob+t9JW3deP9qKDK0nCd82RJ4/UlTI8wLJn5i3nPn+27E7PrVE9D351h/BrnZMVn4UN0JXQv+oBT8ne8nzdSzJD9OVIK4ROVJ+II44Mpce6uMpISEkaKlAvk+T5+2EI9xIQvsdRCL8vWkgTUFh4NwqAWeuxGzPqD/UQz0LiRO80/9fhwgKmJe/NG/jvbVoSe0AM3mhPCUIA1EEqw7uMBqg/m0j7fZ+/qBV64VruRWMQxXU8hVknjG4+nkm4GnDsBYe67QYFRjx1WoFDfQZmKArY6ZjkKzyYEgZmuB5l+z7iNVCwSfg96rJ4ySgf4hJbOX0JKlzyRNhCD1ylKWfHpPcwhXegR73avR63mhkW+pvDPVqj5TeEqo3f+bRA9df3+Ec8SKBVQeoTAqaTjn3X1H0hKEW2aBaoT1PHGa7Vj8QNe6zi6VO9NaBjlhO0AQYe7UYkiOrZ5nM0uAu+/cPE4WyjTvNj3lw4qHBkPQ2b4yGyKt5h9KoNVvhZh+LBNbdGCI1SxUz6qGEC6qdUlEuEpxyg9myHvgic6H3a5XcUgJvyATt3To4/g/lqqZjriRcLWtHIDzDMu7pjz5qqmdxOlRJEP5ypoGBvY2yQ== X-Microsoft-Exchange-Diagnostics: 1; DB4PR07MB314; 20:TNHE7sTpEExzcedlD/TeEUeUpLeRlrSK5N3QWcQ2RbiLegjDz3pFM9gCoTy1DBjudLIc5Y9cGf5cg0DD+tu6oZvKDl7KpMagmJWZi0HKmQ9lJf8XA4PIx9kurBzh3pDUIhCnuad+c75bRy8ijjb36Jyo7qxzMg52CR2cYGsZhHDekYUkzBrT1bM44k867DDSLykVpHncOMiL3c417SHAynAtI10oRTMz3dbQoILuRHHTny/XBnOoL5fmkVQm9ZfM2XAZ4bZIrAiA+tEY2ZS6DRE86Y9rBSG49ce6JhVRZ5dnsKw11EUgxosTUzLw5gKlAX99zWPC1Z5EnN85zFNShK4lJc0r2/1QFdFYneV9cRP1V593nnQF3DcbKVBuV9xGJCk/cy7YIDcbv30jCFm921VnegsC+PVRW7zNdivKEimPcZTcNxuQDDv9dU2wxqfTBk0ad2N7GU6P+gh+ytQHD+hLXaJfVVcozeau/eUqMxDmKLTlrAVRmZ8sX2aqn16w X-Exchange-Antispam-Report-Test: UriScan:(37575265505322); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(93006095)(93001095)(100000703101)(100105400095)(6041248)(20161123562025)(20161123555025)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123564025)(20161123558100)(6072148)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:DB4PR07MB314; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:DB4PR07MB314; X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtEQjRQUjA3TUIzMTQ7NDpWcmpmaDNVRmllbFJKOGtITmFZQTN1R281T1E0?= =?utf-8?B?cmhad0x0WWU1Nzg3cnc0T2xNTCtURWs4QjV2cERacGcxUk9WeGt0TkJnYU0v?= =?utf-8?B?TUs1dFprZVlSSDB0eHJWVDdObGx2U3psTURpbUZ4dDYzT2xaTjdtWHM2STQx?= =?utf-8?B?c0xSUk1NYjhmMmViM1M4MXFGNW40VnR0c1l1NThOeCtLK2grYWdMV0RCNzN4?= =?utf-8?B?VXo5U2VxbzRNSktzT3lubFFXYXhqK05NZElWSDRiRWZYNmcxeDlIU3pRMm8v?= =?utf-8?B?YzB3VmJvRDdBM3dIRTlBWHJnQUtrS3IxcllINWl1M3hoNVlLYlNrOWt1UFRF?= =?utf-8?B?Wm0raUhEZFRRamlrbEVZNVdPTDhGYXJESnJyeVlQZ3k1MmNIRWIxSlIzKytk?= =?utf-8?B?VWZDdzZJMzNRMWtGbldHQ0xncy9acDlHTGEzaWZha01zbjZ6K3J4dEdjUXg3?= =?utf-8?B?ZTAzejBhaVRVUFR1TjVDdTNvV1drVXNDbUVFRlBSZElBSGFRNldxdzBhdHpl?= =?utf-8?B?OEExcTlzQzUzbE1OUFR4cCtkbWU1NUNYbDRJS3h1NVY5MUZiSTViNCtvaGpO?= =?utf-8?B?N0pldFE5MThia2x4cGVuYjRlNDJoZ3pCQkFGd0M5bkZEc0VLV09oWWkzOE5V?= =?utf-8?B?U0NHMHJpZzhmWm8wNG50RFVxeHN6QTBvNkxpcS9LTm82ZkRIZURFUHl0SE9t?= =?utf-8?B?QVZmYXNVUDRJd0MycE1QQ2l2dGdES1dJNmhidzRsUzRpMkNGOEE4L1F5bWJC?= =?utf-8?B?RmZDTXYrblJkOWE2alNCcWN1ZVBQNXM3NHFrb3Q3ODAwQVNHQkptTkJvdVdF?= =?utf-8?B?OWpXWnQzQk5vWmhBUmUzSlY4czhZL3NLYktUNDNWTzM3ejBVcENvOWtVUW9v?= =?utf-8?B?L01Fd25JSGZhdWwxYS9Ed0JNVXBBRkRzcndNTGd6NG81QzZlZm5YRkJPdDd5?= =?utf-8?B?RExSL0J5a1FqU0grTWQxRzFUVHdWc21GTkRScGtYcXF2Y3BZcmJYK01mRzhU?= =?utf-8?B?UDFTQmIwWjRQTE5zQXVaMVRjRG43OHVQczIwWDk0ZktDNy93Y3FiZHA0VUFP?= =?utf-8?B?TURIRkw1RlhNZk84ZFVnSm1XbnBSWXJYTkdUYXZEWVZLRlBDZDNsUGplK3dH?= =?utf-8?B?NHdUZWR0OFYvbjduZkYvUlhxeEpsNWZzdk9RMlI0QjRYUzNxM0VlNnZ0VHdj?= =?utf-8?B?bWZPNDJXWnRPTlVKZko2Mk85QmFnZ0dLNVpaWXZLNngyWmZONk54aTMyU0hG?= =?utf-8?B?ZG5tcmlFbjFnTWlEd1BlZXJuaGhQaUZDT2o5QzJPbzlidzRIemoyaDRONG4r?= =?utf-8?B?TlNpbHJjY3VFaUJFSnRXc2dXTE5HcnlMdWI3QjRZRVExU3NLMWlhd2VXNEVs?= =?utf-8?B?RGNSNEFiY2NiVk5kVFF5TnNsWDUzWW1QeGVZd3hKLzN6OU82ZkNzbDNza0dC?= =?utf-8?B?UlowRm9PY3BJdS9aNncxNkhCZW9qYkRUL3lEaG1WWUUySWVQblZiby9td0VH?= =?utf-8?B?YlZxY0d5ZHFkM0dmY1pjclludU9uY3h0ZFdLVDk0QTN6dGJKWU1rYjZWZFJx?= =?utf-8?Q?PEL/B95zaAQqjHZvno+9ZoOd+i9C+Nmagbej89Ixcw=3D?= X-Forefront-PRVS: 03853D523D X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(7370300001)(4630300001)(6049001)(6009001)(39410400002)(39400400002)(39840400002)(39860400002)(39850400002)(39450400003)(189002)(377454003)(54534003)(199003)(24454002)(377424004)(7350300001)(53936002)(23676002)(230700001)(6666003)(229853002)(64126003)(2950100002)(6916009)(478600001)(47776003)(6246003)(6486002)(110136004)(66066001)(65806001)(65956001)(50466002)(25786009)(305945005)(38730400002)(6116002)(105586002)(68736007)(3846002)(7736002)(42186005)(31686004)(49976008)(4001350100001)(189998001)(2906002)(50986999)(76176999)(54356999)(2351001)(2361001)(106356001)(53546010)(81166006)(33646002)(65826007)(101416001)(83506001)(97736004)(36756003)(86362001)(5660300001)(31696002)(81156014)(8676002)(78286006); DIR:OUT; SFP:1101; SCL:1; SRVR:DB4PR07MB314; H:[147.214.129.241]; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; Received-SPF: None (protection.outlook.com: ericsson.com does not designate permitted sender hosts) Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=simon.marchi@ericsson.com; X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtEQjRQUjA3TUIzMTQ7MjM6N0g5TXRZL1JVck5kN2NLcTFBSTR3dGsyQ1Fx?= =?utf-8?B?dXEwTDRBZ3lHOFcrYTdlYXFQWmZnMmRqZEZ4ZGZhd2hmVldMMm1mYjJHYTB6?= =?utf-8?B?Z0lkd2V0cE9ZMjI1d0pFZ0RBTjA3UkVpV0lDS2dCbW51dmF5d0Q0SGtYQlFj?= =?utf-8?B?TmdkWDdsb1RNYkZkWWJ0Kzg3ODRYamZlZS9wUElsZFpnTnc0VEt4ajJFSXMv?= =?utf-8?B?VXpsYjhMRlZSYXJtTXZYMTVPRnVIREZpa05rQlIyOElQVHFkaFRlRlU5cXNu?= =?utf-8?B?TFhsNE5NWXhjRlBJMzhYTW9VVzlzNExiNE9iRm96blY0U3YyV2dOd0lYTEhk?= =?utf-8?B?QmpDSUNDYTRIV3kzZEt0NnJKa1UxK0RaRUR2OWFnREJ6K0wvTFFITFNBSlFN?= =?utf-8?B?NWdadG5HUnkvNkZXWGJ5K09HSGlnQTMvajlMekhvTVVhTmdUMzFxYU1DWWFz?= =?utf-8?B?UDYrTi9wTmN4WGxLWkV4TitWY3NPOFR2bUdxRVpWWE40WFRGY1ZXTWg4N0JI?= =?utf-8?B?TXgyZTFUSHV2RTQ5M0xoSTRnRHk1dy9mMHdBM2RHdzdEa0pLOFJtcE5mTW1y?= =?utf-8?B?YWJmUWVrV3VGcm9nbWgxUkc5RUp5Z0hEU2hDSU9tckgwNFRvMjZTZWVFZERX?= =?utf-8?B?ek84UFExVGVkS0Rwb2l4Y1haRTVmNURyOW9xeFlwbVpHY0hJcExlWjdxV09S?= =?utf-8?B?S1JCNlNST1NMOTJqbEZUZk84NndFUE5GQWxDQnFuS2JKaS96alNhYXE4NWV0?= =?utf-8?B?d1lJSkI2NCtCcnJvVmVHZDVmNC9mVjBCSTZlQUFDTTNGZlZPWGZOamdsMHFJ?= =?utf-8?B?cC85T3dCd0dZSlpkTWJRQ2tpRVpaWjhyQmlhb0l1aGlieXpMOTBXb0k3dTRt?= =?utf-8?B?VU1LYmtxeG1IdXZTcHlua1ZWUFJLc1lNUGEzMmcwYVdrZ0xBcUxpSmkxMUox?= =?utf-8?B?UFplenIzN1pCQU96MnJQWGo0MDlLeVRFa3dLWHFpcEFJeWNkM0hGdWFlRWI3?= =?utf-8?B?OEtucEp2eVpOSmlWSkQ0UFZVdWpkQ3ZyVjE0OGlkbWQzWFRMY1NnTnRjT293?= =?utf-8?B?ZTliZUJLVC9pcXlFZzZyVWcvZi9qWk1ySHJOSDlvNktGZkwvMTBuMk4wdnNX?= =?utf-8?B?MVE1UmtwMkVFMXNTTFFzQ1ZzdUNMWEtFRWhJMk9id2ZsWkJROHV5LzQvMVNn?= =?utf-8?B?N05XRkF6RGRUeDRldVk3UEMrNGwrZzN2VHZpYWNvVzFtOVBTR2h1dEFPNS9t?= =?utf-8?B?SWcxM1NIM1hLbmZnVCtsNWRKcWV5ZS9Fa0VaMWRNTGtkcE5kN2o3TDdDWGwx?= =?utf-8?B?MmU5TnNIaC9BSUJXVTJhTkYrb1RwdS9KZzhXdERSLzJSR1gzOG12dS9lWG9y?= =?utf-8?B?VndubmtBbGJhTGVlUVlKTC9nbHk2SW5IOHd6MEFueEJCU2xpVVNzQW1EdUh2?= =?utf-8?B?OThVaVRnMzQvQkUwOGl2cGdPU3B0bitPZlMzZkw5ZTg2Slc1alQwSmgyYVBa?= =?utf-8?B?ZGpPRXpkMVNBckpHMllraHJWU2d0QytQTURJZHhuRTJodEZoYytxOGFIbitl?= =?utf-8?B?dXdQRENnajBVREZXY2NzNHhvY1BnTUxNQXY3c1FmT1F5M3JZZ2Y1dE9sMWM1?= =?utf-8?B?OFVEU2labkhYVGhrN2dEdkdHaW42aWp2M1piL1FPdlpHd0o5WlhDWGJuSjdy?= =?utf-8?B?SnZ3TlZrSERQek9rOWEzakYrTUJSS2pRK21ickQrYVYwUU95eGF0djZGdFpG?= =?utf-8?B?dHFsUUxQMlZaaUlEcGY5dFFVMlpsY3EwZTVSTWpyN211S3ltL3BSV3NjTU9m?= =?utf-8?B?SmJFc3oxdlVuV2dYYlJQYzBaejVCMWtmV2hHSjF6anpib1g4cCtWYWh5ZVVV?= =?utf-8?B?azBFcEllQlM4aVdnSVZ5QUNwbHdNUEV5Yk9WU01lT2FPN3puaFFmQmhWcGsz?= =?utf-8?B?em55bEpkNHYrMXpiZy8vNFFQN1NsaUVQRXlqUElrclNxL1NyVEljOFJ2MnNs?= =?utf-8?B?T251WlBZbWRMcmxqVmtJWllQQnZzNWdZMjV5VlQvWEhXTVhtbFRXV29hSmR6?= =?utf-8?B?UFFyVlljSDdmc242Y3l1U0tFSC9PMFh3cXBHSlBtVTh3OVp0bFZmUE53aFVt?= =?utf-8?B?SitMeGlTSmtMdnEzeWtMc25iZzJDQlE3bm85M2tlNStpdVA3YjYzYkpKSllL?= =?utf-8?Q?/yM3IZ6A+BM8Ix7Uimm0cs55Uyw62beGwX/i8sqpE=3D?= X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtEQjRQUjA3TUIzMTQ7NjphUldlMTUxVXdjdzYxaVlkWm41SW1NMzkxMVp1?= =?utf-8?B?THloaXZEaC9ieG5UNExlc2tTcHdCVkNLMW94ZmtUMzVUdGE1VURxc1NCUm5x?= =?utf-8?B?UURCOWc5UnB2SktmMDBmY3RKWDFlZFl2bUM5bDRjRzFUVW1XWU1odVFkdmVh?= =?utf-8?B?aFlxSUZvRG9yY1k3QmZiaUp6bms3WjFxTWtZTnVDRWlvWTFiM25sNXcvOXli?= =?utf-8?B?WTVsK0pqNmFVaW4wcWR0bEpvU3Y1OEhpNllKUXJQbzJKY0wzN1lzdGZnUHpD?= =?utf-8?B?QTZUbjFiVXY4cUdOanhaZndMRy9vM2ZaeElzTlJYMk9ZM1FVTmpzVGZKRlY5?= =?utf-8?B?TGhuZDFKV3o2VC91TnVlekN6eWpZdnlKTVJ0MTFobVl3TmtZM0lVN0U1Q2xx?= =?utf-8?B?RW9iQitiZWZWTU1uNmlLeHVlenBLT09rdEFJbHNsQlQvc0RISHVNS1luR2kr?= =?utf-8?B?T0E0SVIxUCtyVGkrWUVOV2FXSGt0cVRGK1hYMHdqalpjbWhKZHg0b1NQaTRm?= =?utf-8?B?L2xOajZ1emZOaGV0UDZNcXdtK1Roa1FZcHBYRG5Ob2hhdW14RlJvS1NVTyt5?= =?utf-8?B?dFh1Q05SUnZ2dHU2MmQ3Qk5FbDd6MGdvOFU4aHNKVXNkdG84M1BKZisvOE5F?= =?utf-8?B?R2VhUWlPWXo0STN6WTk0RENoNTZ4TDRmZjBLaU1LS1pFZmVqNHBweHBkamlu?= =?utf-8?B?QlFTQURjb21KZkR4OHVFcHZQWUxiWjFnQ3RUR3dNdUpBaWVQOWdBdVRVUW5E?= =?utf-8?B?REdZRDdFS2hCeldZdHlyMm1jWG5rVFNMaUpxTXcyTDVwUWZtK1l0RTVOOEpJ?= =?utf-8?B?enp3MVQySWNZY3ZyK3BIMGFyN0p1YU1nbUE2QmNqU2pIalltbkZhNmZmSUlY?= =?utf-8?B?SDkrem9wMDBhNVB5VHhkdWIwLzR5MXo0MjQ0a1g3SHFlS2FMUVNhbEN6S2Rr?= =?utf-8?B?aEdmTHQvdTVKdVJXTGZqREpzNXpmTXNQcGllSVpXMk5zVkFuMDNUMGtVbVR3?= =?utf-8?B?ZGxOZ0twOVF0SllmQmpBU0szU0YxOGphblMzdGVBUldtUkowQ1UvL1ZZT3Mr?= =?utf-8?B?NmNYenFQRFNVdWxkU3NxMUJjZWJ0MDVMWVVLcDhvZFdqcTdIbW5YWXVUZzNP?= =?utf-8?B?c2Vyblp6enFVWHl4Sm92dnJNRWdtUVRDZElpb1BGN0JSUE9YSU9qcnFxdjBZ?= =?utf-8?B?bTllZjNhNjFzdlV4elpxRkt0eHNVVjBPRWJ5WTBtbzlqUk5vR0JRNHJBMEc4?= =?utf-8?B?cXhQNWtCTUw2YzFtZ2FKQkVZSFM1MklnUHJtcnA5VEkyWi9jY1RuUVkyRFo1?= =?utf-8?Q?D4JtQGTRDCKSeSXBJJxPwDH6T1l3YI=3D?= X-Microsoft-Exchange-Diagnostics: 1; DB4PR07MB314; 5:JkzypUgZLguqfgwFoIRolO6p4y02o1QjJHn3m5nuKoynho0VHBlNZwdg1t/N9jxLumQLDhZVNvE1WAO41n0WjgeieJMmyTZnTIiL3SxuZnEP9jzjMqc3DHUuT7Kn0Ybz5Q424JiM9c5tUvDE/rC/LDGMro5zPYOEFXnDcAkm1e6mM0318RKssGp22nPHs8FnlGJCntOAmBQfsXSTQeZEmEEjJD/gAozSVLfZi9Ebt6BOjKgKZB8K5X+G+ClP+O8LUL2LjWTCEKY/T42YMcs2mVO9edGOaWhlnSbWXqbyBd2Rhno403G44WB1JK1lOVLOvoOVETzevXyjJ+y35eSCDlBfE/dcxK8DVhhGJEppsCrlSIXkMtybheegQzPVdmzDjliX9yeCsBY4cpjDA2+YSYvp0hjWZCi3aZqWf3mylAuSJ1Xk6qDM4GQu4K3i7PODZZc1qeBkJWtx/B0riwEF8/7deiQOf8vSkLXHnpp0rYr/rb40q42QiyytoTYiyqD+; 24:Kc6YObSdpJ9m3+NU+b6gIkNt6qeokI8fngByntWP8LoSS2FFpeOQaFI5F9QezXihFfgSMBRhKncKllfWKxe/4l3LZElAqHPp54fUl67i8+E= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DB4PR07MB314; 7:tH3BhKREbrfZo7vtxxAPmrSeFh9HDz1b61u6cO3fXJavxjZqaB2M8UVhRfMnaYz2ilPAFx0oBYW4//5tqQbIh2pXVUQClqC4vZHY3pAWr8hkA2j6xHALlAfqRrCTJeczp2dhT36idRQ4UfVAWijqDQFVRChd1b8pfiRYBFKoEYNqyTFcszU/iLLaf6gqUFbS0BKxHW6XkCiPIBPljE5bkYsEwnhxT5taKc/UjnYQ9Djo9cRwFwwxBuUrnTMWnrAypP/WNXtTSXowv8E4RG4k/BjQKt/xedfJeRqfhcIecVvBKBku42oeWYmnDVChg3R57YRx3Qur1svn1pZzxL2BPCCEbQDCC9pfHkEwdUnSRW7zV/CucAaY/tg2+41uEouVwSASZdDF1mjEVjo9KsxXEDd5Oe5REGgE1qKxKrG1gRHDuDbZ1zQ9JanTEToraXqSL8jwUs2cO2kPkKkFz1gdWrt9JWQmTI9nFAvqw/u8buDLtLajoHUNQPfPYvELyMHBEUjLu5Db/6sk8P5qQubkJWIPiwyPJXIuhuPfeYE/RjBnXHftfOtXIEubzYoL7r2RVFSKD8nmw4XyqGK6ymVjkrwCRbkXlNDT6ieyd8tCyfpFKpwbJHlW4wHzvpfQ910w2tunjzNOqRHfvf2cwOVWciBe8AK0qBQUUTvM5142fPSKJeeJ+rbk47Lhg47e8W0+Q1dpLaw8vVoMT5IGMhlmVB52bK+bL1la3zeENMtCPvjzbqZJ2flexUpPNiJBPMFVPTWh559loHBUdLd/+CGWX/PTA16xMu10/JAyOmsGB0k= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 31 Jul 2017 09:29:01.7845 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB4PR07MB314 X-OriginatorOrg: ericsson.com X-IsSubscribed: yes On 2017-07-19 05:16 PM, Simon Marchi wrote: > The rot agent expression bytecode rotates the three items on the top of > the stack. It is not clear which way the rotation is. However, the > documentation currently shows this as the effect of the instructions: > > a b c => c b a > > which doesn't make sense, since the value b doesn't move. The two > valid possibilities I see are > > a b c => b c a > a b c => c a b > > depending on which way you rotate. > > When looking at the gdbserver code, the top of the stack becomes the > third item, and the next-to-top item becomes the top. So the second > form would be the right one, since in this notation the top of the stack > is the rightmost element: > > a b c => c a b > > I adjusted the symbolic description and added a bit of text to make it > more obvious. > > gdb/doc/ChangeLog: > > * agentexpr.texi (rot): Fix symbolic description, improve > textual description. > --- > gdb/doc/agentexpr.texi | 6 ++++-- > 1 file changed, 4 insertions(+), 2 deletions(-) > > diff --git a/gdb/doc/agentexpr.texi b/gdb/doc/agentexpr.texi > index 5668e9c..aef1973 100644 > --- a/gdb/doc/agentexpr.texi > +++ b/gdb/doc/agentexpr.texi > @@ -396,8 +396,10 @@ is zero, this is the same as @code{dup}; if @var{n} is one, it copies > the item under the top item, etc. If @var{n} exceeds the number of > items on the stack, terminate with an error. > > -@item @code{rot} (0x33): @var{a} @var{b} @var{c} => @var{c} @var{b} @var{a} > -Rotate the top three items on the stack. > +@item @code{rot} (0x33): @var{a} @var{b} @var{c} => @var{c} @var{a} @var{b} > +Rotate the top three items on the stack. The top (first) item becomes > +the third item, the next-to-top (second) item becomes the top (first) item > +and the third item becomes the next-to-top (second) item. > > @item @code{if_goto} (0x20) @var{offset}: @var{a} @result{} > Pop an integer off the stack; if it is non-zero, branch to the given > I pushed this patch, though with small changes in the description to try to make it clearer. From 791fb3d7a58b86e5f30229625dfd33659f33fd6e Mon Sep 17 00:00:00 2001 From: Simon Marchi Date: Mon, 31 Jul 2017 11:22:21 +0200 Subject: [PATCH] Fix documentation about rot agent expression bytecode The rot agent expression bytecode rotates the three items on the top of the stack. It is not clear which way the rotation is. However, the documentation currently shows this as the effect of the instructions: a b c => c b a which doesn't make sense, since the value b doesn't move. The two valid possibilities I see are a b c => b c a a b c => c a b depending on which way you rotate. When looking at the gdbserver code, the top of the stack becomes the third item, and the next-to-top item becomes the top. So the second form would be the right one, since in this notation the top of the stack is the rightmost element: a b c => c a b I adjusted the symbolic description and added a bit of text to make it more obvious. gdb/doc/ChangeLog: * agentexpr.texi (rot): Fix symbolic description, improve textual description. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/agentexpr.texi | 6 ++++-- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index d43ae35..6a3d061 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2017-07-31 Simon Marchi + + * agentexpr.texi (rot): Fix symbolic description, improve + textual description. + 2017-07-26 Yao Qi * gdb.texinfo (Maintenance Commands): Document command diff --git a/gdb/doc/agentexpr.texi b/gdb/doc/agentexpr.texi index 5668e9c..081e5fa 100644 --- a/gdb/doc/agentexpr.texi +++ b/gdb/doc/agentexpr.texi @@ -396,8 +396,10 @@ is zero, this is the same as @code{dup}; if @var{n} is one, it copies the item under the top item, etc. If @var{n} exceeds the number of items on the stack, terminate with an error. -@item @code{rot} (0x33): @var{a} @var{b} @var{c} => @var{c} @var{b} @var{a} -Rotate the top three items on the stack. +@item @code{rot} (0x33): @var{a} @var{b} @var{c} => @var{c} @var{a} @var{b} +Rotate the top three items on the stack. The top item (c) becomes the third +item, the next-to-top item (b) becomes the top item and the third item (a) from +the top becomes the next-to-top item. @item @code{if_goto} (0x20) @var{offset}: @var{a} @result{} Pop an integer off the stack; if it is non-zero, branch to the given