From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: Apologia for bzr Date: Thu, 29 Oct 2020 00:11:30 -0700 (PDT) Message-ID: References: <20140102211452.GA28685@c3po> <83d2k9xx1f.fsf@gnu.org> <87fvp4kdoh.fsf@uwakimon.sk.tsukuba.ac.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25739"; mail-complaints-to="usenet@ciao.gmane.io" Cc: esr@thyrsus.com, kfogel@red-bean.com, Toby Cubitt , emacs-devel@gnu.org To: "Stephen J. Turnbull" , Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Oct 29 08:13:37 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kY27t-0006al-Ot for ged-emacs-devel@m.gmane-mx.org; Thu, 29 Oct 2020 08:13:37 +0100 Original-Received: from localhost ([::1]:37700 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kY27s-0002zb-QJ for ged-emacs-devel@m.gmane-mx.org; Thu, 29 Oct 2020 03:13:36 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59396) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kY26M-0002Xf-5j for emacs-devel@gnu.org; Thu, 29 Oct 2020 03:12:02 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:35648) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kY26J-0004aM-QK; Thu, 29 Oct 2020 03:12:01 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 09T79Frd067318; Thu, 29 Oct 2020 07:11:35 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=+R5Erj7F8mDvClgcTY/Dx/yGKRK3JEGhT/fj6YmVEq0=; b=pGv7h8pL8XZCp4Kk8cLVVRUasqPxeCFSQm487B9+qAsmrCm+Y+8GBxNpwIC1QGJJJTNI ljF/EoBnIh2O1CQwap1JLaHjR1rwQrW1BBzG4WD6VJlA3nr7A0Q0LtkdvEafYTZ/RPRc ELvbEaLC/zOMxOq+ImGVPnh/dM5KMhcV3D6kK+aSbNXCfPUEFJQJvSRn/G8Msphx78jG ttfom/cgKegs0SmHVORq4zmnWwlsm/gOg/WoS3LjaGsduK4nOJFM0RcbHgNlW3y/deDB IXwNfuhGVIGxpf3ZVDCHTT4H2Aex+Rw4mxNnRJd4WyvmCL6orILQT1+KjBIc46nNvSir zg== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 34cc7m3485-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 29 Oct 2020 07:11:35 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 09T76NgA041505; Thu, 29 Oct 2020 07:11:34 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3020.oracle.com with ESMTP id 34cx1sw0yd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 29 Oct 2020 07:11:34 +0000 Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 09T7BV05018198; Thu, 29 Oct 2020 07:11:31 GMT In-Reply-To: <87fvp4kdoh.fsf@uwakimon.sk.tsukuba.ac.jp> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5056.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9788 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 bulkscore=0 suspectscore=0 malwarescore=0 mlxlogscore=999 mlxscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010290049 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9788 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 lowpriorityscore=0 adultscore=0 malwarescore=0 spamscore=0 clxscore=1011 mlxscore=0 suspectscore=0 priorityscore=1501 impostorscore=0 bulkscore=0 phishscore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010290049 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/29 03:11:49 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:258555 Archived-At: >> Anyway, there's a big difference here: in Emacs documentation, >> every term is explained before it is used, and rarely used terms >> have cross-references to where they are described. >=20 > I bet you can dip into any number of Info nodes where the > terms "buffer" and "window" are used without definition. FWIW - I submitted Emacs bug #16333, to request linking first occurrences (in a node) of words that are defined in the Glossary to their definitions. I finally got around to doing this, in my library info+.el. (It could be done for vanilla Emacs too.) ___ https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D16333 https://www.emacswiki.org/emacs/download/info%2b.el