From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: 'xref' should be documented Date: Tue, 28 Apr 2015 18:01:03 +0300 Message-ID: <83zj5suwk0.fsf@gnu.org> References: <83618jx7h2.fsf@gnu.org> <553ECAF6.1030909@yandex.ru> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1430233624 31360 80.91.229.3 (28 Apr 2015 15:07:04 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 28 Apr 2015 15:07:04 +0000 (UTC) Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Apr 28 17:06:53 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Yn760-0003vh-0L for ged-emacs-devel@m.gmane.org; Tue, 28 Apr 2015 17:06:48 +0200 Original-Received: from localhost ([::1]:34043 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Yn75z-0007Td-38 for ged-emacs-devel@m.gmane.org; Tue, 28 Apr 2015 11:06:47 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39610) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Yn70p-0007Jx-IS for emacs-devel@gnu.org; Tue, 28 Apr 2015 11:01:32 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Yn70k-0001ld-1Q for emacs-devel@gnu.org; Tue, 28 Apr 2015 11:01:27 -0400 Original-Received: from mtaout29.012.net.il ([80.179.55.185]:50278) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Yn70j-0001kE-HD for emacs-devel@gnu.org; Tue, 28 Apr 2015 11:01:21 -0400 Original-Received: from conversion-daemon.mtaout29.012.net.il by mtaout29.012.net.il (HyperSendmail v2007.08) id <0NNI00700UYY7V00@mtaout29.012.net.il> for emacs-devel@gnu.org; Tue, 28 Apr 2015 18:00:02 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout29.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NNI0030JUZSKJ20@mtaout29.012.net.il>; Tue, 28 Apr 2015 17:59:52 +0300 (IDT) In-reply-to: <553ECAF6.1030909@yandex.ru> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.185 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:185960 Archived-At: > Date: Tue, 28 Apr 2015 02:49:10 +0300 > From: Dmitry Gutov > > I think it's high time we had the xref facilities documented, both in > the user manual and in the ELisp manual. It's not good for such a > high-profile feature to remain undocumented. > > Thanks for the reminder, but I'd rather the dust settles further around it, first. I think this is a mistake. There are definitely parts of xref that are already stable and won't change -- these could be documented already. There are many shades of gray between having zero documentation and having a 100% complete one. Right now we are very close to zero, which I think is not justified. We could add the parts that are still debated as they settle.