sxemacs-devel
[Top] [All Lists]

Re: Lisp primitive doc strings

From: Steve Youngs <steve@xxxxxxxxxxx>
Subject: Re: Lisp primitive doc strings
Date: Sun, 19 Dec 2004 12:59:50 +1000
Organization: The SXEmacs Project
User-agent: Gnus/5.110003 (No Gnus v0.3) sxemacs/22.1
* Steve Youngs <steve@xxxxxxxxxxx> writes:

  > ,----
  > | void complex_vars_of_emacs(void)
  > | {
  > |   /* This is all related to path searching. */
  > | 
  > |   DEFVAR_LISP("emacs-program-name", &Vemacs_program_name /*
  > | *Name of the Emacs variant.
  > | For example, this may be \"sxemacs\" or \"infodock\".
  > | This is mainly meant for use in path searching.
  > |                                                          */ );
  > `----

  > The same problem is present for these as is for the DEFUN's (the
  > whitespace breakage), but the mechanism of extracting the doc strings
  > is too limited (in my book, broken) to find them.

  > Why?

  > Because if the `DEFVAR_LISP' is more than 2 chars from column zero, it
  > doesn't get found. Which means that _all_ of the built-in variables
  > show up as "not documented as a variable".  Bad bad bad.  This is
  > annoying because I really don't want to compromise on coding style.

  > I was wondering if one of you C gurus (hello Evgeny) could take a
  > look at `lib-src/make-docfile.c' and see what we can do about this.

Can anyone suggest any solutions to this?  Please.  It is very
important. 

-- 
|---<Steve Youngs>---------------<GnuPG KeyID: A94B3003>---|
|                        In space,                         |
|             No one can hear you rip a stinky             |
|------------------------------------<steve@xxxxxxxxxxx>---|

Attachment: pgpDDciLJx7zF.pgp
Description: PGP signature

<Prev in Thread] Current Thread [Next in Thread>