From unknown Thu Aug 14 22:18:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12737: 24.2.50; `help-xref-interned' should not put point on last doc section Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 25 Oct 2012 21:50:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12737 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 12737@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.13512017959857 (code B ref -1); Thu, 25 Oct 2012 21:50:01 +0000 Received: (at submit) by debbugs.gnu.org; 25 Oct 2012 21:49:55 +0000 Received: from localhost ([127.0.0.1]:33809 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TRVJK-0002Yv-Hj for submit@debbugs.gnu.org; Thu, 25 Oct 2012 17:49:54 -0400 Received: from eggs.gnu.org ([208.118.235.92]:41105) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TRVJI-0002Yp-M5 for submit@debbugs.gnu.org; Thu, 25 Oct 2012 17:49:53 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TRVHG-0006v0-8u for submit@debbugs.gnu.org; Thu, 25 Oct 2012 17:47:47 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:44022) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TRVHF-0006uw-Uj for submit@debbugs.gnu.org; Thu, 25 Oct 2012 17:47:45 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40941) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TRVHF-000775-19 for bug-gnu-emacs@gnu.org; Thu, 25 Oct 2012 17:47:45 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TRVHD-0006u3-Sw for bug-gnu-emacs@gnu.org; Thu, 25 Oct 2012 17:47:44 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:41349) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TRVHD-0006sm-Mg for bug-gnu-emacs@gnu.org; Thu, 25 Oct 2012 17:47:43 -0400 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q9PLlec4026304 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Thu, 25 Oct 2012 21:47:41 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q9PLldqT022652 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Thu, 25 Oct 2012 21:47:40 GMT Received: from abhmt101.oracle.com (abhmt101.oracle.com [141.146.116.53]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q9PLldb4023423 for ; Thu, 25 Oct 2012 16:47:39 -0500 Received: from dradamslap1 (/130.35.178.248) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 25 Oct 2012 14:47:39 -0700 From: "Drew Adams" Date: Thu, 25 Oct 2012 14:47:38 -0700 Message-ID: <0D88849F49BF48389C49B1F89E4BACA4@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac2y+lnJ54xvxIQ+Qki2rBHBJKVRjA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -3.4 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.4 (---) `help-xref-interned' provides a help page that includes all of the available doc for a symbol: function, variable, and face - whatever is available. The doc is presented in this order: function, face, var (or function, face, if no var doc). Currently point is placed on the last doc section: the var section (or the face section if no var). This is wrong, IMO. Point should be placed at bob. If it's not clear at bob that there is more than one kind of doc present, then the header should be modified to make this clear, and it should have links to each section. It is disorienting for a user to follow a link and find himself near the end of a doc page with no indication of what the page documents overall. In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600) of 2012-10-22 on DANI-PC Bzr revision: 110618 monnier@iro.umontreal.ca-20121022132928-232zm0fecassmhfb Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -I../../libs/libxpm-3.5.8/include -I../../libs/libxpm-3.5.8/src -I../../libs/libpng-1.4.10 -I../../libs/zlib-1.2.6 -I../../libs/giflib-4.1.4-1/include -I../../libs/jpeg-6b-4/include -I../../libs/tiff-3.8.2-1/include -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2 -I../../libs/gnutls-3.0.16/include -I../../libs/libiconv-1.14-2-mingw32-dev/include' From unknown Thu Aug 14 22:18:34 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12737: 24.2.50; `help-xref-interned' should not put point on last doc section Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 17 Nov 2012 06:51:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12737 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 12737@debbugs.gnu.org Received: via spool by 12737-submit@debbugs.gnu.org id=B12737.135313502511049 (code B ref 12737); Sat, 17 Nov 2012 06:51:02 +0000 Received: (at 12737) by debbugs.gnu.org; 17 Nov 2012 06:50:25 +0000 Received: from localhost ([127.0.0.1]:50057 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZcER-0002s8-Ql for submit@debbugs.gnu.org; Sat, 17 Nov 2012 01:50:24 -0500 Received: from mail-da0-f44.google.com ([209.85.210.44]:37693) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZcEO-0002rz-05 for 12737@debbugs.gnu.org; Sat, 17 Nov 2012 01:50:21 -0500 Received: by mail-da0-f44.google.com with SMTP id h15so1405643dan.3 for <12737@debbugs.gnu.org>; Fri, 16 Nov 2012 22:49:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=XHSZcrOwd7hDJ/qnW036/rVqGymCRIp5UXrMpWctc8k=; b=hCLMJf6MwojD5HyWBedyL3r8JVnjcbzWDy8eMqSO1n+uHEqXSUG3tWvqF/o5fnXWF8 8W3WYJ0cufwDHAnGuUzkToONFzukM9HGJv5aHAlhYM3Rjob4FBb8d3Hj5r+T0hb78jsi SXznjoYbkrsMpl/vYdvx49AWEvz1MW7qGigX402EJczvNLYpCVsigpfnXoNeTh9U88aO cLSs3PGx70opfEkzA9JPhmRwTAYlRTiJ8XBzRrTEJazx7kRCAFBCTU9tcXRUI6TN4kmO 5ETr4bg0mM4lPnyH3EFYi+A2gSaMWnOfzDGMZGwBbBGuEfVw0RnKdV3RraECmVCzCzOx 79vg== Received: by 10.66.84.40 with SMTP id v8mr19327736pay.47.1353134967392; Fri, 16 Nov 2012 22:49:27 -0800 (PST) Received: from ulysses (cm198.gamma83.maxonline.com.sg. [202.156.83.198]) by mx.google.com with ESMTPS id b6sm2350429pav.33.2012.11.16.22.49.24 (version=SSLv3 cipher=OTHER); Fri, 16 Nov 2012 22:49:26 -0800 (PST) From: Chong Yidong References: <0D88849F49BF48389C49B1F89E4BACA4@us.oracle.com> Date: Sat, 17 Nov 2012 14:49:22 +0800 In-Reply-To: <0D88849F49BF48389C49B1F89E4BACA4@us.oracle.com> (Drew Adams's message of "Thu, 25 Oct 2012 14:47:38 -0700") Message-ID: <87haoohggd.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.1 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -0.7 (/) "Drew Adams" writes: > Currently point is placed on the last doc section: the var section (or > the face section if no var). This is wrong, IMO. Point should be > placed at bob. If it's not clear at bob that there is more than one > kind of doc present, then the header should be modified to make this > clear, and it should have links to each section. > > It is disorienting for a user to follow a link and find himself near the > end of a doc page with no indication of what the page documents overall. Agreed. Fixed in trunk. From debbugs-submit-bounces@debbugs.gnu.org Sat Nov 17 01:50:39 2012 Received: (at control) by debbugs.gnu.org; 17 Nov 2012 06:50:39 +0000 Received: from localhost ([127.0.0.1]:50060 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZcEf-0002sX-28 for submit@debbugs.gnu.org; Sat, 17 Nov 2012 01:50:38 -0500 Received: from mail-pb0-f44.google.com ([209.85.160.44]:51511) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZcEd-0002sP-1o for control@debbugs.gnu.org; Sat, 17 Nov 2012 01:50:35 -0500 Received: by mail-pb0-f44.google.com with SMTP id uo1so2321804pbc.3 for ; Fri, 16 Nov 2012 22:49:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type; bh=ludC6DpeOFhFjRMQW9W/hE9vYkwdwz+EpM8I05El8Qc=; b=g1+6O8YWtT7DeLMNNT3sgOjYVVgj6Sx5Qw7zItPEEgGQUfJI2G82+hNn2NQXiLokdj 0crRgYoUwnFWoxuWkBMp4PNacQ5HFasxJj4H7MUcRsvK5Jk6KucWlLW8syzehz3eJjYC RjljHLfdmDY2xJ9uMTeFCTnHnXRI4bMcL2ypAYH2pPFJgWyHiS/IHAlu0b8OzrcfrYh2 NTmMYxeA19JRg9qTjOO+jx10QijOiWUZCRSa2/RmTEOnsy6yjODE753AntHuopUjGhjO 1zzqqgFSRgB8odCIfLHBvNXgMLgrhZHEhv5DWKhBRvjlQxyBoBF4c1xGO19BiI3fPK9e afPA== Received: by 10.66.79.167 with SMTP id k7mr19543400pax.24.1353134983797; Fri, 16 Nov 2012 22:49:43 -0800 (PST) Received: from ulysses (cm198.gamma83.maxonline.com.sg. [202.156.83.198]) by mx.google.com with ESMTPS id mz10sm2478028pbc.37.2012.11.16.22.49.41 (version=SSLv3 cipher=OTHER); Fri, 16 Nov 2012 22:49:42 -0800 (PST) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 12737 Date: Sat, 17 Nov 2012 14:49:39 +0800 Message-ID: <87mwygzpto.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: 0.1 (/) close 12737 thanks