From patchwork Wed Aug 30 23:35:37 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alan Modra X-Patchwork-Id: 137220 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a7d1:0:b0:3f2:4152:657d with SMTP id p17csp4836917vqm; Wed, 30 Aug 2023 16:35:54 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHbK/ljwWbMMqV5QaMhwvgQAIyG3oftTg8L0l9mey59c2IxBC7+OCrxIOEkTALz/7OJNAkE X-Received: by 2002:a17:907:2c75:b0:9a6:2a0:6391 with SMTP id ib21-20020a1709072c7500b009a602a06391mr142383ejc.14.1693438554749; Wed, 30 Aug 2023 16:35:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1693438554; cv=none; d=google.com; s=arc-20160816; b=TuhLtitDtgZBHnLkBg4LrzUVMbgXicPL5rnn0bn1y1GOLyLQQSmsKPUp78UgMhMoWB kzccwdcSPw4cismVRxCihpH70lc+PfRtJE1GhL90Jvq6V/YXewJeUJrCsgQsbTJY/VId 3KnFf4HNYt241KMyTbwl7bns3FTvy1CqgX4f1n0DNDvPE5qtd9ZADuSzacmhGwFngsW0 jAuykdyMg63vYVMKEaasUc+Jx7980KIU21fvsr2EOMsxE6HeEzs8E8HO6HIopA4npK5q eqOuNG46B4EgovP5EtAIvq/JfQxxM+AmgHq2WJ6dcfig9rJsQGz4RpegCc+ZCb9Brhcs xsmA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:reply-to:from:list-subscribe:list-help:list-post :list-archive:list-unsubscribe:list-id:precedence :content-disposition:mime-version:message-id:subject:to:date :dmarc-filter:delivered-to:dkim-signature:dkim-filter; bh=Vff6/DXsVxJkkf00AuoE3Pdg7aR9vP9+peag4qsInHg=; fh=NLxAvL/bDfPg4AGOtxqvQlND8vazkZrNzKLY8+LAbBY=; b=pzHevdrbxs+qkaG1V6MpsKYRhAYXJKCU/0bVT4rRjx2fcTvszH9/S2kKK78jgbpgdV HfP2Rxpav59fEkeLdLg9aE+5Dn5mMY3cDVezVvKiwUlxf58CsyyDYoUPW907OrCKLVE7 39ITt2rwL8njN+PrFRmE14jEz1T6sGWbVUrLijCcp+pJfLPU6M0T4dJn33gtGYkUjyPQ NA/I1kld+lFDjpuPsxnxNXj5RMgWdOj99CMS5OH8Bzc016ueS4bP5YHQhVHU1iWpdJK5 YvzndXrIXFFPsAZ8bEGVox4H5MpPGTsC5+IgyT+mKtmy3hsI9u54VZT6n+Dowpyo6q7P GGuA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@sourceware.org header.s=default header.b=LEZFuBIM; spf=pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="binutils-bounces+ouuuleilei=gmail.com@sourceware.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=sourceware.org Received: from server2.sourceware.org (ip-8-43-85-97.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id y2-20020a170906470200b009a169c20cbcsi133211ejq.943.2023.08.30.16.35.54 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 30 Aug 2023 16:35:54 -0700 (PDT) Received-SPF: pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 8.43.85.97 as permitted sender) client-ip=8.43.85.97; Authentication-Results: mx.google.com; dkim=pass header.i=@sourceware.org header.s=default header.b=LEZFuBIM; spf=pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="binutils-bounces+ouuuleilei=gmail.com@sourceware.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C0AC03858418 for ; Wed, 30 Aug 2023 23:35:51 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C0AC03858418 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1693438551; bh=Vff6/DXsVxJkkf00AuoE3Pdg7aR9vP9+peag4qsInHg=; h=Date:To:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=LEZFuBIMOAwmDm7LmP8cwfqwoaEAZRuPkamyI9pfpDk0s7/SjUamcUExJirNV73Rs 0phFsj386WOA9yoK6icax/b55IZ3bqWYuVCTxA+Tx6lC4xrMvIltQMfcE9zdktgmpd 5kFc7W7WEqzqYwJwC2fVeD3khsWZMX+2i5bAWzkI= X-Original-To: binutils@sourceware.org Delivered-To: binutils@sourceware.org Received: from mail-pl1-x635.google.com (mail-pl1-x635.google.com [IPv6:2607:f8b0:4864:20::635]) by sourceware.org (Postfix) with ESMTPS id 0D2F63858418 for ; Wed, 30 Aug 2023 23:35:42 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 0D2F63858418 Received: by mail-pl1-x635.google.com with SMTP id d9443c01a7336-1c0db66af1bso1355265ad.2 for ; Wed, 30 Aug 2023 16:35:41 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693438540; x=1694043340; h=content-disposition:mime-version:message-id:subject:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Vff6/DXsVxJkkf00AuoE3Pdg7aR9vP9+peag4qsInHg=; b=M0iOCsA0gX6R5vkrmeGfM0Sq0C4s9eVCaodDSwXm312Y2IUNUPCnaYSmDtpGeK8D6n rhQtF8lHymgB6Ncy84jpJWJCimoemHUx31VOAwAmLQwA3p/nUQEfjhyZmsNE5z0y1xVj 5FmWaRwsZXsk8ACsEhaxdJAvwKrohLbzCi3G00JpzeOqJvSeOorcMcSCXHaWQt5l5Iaz E6MKfhTdsohp9EJ1yxYz/DmGDGvmaJp7Sx/886gi038Z90+q6OWd76zcbbaGF+H+QdaS hAc674wEmvGAdry83ufdRtwgDXCN+6z0lhVqd92wEr72wzBUXxQtprDP3GVyksA7D2AM F8jw== X-Gm-Message-State: AOJu0YxRD2i8IfQhlBufj30LZW1LmRNlRJnAVWvEYuzYQ4eTZPjdDNeN 3M5R/6QjlChNrrH2RBhRf7vDPkf1Hb4= X-Received: by 2002:a17:902:d4c2:b0:1c1:e5f7:a743 with SMTP id o2-20020a170902d4c200b001c1e5f7a743mr3953097plg.55.1693438540560; Wed, 30 Aug 2023 16:35:40 -0700 (PDT) Received: from squeak.grove.modra.org (158.106.96.58.static.exetel.com.au. [58.96.106.158]) by smtp.gmail.com with ESMTPSA id y23-20020a17090264d700b001a6d4ea7301sm44067pli.251.2023.08.30.16.35.39 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 30 Aug 2023 16:35:40 -0700 (PDT) Received: by squeak.grove.modra.org (Postfix, from userid 1000) id 9EE0F11425B2; Thu, 31 Aug 2023 09:05:37 +0930 (ACST) Date: Thu, 31 Aug 2023 09:05:37 +0930 To: binutils@sourceware.org Subject: libbfd.texi zero size Message-ID: MIME-Version: 1.0 Content-Disposition: inline X-Spam-Status: No, score=-3034.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, 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 X-BeenThere: binutils@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alan Modra via Binutils From: Alan Modra Reply-To: Alan Modra Errors-To: binutils-bounces+ouuuleilei=gmail.com@sourceware.org Sender: "Binutils" X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1775699026065112037 X-GMAIL-MSGID: 1775699026065112037 Pattern rules in doc/local.mk exist that specify how to make libbfd.texi from libfd.h or libbfd.c. Since both files exist and the libbfd.h rule is first, libbfd.h is used. libbfd.h doesn't contain the documentation.. * doc/local.mk (doc/%stamp): Put rule making this from %.c before %.h rule. * Makefile.in: Regenerate. * libbfd.c (Byte swapping routines): Don't omit description. diff --git a/bfd/Makefile.in b/bfd/Makefile.in index bb530271fca..f8bc859e6cf 100644 --- a/bfd/Makefile.in +++ b/bfd/Makefile.in @@ -2489,10 +2489,10 @@ doc/chew.stamp: $(srcdir)/doc/chew.c doc/$(am__dirstamp) .PRECIOUS: doc/%.stamp doc/%.texi: doc/%.stamp ; @true -doc/%.stamp: $(srcdir)/%.h $(srcdir)/doc/doc.str $(MKDOC) doc/$(am__dirstamp) - $(AM_V_GEN)$(REGEN_TEXI) doc/%.stamp: $(srcdir)/%.c $(srcdir)/doc/doc.str $(MKDOC) doc/$(am__dirstamp) $(AM_V_GEN)$(REGEN_TEXI) +doc/%.stamp: $(srcdir)/%.h $(srcdir)/doc/doc.str $(MKDOC) doc/$(am__dirstamp) + $(AM_V_GEN)$(REGEN_TEXI) # Avoid the %.stamp generating a builddir/bfd.texi that overrides the # srcdir/ as well as regenerating doc/bfd.info for each make run. diff --git a/bfd/doc/local.mk b/bfd/doc/local.mk index d80f70416a3..f602e7d947f 100644 --- a/bfd/doc/local.mk +++ b/bfd/doc/local.mk @@ -111,10 +111,10 @@ REGEN_TEXI = \ .PRECIOUS: %D%/%.stamp %D%/%.texi: %D%/%.stamp ; @true -%D%/%.stamp: $(srcdir)/%.h $(srcdir)/%D%/doc.str $(MKDOC) %D%/$(am__dirstamp) - $(AM_V_GEN)$(REGEN_TEXI) %D%/%.stamp: $(srcdir)/%.c $(srcdir)/%D%/doc.str $(MKDOC) %D%/$(am__dirstamp) $(AM_V_GEN)$(REGEN_TEXI) +%D%/%.stamp: $(srcdir)/%.h $(srcdir)/%D%/doc.str $(MKDOC) %D%/$(am__dirstamp) + $(AM_V_GEN)$(REGEN_TEXI) # Avoid the %.stamp generating a builddir/bfd.texi that overrides the # srcdir/ as well as regenerating doc/bfd.info for each make run. diff --git a/bfd/libbfd.c b/bfd/libbfd.c index fafdf49cb04..3c37717f775 100644 --- a/bfd/libbfd.c +++ b/bfd/libbfd.c @@ -728,6 +728,13 @@ SYNOPSIS void bfd_putl16 (bfd_vma, void *); uint64_t bfd_get_bits (const void *, int, bool); void bfd_put_bits (uint64_t, void *, int, bool); + +DESCRIPTION + Read and write integers in a particular endian order. getb + and putb functions handle big-endian, getl and putl handle + little-endian. bfd_get_bits and bfd_put_bits specify + big-endian by passing TRUE in the last parameter, + little-endian by passing FALSE. */ bfd_vma