From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTP id 640C43861838 for ; Thu, 29 Jul 2021 14:36:26 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 640C43861838 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-442-WwxNo29DOqWTPwqZCpyrwg-1; Thu, 29 Jul 2021 10:36:24 -0400 X-MC-Unique: WwxNo29DOqWTPwqZCpyrwg-1 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id BE11F18C89D9; Thu, 29 Jul 2021 14:36:23 +0000 (UTC) Received: from redhat.com (ovpn-112-13.phx2.redhat.com [10.3.112.13]) by smtp.corp.redhat.com (Postfix) with ESMTPS id A184B5D9C6; Thu, 29 Jul 2021 14:36:23 +0000 (UTC) Received: from fche by redhat.com with local (Exim 4.94.2) (envelope-from ) id 1m9794-0002LM-3Z; Thu, 29 Jul 2021 10:36:22 -0400 Date: Thu, 29 Jul 2021 10:36:22 -0400 From: "Frank Ch. Eigler" To: Mark Wielaard Cc: Alice Zhang , elfutils-devel@sourceware.org Subject: Re: [PATCH] debuginfod-doc: PR27950 - Remove redanduncies in man page. Message-ID: <20210729143622.GB4579@redhat.com> References: <20210728194230.298903-1-alizhang@redhat.com> MIME-Version: 1.0 In-Reply-To: User-Agent: Mutt/1.12.0 (2019-05-25) X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=us-ascii Content-Disposition: inline X-Spam-Status: No, score=-6.8 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H4, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: elfutils-devel@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Elfutils-devel mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 29 Jul 2021 14:36:27 -0000 Hi - > Is debuginfod-client-config.7 intended to be installed? If so it should > be added to notrans_dist_man7_MANS in doc/Makefile.am, [...] Yeah. > If it isn't intended to be installed, maybe give it a different suffix > so it isn't confused to be a standalone man page? > > > +.so ./debuginfod-client-config.7 > > So this is intended to include the fragment into the man page? > That also doesn't seem to work for me. How/when does it do the > lookup/inclusion? man/nroff executes the .so directive during rendering, i.e., searches for content in the installed $MANPATH at run time. It is used on other fedora man pages e.g. for command aliases. If we look at man1/builtins.1 and man1/bash.1, they show a bit of this pattern. And actually bash.1 has some conditional inclusion tricks to let the bash.1 page be includable as well as standalone. That same trick could be done within the new debuginfod-client-config.7 file. See the refs to ".ig zZ" and ".zZ", ".nr zZ 1" in the file that contains the .so directive. - FChE