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: Please add comments to isearch.el Date: Sun, 29 Nov 2015 18:34:16 +0200 Message-ID: <83fuzoojcn.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1448814891 27743 80.91.229.3 (29 Nov 2015 16:34:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 29 Nov 2015 16:34:51 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Nov 29 17:34:41 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 1a34vv-0001qc-Ex for ged-emacs-devel@m.gmane.org; Sun, 29 Nov 2015 17:34:39 +0100 Original-Received: from localhost ([::1]:36888 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a34vz-0001WT-GM for ged-emacs-devel@m.gmane.org; Sun, 29 Nov 2015 11:34:43 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35725) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a34vn-0001WN-0N for emacs-devel@gnu.org; Sun, 29 Nov 2015 11:34:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a34vj-0005kb-OG for emacs-devel@gnu.org; Sun, 29 Nov 2015 11:34:30 -0500 Original-Received: from mtaout25.012.net.il ([80.179.55.181]:48493) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a34vj-0005kX-G0 for emacs-devel@gnu.org; Sun, 29 Nov 2015 11:34:27 -0500 Original-Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0NYL00L004IBT000@mtaout25.012.net.il> for emacs-devel@gnu.org; Sun, 29 Nov 2015 18:31:37 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NYL00EHX4KNQ860@mtaout25.012.net.il> for emacs-devel@gnu.org; Sun, 29 Nov 2015 18:31:37 +0200 (IST) 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.181 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:195550 Archived-At: Would someone "in the know" please add commentary to isearch.el to explain how the various options are passed to the commands defined there and affect or not affect them? The isearch.el commands are implemented using complex multi-layered system of functions and macros that make it very hard to figure out, just by looking at the code, which options affect what commands and in what ways. About the only way to find that out is by trying each command, which is very inefficient. I think it will help make this file much more maintainable if commentary were added there explaining how all of this works. Thanks in advance.