From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from esa1.mentor.iphmx.com (esa1.mentor.iphmx.com [68.232.129.153]) by sourceware.org (Postfix) with ESMTPS id 741E238515D6 for ; Fri, 17 Mar 2023 04:02:09 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 741E238515D6 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com X-IronPort-AV: E=Sophos;i="5.98,267,1673942400"; d="scan'208";a="104683650" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa1.mentor.iphmx.com with ESMTP; 16 Mar 2023 20:02:07 -0800 IronPort-SDR: +Q/tYKr+v0qJqN4N4CNuVnyLE5ftdzyzQrHANDQZJVpT86Vd58vCv0B3Rw8fw812NQnNO2D7uN hh4u8yOmKGzgnMBb6PlL0QWuiRk43oPj9P12oKiDYRjtqno4rzvgdEPQ9T8DlbdiBu0GQsimXp aAHi1qXHpBeVDQJoCfUMSy1hVyBqQrIJOZo6u1UKPV8rbE+KZxpIwk4RoI4if8IUOUrq0hQJiT emtGIhEJeWrDcXhygBH9k8ZHfSXBk8NDR0ghWb4nHe8Nqlse2F/E6JeZDzjE57XA6YmazEsrlh iCE= Content-Type: multipart/mixed; boundary="------------04I3ZJnmURazpOCZqRlTAQI5" Message-ID: Date: Thu, 16 Mar 2023 22:02:04 -0600 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.7.1 Content-Language: en-US To: "gcc-patches@gcc.gnu.org" CC: "Jose E. Marchesi" From: Sandra Loosemore Subject: [committed] Docs: Fix formatting issues in BPF built-ins documentation X-ClientProxiedBy: svr-orw-mbx-15.mgc.mentorg.com (147.34.90.215) To svr-orw-mbx-13.mgc.mentorg.com (147.34.90.213) X-Spam-Status: No, score=-9.8 required=5.0 tests=BAYES_00,GIT_PATCH_0,HEADER_FROM_DIFFERENT_DOMAINS,KAM_DMARC_STATUS,SPF_HELO_PASS,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --------------04I3ZJnmURazpOCZqRlTAQI5 Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: 7bit This section of the GCC manual had some issues with lines in the example overflowing into the right margin of the PDF-format document, but as I looked at it more closely I also saw that it was full of missing or incorrect Texinfo markup, too. I've cleaned it up thusly. -Sandra --------------04I3ZJnmURazpOCZqRlTAQI5 Content-Type: text/x-patch; charset="UTF-8"; name="bpf.patch" Content-Disposition: attachment; filename="bpf.patch" Content-Transfer-Encoding: base64 Y29tbWl0IDdmZmJjNzRjOGMyMDJhMTZhNWU5ODcxMzRmMDNjMjM1OWM1MzFmMGUKQXV0aG9y OiBTYW5kcmEgTG9vc2Vtb3JlIDxzYW5kcmFAY29kZXNvdXJjZXJ5LmNvbT4KRGF0ZTogICBU aHUgTWFyIDE2IDIxOjA3OjE4IDIwMjMgKzAwMDAKCiAgICBEb2NzOiBGaXggZm9ybWF0dGlu ZyBpc3N1ZXMgaW4gQlBGIGJ1aWx0LWlucyBkb2N1bWVudGF0aW9uLgogICAgCiAgICBnY2Mv Q2hhbmdlTG9nOgogICAgICAgICAgICAqIGRvYy9leHRlbmQudGV4aSAoQlBGIEJ1aWx0LWlu IEZ1bmN0aW9ucyk6IEZpeCBudW1lcm91cyBtYXJrdXAKICAgICAgICAgICAgaXNzdWVzLiAg QWRkIG1vcmUgbGluZSBicmVha3MgdG8gZXhhbXBsZSBzbyBpdCBkb2Vzbid0IG92ZXJmbG93 CiAgICAgICAgICAgIHRoZSBtYXJnaW5zLgoKZGlmZiAtLWdpdCBhL2djYy9kb2MvZXh0ZW5k LnRleGkgYi9nY2MvZG9jL2V4dGVuZC50ZXhpCmluZGV4IDM5ZDQ1ZGY4ZDg5Li44ZWNkOTYx MTIwMSAxMDA2NDQKLS0tIGEvZ2NjL2RvYy9leHRlbmQudGV4aQorKysgYi9nY2MvZG9jL2V4 dGVuZC50ZXhpCkBAIC0xNTcxNSwyMyArMTU3MTUsMjMgQEAgdm9pZCBfX2J1aWx0aW5fYmZp bl9zc3luYyAodm9pZCk7CiAKIFRoZSBmb2xsb3dpbmcgYnVpbHQtaW4gZnVuY3Rpb25zIGFy ZSBhdmFpbGFibGUgZm9yIGVCUEYgdGFyZ2V0cy4KIAotQGRlZnR5cGVmbiB7QnVpbHQtaW4g RnVuY3Rpb259IHVuc2lnbmVkIGxvbmcgbG9uZyBfX2J1aWx0aW5fYnBmX2xvYWRfYnl0ZSAo dW5zaWduZWQgbG9uZyBsb25nIEB2YXJ7b2Zmc2V0fSkKK0BkZWZ0eXBlZm4ge0J1aWx0LWlu IEZ1bmN0aW9ufSB7dW5zaWduZWQgbG9uZyBsb25nfSBfX2J1aWx0aW5fYnBmX2xvYWRfYnl0 ZSAodW5zaWduZWQgbG9uZyBsb25nIEB2YXJ7b2Zmc2V0fSkKIExvYWQgYSBieXRlIGZyb20g dGhlIEBjb2Rle3N0cnVjdCBza19idWZmfSBwYWNrZXQgZGF0YSBwb2ludGVkIGJ5IHRoZSBy ZWdpc3RlciBAY29kZXslcjZ9IGFuZCByZXR1cm4gaXQuCiBAZW5kIGRlZnR5cGVmbgogCi1A ZGVmdHlwZWZuIHtCdWlsdC1pbiBGdW5jdGlvbn0gdW5zaWduZWQgbG9uZyBsb25nIF9fYnVp bHRpbl9icGZfbG9hZF9oYWxmICh1bnNpZ25lZCBsb25nIGxvbmcgQHZhcntvZmZzZXR9KQot TG9hZCAxNi1iaXRzIGZyb20gdGhlIEBjb2Rle3N0cnVjdCBza19idWZmfSBwYWNrZXQgZGF0 YSBwb2ludGVkIGJ5IHRoZSByZWdpc3RlciBAY29kZXslcjZ9IGFuZCByZXR1cm4gaXQuCitA ZGVmdHlwZWZuIHtCdWlsdC1pbiBGdW5jdGlvbn0ge3Vuc2lnbmVkIGxvbmcgbG9uZ30gX19i dWlsdGluX2JwZl9sb2FkX2hhbGYgKHVuc2lnbmVkIGxvbmcgbG9uZyBAdmFye29mZnNldH0p CitMb2FkIDE2IGJpdHMgZnJvbSB0aGUgQGNvZGV7c3RydWN0IHNrX2J1ZmZ9IHBhY2tldCBk YXRhIHBvaW50ZWQgYnkgdGhlIHJlZ2lzdGVyIEBjb2RleyVyNn0gYW5kIHJldHVybiBpdC4K IEBlbmQgZGVmdHlwZWZuCiAKLUBkZWZ0eXBlZm4ge0J1aWx0LWluIEZ1bmN0aW9ufSB1bnNp Z25lZCBsb25nIGxvbmcgX19idWlsdGluX2JwZl9sb2FkX3dvcmQgKHVuc2lnbmVkIGxvbmcg bG9uZyBAdmFye29mZnNldH0pCi1Mb2FkIDMyLWJpdHMgZnJvbSB0aGUgQGNvZGV7c3RydWN0 IHNrX2J1ZmZ9IHBhY2tldCBkYXRhIHBvaW50ZWQgYnkgdGhlIHJlZ2lzdGVyIEBjb2RleyVy Nn0gYW5kIHJldHVybiBpdC4KK0BkZWZ0eXBlZm4ge0J1aWx0LWluIEZ1bmN0aW9ufSB7dW5z aWduZWQgbG9uZyBsb25nfSBfX2J1aWx0aW5fYnBmX2xvYWRfd29yZCAodW5zaWduZWQgbG9u ZyBsb25nIEB2YXJ7b2Zmc2V0fSkKK0xvYWQgMzIgYml0cyBmcm9tIHRoZSBAY29kZXtzdHJ1 Y3Qgc2tfYnVmZn0gcGFja2V0IGRhdGEgcG9pbnRlZCBieSB0aGUgcmVnaXN0ZXIgQGNvZGV7 JXI2fSBhbmQgcmV0dXJuIGl0LgogQGVuZCBkZWZ0eXBlZm4KIAotQGRlZnR5cGVmbiB7QnVp bHQtaW4gRnVuY3Rpb259IHZvaWQgKiBfX2J1aWx0aW5fcHJlc2VydmVfYWNjZXNzX2luZGV4 IChAdmFye2V4cHJ9KQorQGRlZnR5cGVmbiB7QnVpbHQtaW4gRnVuY3Rpb259IHt2b2lkICp9 IF9fYnVpbHRpbl9wcmVzZXJ2ZV9hY2Nlc3NfaW5kZXggKEB2YXJ7ZXhwcn0pCiBCUEYgQ29t cGlsZSBPbmNlLVJ1biBFdmVyeXdoZXJlIChDTy1SRSkgc3VwcG9ydC4gSW5zdHJ1Y3QgR0ND IHRvIGdlbmVyYXRlIENPLVJFIHJlbG9jYXRpb24gcmVjb3JkcyBmb3IgYW55IGFjY2Vzc2Vz IHRvIGFnZ3JlZ2F0ZSBkYXRhIHN0cnVjdHVyZXMgKHN0cnVjdCwgdW5pb24sIGFycmF5IHR5 cGVzKSBpbiBAdmFye2V4cHJ9LiBUaGlzIGJ1aWx0aW4gaXMgb3RoZXJ3aXNlIHRyYW5zcGFy ZW50LCB0aGUgcmV0dXJuIHZhbHVlIGlzIHdoYXRldmVyIEB2YXJ7ZXhwcn0gZXZhbHVhdGVz IHRvLiBJdCBpcyBhbHNvIG92ZXJsb2FkZWQ6IEB2YXJ7ZXhwcn0gbWF5IGJlIG9mIGFueSB0 eXBlIChub3QgbmVjZXNzYXJpbHkgYSBwb2ludGVyKSwgdGhlIHJldHVybiB0eXBlIGlzIHRo ZSBzYW1lLiBIYXMgbm8gZWZmZWN0IGlmIEBjb2Rley1tY28tcmV9IGlzIG5vdCBpbiBlZmZl Y3QgKGVpdGhlciBzcGVjaWZpZWQgb3IgaW1wbGllZCkuCiBAZW5kIGRlZnR5cGVmbgogCi1A ZGVmdHlwZWZuIHtCdWlsdC1pbiBGdW5jdGlvbn0gdW5zaWduZWQgaW50IF9fYnVpbHRpbl9w cmVzZXJ2ZV9maWVsZF9pbmZvIChAdmFye2V4cHJ9LCB1bnNpZ25lZCBpbnQgQHZhcntraW5k fSkKK0BkZWZ0eXBlZm4ge0J1aWx0LWluIEZ1bmN0aW9ufSB7dW5zaWduZWQgaW50fSBfX2J1 aWx0aW5fcHJlc2VydmVfZmllbGRfaW5mbyAoQHZhcntleHByfSwgdW5zaWduZWQgaW50IEB2 YXJ7a2luZH0pCiBCUEYgQ29tcGlsZSBPbmNlLVJ1biBFdmVyeXdoZXJlIChDTy1SRSkgc3Vw cG9ydC4gVGhpcyBidWlsdGluIGlzIHVzZWQgdG8KIGV4dHJhY3QgaW5mb3JtYXRpb24gdG8g YWlkIGluIHN0cnVjdC91bmlvbiByZWxvY2F0aW9ucy4gIEB2YXJ7ZXhwcn0gaXMKIGFuIGFj Y2VzcyB0byBhIGZpZWxkIG9mIGEgc3RydWN0IG9yIHVuaW9uLiBEZXBlbmRpbmcgb24gQHZh cntraW5kfSwgZGlmZmVyZW50CkBAIC0xNTczOSwxNSArMTU3MzksMTUgQEAgaW5mb3JtYXRp b24gaXMgcmV0dXJuZWQgdG8gdGhlIHByb2dyYW0uIEEgQ08tUkUgcmVsb2NhdGlvbiBmb3Ig dGhlIGFjY2VzcyBpbgogQHZhcntleHByfSB3aXRoIGtpbmQgQHZhcntraW5kfSBpcyByZWNv cmRlZCBpZiBAY29kZXstbWNvLXJlfSBpcyBpbiBlZmZlY3QuCiAKIFRoZSBmb2xsb3dpbmcg dmFsdWVzIGFyZSBzdXBwb3J0ZWQgZm9yIEB2YXJ7a2luZH06Ci1AdGFibGUgQHZhcgorQHRh YmxlIEBjb2RlCiBAaXRlbSBGSUVMRF9CWVRFX09GRlNFVCA9IDAKIFRoZSByZXR1cm5lZCB2 YWx1ZSBpcyB0aGUgb2Zmc2V0LCBpbiBieXRlcywgb2YgdGhlIGZpZWxkIGZyb20gdGhlCi1i ZWdpbm5pbmcgb2YgdGhlIGNvbnRhaW5pbmcgc3RydWN0dXJlLiBGb3IgYml0ZmllbGRzLCB0 aGUgYnl0ZSBvZmZzZXQKK2JlZ2lubmluZyBvZiB0aGUgY29udGFpbmluZyBzdHJ1Y3R1cmUu IEZvciBiaXQtZmllbGRzLCB0aGlzIGlzIHRoZSBieXRlIG9mZnNldAogb2YgdGhlIGNvbnRh aW5pbmcgd29yZC4KIAogQGl0ZW0gRklFTERfQllURV9TSVpFID0gMQotVGhlIHJldHVybmVk IHZhbHVlIGlzIHRoZSBzaXplLCBpbiBieXRlcywgb2YgdGhlIGZpZWxkLiBGb3IgYml0Zmll bGRzLAotdGhlIHNpemUgaW4gYnl0ZXMgb2YgdGhlIGNvbnRhaW5pbmcgd29yZC4KK1RoZSBy ZXR1cm5lZCB2YWx1ZSBpcyB0aGUgc2l6ZSwgaW4gYnl0ZXMsIG9mIHRoZSBmaWVsZC4gRm9y IGJpdC1maWVsZHMsCit0aGlzIGlzIHRoZSBzaXplIGluIGJ5dGVzIG9mIHRoZSBjb250YWlu aW5nIHdvcmQuCiAKIEBpdGVtIEZJRUxEX0VYSVNURU5DRSA9IDIKIFRoZSByZXR1cm5lZCB2 YWx1ZSBpcyAxIGlmIHRoZSBmaWVsZCBleGlzdHMsIDAgb3RoZXJ3aXNlLiBBbHdheXMgMSBh dApAQCAtMTU3NTksMjUgKzE1NzU5LDI2IEBAIFRoZSByZXR1cm5lZCB2YWx1ZSBpcyAxIGlm IHRoZSBmaWVsZCBpcyBzaWduZWQsIDAgb3RoZXJ3aXNlLgogQGl0ZW0gRklFTERfTFNISUZU X1U2NCA9IDQKIEBpdGVteCBGSUVMRF9SU0hJRlRfVTY0ID0gNQogVGhlIHJldHVybmVkIHZh bHVlIGlzIHRoZSBudW1iZXIgb2YgYml0cyBvZiBsZWZ0LSBvciByaWdodC1zaGlmdGluZwot cmVzcGVjdGl2ZWx5IG5lZWRlZCBpbiBvcmRlciB0byByZWNvdmVyIHRoZSBvcmlnaW5hbCB2 YWx1ZSBvZiB0aGUgZmllbGQsCi1hZnRlciBpdCBoYXMgYmVlbiBsb2FkZWQgYnkgYSByZWFk IG9mIEZJRUxEX0JZVEVfU0laRSBieXRlcyBpbnRvIGFuCi11bnNpZ25lZCA2NC1iaXQgdmFs dWUuIFByaW1hcmlseSB1c2VmdWwgZm9yIHJlYWRpbmcgYml0ZmllbGQgdmFsdWVzCi1mcm9t IHN0cnVjdHVyZXMgd2hpY2ggbWF5IGNoYW5nZSBiZXR3ZWVuIGtlcm5lbCB2ZXJzaW9ucy4K KyhyZXNwZWN0aXZlbHkpIG5lZWRlZCBpbiBvcmRlciB0byByZWNvdmVyIHRoZSBvcmlnaW5h bCB2YWx1ZSBvZiB0aGUgZmllbGQsCithZnRlciBpdCBoYXMgYmVlbiBsb2FkZWQgYnkgYSBy ZWFkIG9mIEBjb2Rle0ZJRUxEX0JZVEVfU0laRX0gYnl0ZXMgaW50byBhbgordW5zaWduZWQg NjQtYml0IHZhbHVlLiBQcmltYXJpbHkgdXNlZnVsIGZvciByZWFkaW5nIGJpdC1maWVsZCB2 YWx1ZXMKK2Zyb20gc3RydWN0dXJlcyB0aGF0IG1heSBjaGFuZ2UgYmV0d2VlbiBrZXJuZWwg dmVyc2lvbnMuCiAKIEBlbmQgdGFibGUKIAogTm90ZSB0aGF0IHRoZSByZXR1cm4gdmFsdWUg aXMgYSBjb25zdGFudCB3aGljaCBpcyBrbm93biBhdAotY29tcGlsZS10aW1lLiBJZiB0aGUg ZmllbGQgaGFzIGEgdmFyaWFibGUgb2Zmc2V0IHRoZW4KLUZJRUxEX0JZVEVfT0ZGU0VULCBG SUVMRF9MU0hJRlRfVTY0IGFuZCBGSUVMRF9SU0hJRlRfVTY0IGFyZSBub3QKLXN1cHBvcnRl ZC4gU2ltaWxhcmx5LCBpZiB0aGUgZmllbGQgaGFzIGEgdmFyaWFibGUgc2l6ZSB0aGVuCi1G SUVMRF9CWVRFX1NJWkUsIEZJRUxEX0xTSElGVF9VNjQgYW5kIEZJRUxEX1JTSElGVF9VNjQg YXJlIG5vdAotc3VwcG9ydGVkLgotCi1Gb3IgZXhhbXBsZSwgX19idWlsdGluX3ByZXNlcnZl X2ZpZWxkX2luZm8gY2FuIGJlIHVzZWQgdG8gcmVsaWFibHkKLWV4dHJhY3QgYml0ZmllbGQg dmFsdWVzIGZyb20gYSBzdHJ1Y3R1cmUgd2hpY2ggbWF5IGNoYW5nZSBiZXR3ZWVuCitjb21w aWxlIHRpbWUuIElmIHRoZSBmaWVsZCBoYXMgYSB2YXJpYWJsZSBvZmZzZXQgdGhlbgorQGNv ZGV7RklFTERfQllURV9PRkZTRVR9LCBAY29kZXtGSUVMRF9MU0hJRlRfVTY0fSwKK2FuZCBA Y29kZXtGSUVMRF9SU0hJRlRfVTY0fSBhcmUgbm90IHN1cHBvcnRlZC4KK1NpbWlsYXJseSwg aWYgdGhlIGZpZWxkIGhhcyBhIHZhcmlhYmxlIHNpemUgdGhlbgorQGNvZGV7RklFTERfQllU RV9TSVpFfSwgQGNvZGV7RklFTERfTFNISUZUX1U2NH0sCithbmQgQGNvZGV7RklFTERfUlNI SUZUX1U2NH0gYXJlIG5vdCBzdXBwb3J0ZWQuCisKK0ZvciBleGFtcGxlLCBAY29kZXtfX2J1 aWx0aW5fcHJlc2VydmVfZmllbGRfaW5mb30gY2FuIGJlIHVzZWQgdG8gcmVsaWFibHkKK2V4 dHJhY3QgYml0LWZpZWxkIHZhbHVlcyBmcm9tIGEgc3RydWN0dXJlIHRoYXQgbWF5IGNoYW5n ZSBiZXR3ZWVuCiBrZXJuZWwgdmVyc2lvbnM6CiAKLUBleGFtcGxlCitAc21hbGxleGFtcGxl CiBzdHJ1Y3QgUwogQHsKICAgc2hvcnQgYTsKQEAgLTE1Nzg5LDggKzE1NzkwLDEwIEBAIGlu dAogcmVhZF95IChzdHJ1Y3QgUyAqYXJnKQogQHsKICAgdW5zaWduZWQgbG9uZyBsb25nIHZh bDsKLSAgdW5zaWduZWQgaW50IG9mZnNldCA9IF9fYnVpbHRpbl9wcmVzZXJ2ZV9maWVsZF9p bmZvIChhcmctPnksIEZJRUxEX0JZVEVfT0ZGU0VUKTsKLSAgdW5zaWduZWQgaW50IHNpemUg PSBfX2J1aWx0aW5fcHJlc3J2ZV9maWVsZF9pbmZvIChhcmctPnksIEZJRUxEX0JZVEVfU0la RSk7CisgIHVuc2lnbmVkIGludCBvZmZzZXQKKyAgICA9IF9fYnVpbHRpbl9wcmVzZXJ2ZV9m aWVsZF9pbmZvIChhcmctPnksIEZJRUxEX0JZVEVfT0ZGU0VUKTsKKyAgdW5zaWduZWQgaW50 IHNpemUKKyAgICA9IF9fYnVpbHRpbl9wcmVzZXJ2ZV9maWVsZF9pbmZvIChhcmctPnksIEZJ RUxEX0JZVEVfU0laRSk7CiAKICAgLyogUmVhZCBzaXplIGJ5dGVzIGZyb20gYXJnICsgb2Zm c2V0IGludG8gdmFsLiAgKi8KICAgYnBmX3Byb2JlX3JlYWQgKCZ2YWwsIHNpemUsIGFyZyAr IG9mZnNldCk7CkBAIC0xNTc5OCwxNCArMTU4MDEsMTUgQEAgcmVhZF95IChzdHJ1Y3QgUyAq YXJnKQogICB2YWwgPDw9IF9fYnVpbHRpbl9wcmVzZXJ2ZV9maWVsZF9pbmZvIChhcmctPnks IEZJRUxEX0xTSElGVF9VNjQpOwogCiAgIGlmIChfX2J1aWx0aW5fcHJlc2VydmVfZmllbGRf aW5mbyAoYXJnLT55LCBGSUVMRF9TSUdORURORVNTKSkKLSAgICB2YWwgPSAoKGxvbmcgbG9u ZykgdmFsID4+IF9fYnVpbHRpbl9wcmVzZXJ2ZV9maWVsZF9pbmZvIChhcmctPnksIEZJRUxE X1JTSElGVF9VNjQpKTsKKyAgICB2YWwgPSAoKGxvbmcgbG9uZykgdmFsCisgICAgICAgICAg ID4+IF9fYnVpbHRpbl9wcmVzZXJ2ZV9maWVsZF9pbmZvIChhcmctPnksIEZJRUxEX1JTSElG VF9VNjQpKTsKICAgZWxzZQogICAgIHZhbCA+Pj0gX19idWlsdGluX3ByZXNlcnZlX2ZpZWxk X2luZm8gKGFyZy0+eSwgRklFTERfUlNISUZUX1U2NCk7CiAKICAgcmV0dXJuIHZhbDsKIEB9 CiAKLUBlbmQgZXhhbXBsZQorQGVuZCBzbWFsbGV4YW1wbGUKIEBlbmQgZGVmdHlwZWZuCiAK IEBub2RlIEZSLVYgQnVpbHQtaW4gRnVuY3Rpb25zCg== --------------04I3ZJnmURazpOCZqRlTAQI5--