From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Joe Corneli Newsgroups: gmane.emacs.help Subject: emacs documentation for (La)TeX Date: Sun, 21 Dec 2003 22:13:49 -0600 Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Message-ID: References: <20031220172409.GA2259@miwie.in-berlin.de> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1072066537 6960 80.91.224.253 (22 Dec 2003 04:15:37 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 22 Dec 2003 04:15:37 +0000 (UTC) Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Mon Dec 22 05:15:34 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AYHTi-0001gH-00 for ; Mon, 22 Dec 2003 05:15:34 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AYIQL-0002we-SA for geh-help-gnu-emacs@m.gmane.org; Mon, 22 Dec 2003 00:16:09 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AYIQ2-0002vw-6Q for help-gnu-emacs@gnu.org; Mon, 22 Dec 2003 00:15:50 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AYIPV-0002sa-Uv for help-gnu-emacs@gnu.org; Mon, 22 Dec 2003 00:15:49 -0500 Original-Received: from [146.6.139.124] (helo=dell3.ma.utexas.edu) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AYIPV-0002sO-Bu for help-gnu-emacs@gnu.org; Mon, 22 Dec 2003 00:15:17 -0500 Original-Received: from linux183.ma.utexas.edu (mail@linux183.ma.utexas.edu [146.6.139.172]) by dell3.ma.utexas.edu (8.11.0.Beta3/8.10.2) with ESMTP id hBM4DoB15889; Sun, 21 Dec 2003 22:13:50 -0600 Original-Received: from jcorneli by linux183.ma.utexas.edu with local (Exim 3.36 #1 (Debian)) id 1AYHS1-00061D-00; Sun, 21 Dec 2003 22:13:49 -0600 Original-To: help-gnu-emacs X-all-your-base-are-belong-to-us: You are on the way to destruction. X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.help:15498 X-Report-Spam: http://spam.gmane.org/gmane.emacs.help:15498 I am thinking about trying to use Emacs' self-documenting features to create some "native" documentation for LaTeX. I'm thinking about building this based on the TeX documentation being made available at www.miwie.org What I'm talking about is having something like this for each TeX function: (defun alph () "`\\alph{counter}' This command causes the value of the `counter' to be printed in alphabetic characters. The `\\alph' command uses lower case alphabetic alphabetic characters, i.e., `a, b, c...' while the `\\Alph' command uses upper case alphabetic characters, i.e., `A, B, C...'.") There are certainly some problems here! Upon defining the above "function" and hitting C-f h alph RET, I see this: alph is a Lisp function in `/Users/joe/site-lisp/JOESMACROS.elc'. (alph) `\alph{counter}' This command causes the value of the `counter' to be printed in alphabetic characters. The `\alph' command uses lower case alphabetic alphabetic characters, i.e., `a, b, c...' while the `\Alph' command uses upper case alphabetic characters, i.e., `A, B, C...'. whereas, I 'd like to see something more like this: alph is a TeX function in `'. `\alph{counter}' This command causes the value of the `counter' to be printed in alphabetic characters. The `\alph' command uses lower case alphabetic alphabetic characters, i.e., `a, b, c...' while the `\Alph' command uses upper case alphabetic characters, i.e., `A, B, C...'. Has ever tried to use Emacs' self-documenting features to document another computer language?