From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chris Feng Newsgroups: gmane.emacs.devel Subject: Re: Improving input-methods docs Date: Fri, 2 Oct 2015 13:23:06 +0800 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1443763399 13139 80.91.229.3 (2 Oct 2015 05:23:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 2 Oct 2015 05:23:19 +0000 (UTC) Cc: handa@etl.go.jp, emacs-devel To: Rustom Mody Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 02 07:23:18 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 1ZhsoQ-0006YN-1a for ged-emacs-devel@m.gmane.org; Fri, 02 Oct 2015 07:23:18 +0200 Original-Received: from localhost ([::1]:57570 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZhsoK-0001s8-6W for ged-emacs-devel@m.gmane.org; Fri, 02 Oct 2015 01:23:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58008) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZhsoG-0001rz-Ac for emacs-devel@gnu.org; Fri, 02 Oct 2015 01:23:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZhsoF-0008Lm-GR for emacs-devel@gnu.org; Fri, 02 Oct 2015 01:23:08 -0400 Original-Received: from mail-wi0-x234.google.com ([2a00:1450:400c:c05::234]:34174) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZhsoF-0008Li-AN for emacs-devel@gnu.org; Fri, 02 Oct 2015 01:23:07 -0400 Original-Received: by wicfx3 with SMTP id fx3so18067089wic.1 for ; Thu, 01 Oct 2015 22:23:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=ux7eNGdUJqLkYQE7WAbMLavBZQ/Xo7R7I2ZzALcx5J4=; b=MLaLKDsoesbUfpj8RSBTe8lWKZ0Ke6h8WXoRVMBUSwZb0YcbzRkcvF2uJgvevY6OwR ApYRdNRG+/BNxjgEnb3d/hSIigutto9r+iKqbjfXcIEsQWmD7jJgoBeWscgIOQUMgRTN 6Jpy+I+l9AcpKMApQtBhmY3p7+Lg6ePk+4Mm738SC4PrBiqistxGnsH1ndttb1tNvoLx BV7DGLCRsGoOtYprEersLUA6Do4Sk+O7zgrw3VavNKKU1JblmKotzaBAt7D1oGchLlfK Nqr1XUxZfc8Ll5LP6xFBXD7LQqmThBPY59iahjUb3EnP21ySiE6oKWOfTQP8O+CAj8Vz 3BFA== X-Received: by 10.180.188.134 with SMTP id ga6mr2333614wic.34.1443763386395; Thu, 01 Oct 2015 22:23:06 -0700 (PDT) Original-Received: by 10.194.87.136 with HTTP; Thu, 1 Oct 2015 22:23:06 -0700 (PDT) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a00:1450:400c:c05::234 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:190636 Archived-At: > Stefan Monnier wrote (on gnu.emacs.help list): >> Rusi Mody wrote: >> > I see (info "(elisp)input methods") >> > that in emacs including 25, docs are still at >> > >> > | How to define input methods is not yet documented in this manual, >> > | but here we describe how to use them. >> > >> > Is there something I can do (within my capacity!) to move this forward? > >> Start to document what you know? Or try to document what you think >> should be there, and if you don't know what to write because you don't >> know how it works, then ask on emacs-devel. AFAIK to define a new input method it only requires one to register it to `input-method-alist' and feed `input-method-function' a customized function. But it seems most input methods in Emacs are defined as Quail packages, so an intro to `quail-define-package' (and perhaps other parts of Quail) may also be helpful. > Ok > First a basic question: > When I do describe-input-method > I see a lot of stuff 'described' > However unlike describe-function|variable etc that links to the relevant stuff > here there is no such. > > Is there any way to get to the input method (source) from an activated > input-method? You can find most input methods in 'lisp/leim/leim-list.el' as they're registered there. For example, there's a form for the 'TeX' input method indicating that it's actually a Quail package named 'quail/latin-ltx', so its source is in 'lisp/leim/quail/latin-ltx.el'. > Strangely even describe-key shows (say) self-insert-command for "\" in > tex-input-method > which seems strange if not plain wrong. IIUC input methods do not create new key bindings but translate characters, so `describe-key' doesn't make much sense here.