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.129.124]) by sourceware.org (Postfix) with ESMTPS id A2F1E385840A for ; Wed, 6 Sep 2023 12:47:08 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org A2F1E385840A Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1694004428; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type; bh=6zED8gtCoNCGMV0i6xptTnjLOjH/W8Lkt/3wO4X3Rf8=; b=EGXqkrDS0mBjw4eFctlOmWdlg8hNNajRaB5C/6iy6w4XK+Q/A+WJ8HFsqtsAQQZid3l3Xq qBCgoYYXhs5AR1LkI7KdcUEWRefJa1Wi4uVQUfijYpmxFmCYmK/rX+RTMnrgkmP/rlnmGl yCPImbEZyR4eYcuZMNGVexiHZbfiJyQ= Received: from mimecast-mx02.redhat.com (mx-ext.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-139-RBvNmvNDMXyNYNvHIR_G3Q-1; Wed, 06 Sep 2023 08:47:06 -0400 X-MC-Unique: RBvNmvNDMXyNYNvHIR_G3Q-1 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id E5FD23C1ACDC for ; Wed, 6 Sep 2023 12:47:05 +0000 (UTC) Received: from oldenburg3.str.redhat.com (unknown [10.39.195.19]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 90454400F5A for ; Wed, 6 Sep 2023 12:47:05 +0000 (UTC) From: Florian Weimer To: libc-alpha@sourceware.org Subject: [PATCH] manual: Fix ld.so diagnostics menu/section structure Date: Wed, 06 Sep 2023 14:47:04 +0200 Message-ID: <87y1hjxyd3.fsf@oldenburg3.str.redhat.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.10 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,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: And shorten the section/node names a bit, so that the menu entries become easier to read. Texinfo 6.5 fails to process the previous structure: ./dynlink.texi:56: warning: node `Dynamic Linker Introspection' is next for `Dynamic Linker Diagnostics' in sectioning but not in menu ./dynlink.texi:56: warning: node up `Dynamic Linker Diagnostics' in menu `Dynamic Linker Invocation' and in sectioning `Dynamic Linker' differ ./dynlink.texi:1: node `Dynamic Linker' lacks menu item for `Dynamic Linker Diagnostics' despite being its Up target ./dynlink.texi:226: warning: node prev `Dynamic Linker Introspection' in menu `Dynamic Linker Invocation' and in sectioning `Dynamic Linker Diagnostics' differ Texinfo 7.0.2 does not report an error. This fixes commit f21962ddfc8bb23e92597da1f98e313dbde11cc1 ("manual: Document ld.so --list-diagnostics output"). --- manual/dynlink.texi | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/manual/dynlink.texi b/manual/dynlink.texi index df41c56bfc..06a6c15533 100644 --- a/manual/dynlink.texi +++ b/manual/dynlink.texi @@ -18,6 +18,7 @@ Dynamic linkers are sometimes called @dfn{dynamic loaders}. @end menu @node Dynamic Linker Invocation +@section Dynamic Linker Invocation @cindex program interpreter When a dynamically linked program starts, the operating system @@ -54,7 +55,7 @@ Print system diagnostic information in a machine-readable format. @end menu @node Dynamic Linker Diagnostics -@section Dynamic Linker Diagnostics +@subsection Dynamic Linker Diagnostics @cindex diagnostics (dynamic linker) The @samp{ld.so --list-diagnostics} produces machine-readable @@ -90,7 +91,13 @@ The built-in dynamic linker search path contains two directories, @code{/lib64} and @code{/usr/lib64}. @end table -@subsection Dynamic Linker Diagnostics Output Format +@menu +* Dynamic Linker Diagnostics Format:: Format of ld.so output. +* Dynamic Linker Diagnostics Values:: Data contain in ld.so output. +@end menu + +@node Dynamic Linker Diagnostics Format +@subsubsection Dynamic Linker Diagnostics Format As seen above, diagnostic lines assign values (integers or strings) to a sequence of labeled subscripts, separated by @samp{.}. Some subscripts @@ -132,7 +139,8 @@ subscript = label [index] line = subscript *("." subscript) "=" value @end smallexample -@subsection Dynamic Linker Diagnostics Values +@node Dynamic Linker Diagnostics Values +@subsubsection Dynamic Linker Diagnostics Values As mentioned above, the set of diagnostics may change between @theglibc{} releases. Nevertheless, the following table documents a few base-commit: 3bf7bab88b0da01d4f5ef20afbbb45203185501e