[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lib-src/sorted-doc.c [lexbind]
From: |
Miles Bader |
Subject: |
[Emacs-diffs] Changes to emacs/lib-src/sorted-doc.c [lexbind] |
Date: |
Tue, 14 Oct 2003 19:59:26 -0400 |
Index: emacs/lib-src/sorted-doc.c
diff -c /dev/null emacs/lib-src/sorted-doc.c:1.12.4.1
*** /dev/null Tue Oct 14 19:59:26 2003
--- emacs/lib-src/sorted-doc.c Tue Oct 14 19:59:14 2003
***************
*** 0 ****
--- 1,286 ----
+ /* Give this program DOC-mm.nn.oo as standard input and it outputs to
+ standard output a file of texinfo input containing the doc strings.
+
+ Copyright (C) 1989, 1992, 1994, 1996, 1999, 2000, 2001
+ Free Software Foundation Inc.
+
+ This file is part of GNU Emacs.
+
+ GNU Emacs is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2, or (at your option)
+ any later version.
+
+ GNU Emacs is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with GNU Emacs; see the file COPYING. If not, write to the
+ Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ Boston, MA 02111-1307, USA.
+
+ This version sorts the output by function name. */
+
+ #ifdef HAVE_CONFIG_H
+ #include <config.h>
+ #endif
+
+ #include <stdio.h>
+ #include <ctype.h>
+ #ifndef HAVE_STDLIB_H /* config.h includes stdlib. */
+ extern char *malloc ();
+ #endif
+
+ #define NUL '\0'
+ #define MARKER '\037'
+
+ #define DEBUG 0
+
+ typedef struct line LINE;
+
+ struct line
+ {
+ LINE *next; /* ptr to next or NULL */
+ char *line; /* text of the line */
+ };
+
+ typedef struct docstr DOCSTR;
+
+ struct docstr /* Allocated thing for an entry. */
+ {
+ DOCSTR *next; /* next in the chain */
+ char *name; /* name of the function or var */
+ LINE *first; /* first line of doc text. */
+ char type; /* 'F' for function, 'V' for variable */
+ };
+
+
+ /* Print error message. `s1' is printf control string, `s2' is arg for it. */
+
+ void
+ error (s1, s2)
+ char *s1, *s2;
+ {
+ fprintf (stderr, "sorted-doc: ");
+ fprintf (stderr, s1, s2);
+ fprintf (stderr, "\n");
+ }
+
+ /* Print error message and exit. */
+
+ void
+ fatal (s1, s2)
+ char *s1, *s2;
+ {
+ error (s1, s2);
+ exit (1);
+ }
+
+ /* Like malloc but get fatal error if memory is exhausted. */
+
+ char *
+ xmalloc (size)
+ int size;
+ {
+ char *result = malloc ((unsigned)size);
+ if (result == NULL)
+ fatal ("%s", "virtual memory exhausted");
+ return result;
+ }
+
+ char *
+ xstrdup (str)
+ char * str;
+ {
+ char *buf = xmalloc (strlen (str) + 1);
+ (void) strcpy (buf, str);
+ return (buf);
+ }
+
+ /* Comparison function for qsort to call. */
+
+ int
+ cmpdoc (a, b)
+ DOCSTR **a;
+ DOCSTR **b;
+ {
+ register int val = strcmp ((*a)->name, (*b)->name);
+ if (val) return val;
+ return (*a)->type - (*b)->type;
+ }
+
+
+ enum state
+ {
+ WAITING, BEG_NAME, NAME_GET, BEG_DESC, DESC_GET
+ };
+
+ char *states[] =
+ {
+ "WAITING", "BEG_NAME", "NAME_GET", "BEG_DESC", "DESC_GET"
+ };
+
+ int
+ main ()
+ {
+ register DOCSTR *dp = NULL; /* allocated DOCSTR */
+ register LINE *lp = NULL; /* allocated line */
+ register char *bp; /* ptr inside line buffer */
+ register enum state state = WAITING; /* state at start */
+ int cnt = 0; /* number of DOCSTRs read */
+
+ DOCSTR *docs; /* chain of allocated DOCSTRS */
+ char buf[512]; /* line buffer */
+
+ while (1) /* process one char at a time */
+ {
+ /* this char from the DOCSTR file */
+ register int ch = getchar ();
+
+ /* Beginnings */
+
+ if (state == WAITING)
+ {
+ if (ch == MARKER)
+ state = BEG_NAME;
+ }
+ else if (state == BEG_NAME)
+ {
+ cnt++;
+ if (dp == NULL) /* first dp allocated */
+ {
+ docs = dp = (DOCSTR*) xmalloc (sizeof (DOCSTR));
+ }
+ else /* all the rest */
+ {
+ dp->next = (DOCSTR*) xmalloc (sizeof (DOCSTR));
+ dp = dp->next;
+ }
+ lp = NULL;
+ dp->next = NULL;
+ bp = buf;
+ state = NAME_GET;
+ /* Record whether function or variable. */
+ dp->type = ch;
+ ch = getchar ();
+ }
+ else if (state == BEG_DESC)
+ {
+ if (lp == NULL) /* first line for dp */
+ {
+ dp->first = lp = (LINE*)xmalloc (sizeof (LINE));
+ }
+ else /* continuing lines */
+ {
+ lp->next = (LINE*)xmalloc (sizeof (LINE));
+ lp = lp->next;
+ }
+ lp->next = NULL;
+ bp = buf;
+ state = DESC_GET;
+ }
+
+ /* process gets */
+
+ if (state == NAME_GET || state == DESC_GET)
+ {
+ if (ch != MARKER && ch != '\n' && ch != EOF)
+ {
+ *bp++ = ch;
+ }
+ else /* saving and changing state */
+ {
+ *bp = NUL;
+ bp = xstrdup (buf);
+
+ if (state == NAME_GET)
+ dp->name = bp;
+ else
+ lp->line = bp;
+
+ bp = buf;
+ state = (ch == MARKER) ? BEG_NAME : BEG_DESC;
+ }
+ } /* NAME_GET || DESC_GET */
+ if (ch == EOF)
+ break;
+ }
+
+ {
+ DOCSTR **array;
+ register int i; /* counter */
+
+ /* build array of ptrs to DOCSTRs */
+
+ array = (DOCSTR**)xmalloc (cnt * sizeof (*array));
+ for (dp = docs, i = 0; dp != NULL ; dp = dp->next)
+ array[i++] = dp;
+
+ /* sort the array by name; within each name, by type */
+
+ qsort ((char*)array, cnt, sizeof (DOCSTR*), cmpdoc);
+
+ /* write the output header */
+
+ printf ("\\input texinfo @c -*-texinfo-*-\n");
+ printf ("@setfilename ../info/summary\n");
+ printf ("@settitle Command Summary for GNU Emacs\n");
+ printf ("@finalout\n");
+ printf ("@unnumbered Command Summary for GNU Emacs\n");
+ printf ("@table @asis\n");
+ printf ("\n");
+ printf ("@iftex\n");
+ printf ("@address@hidden@address@hidden");
+ printf ("@address@hidden@address@hidden@ITEM}\n");
+ printf ("@address@hidden cmsy10 scaled @magstephalf\n");
+ printf ("@address@hidden cmmi10 scaled @magstephalf\n");
+ printf ("@address@hidden@char110}}\n"); /* this backslash goes with cmr10
*/
+ printf ("@def|address@hidden@char106}}\n");
+ printf ("@address@hidden@address@hidden");
+ printf ("@address@hidden@address@hidden");
+ printf ("@def<address@hidden@char62}}\n");
+ printf ("@def>address@hidden@char60}}\n");
+ printf ("@chardef@@64\n");
+ printf ("@catcode43=12\n");
+ printf ("@tableindent-0.2in\n");
+ printf ("@end iftex\n");
+
+ /* print each function from the array */
+
+ for (i = 0; i < cnt; i++)
+ {
+ printf ("address@hidden %s @address@hidden",
+ array[i]->type == 'F' ? "Function" : "Variable",
+ array[i]->name);
+
+ for (lp = array[i]->first; lp != NULL ; lp = lp->next)
+ {
+ for (bp = lp->line; *bp; bp++)
+ {
+ /* the characters "@{}" need special treatment */
+ if (*bp == '@' || *bp == '{' || *bp == '}')
+ {
+ putchar('@');
+ }
+ putchar(*bp);
+ }
+ putchar ('\n');
+ }
+ printf("@end display\n");
+ /* Try to avoid a save size overflow in the TeX output
+ routine. */
+ if (i%100 == 0 && i > 0 && i != cnt)
+ printf("address@hidden address@hidden @asis\n");
+ }
+
+ printf ("@end table\n");
+ printf ("@bye\n");
+ }
+
+ return 0;
+ }
+
+ /* arch-tag: ce28f204-1e70-4b34-8210-3d54a5662071
+ (do not change this comment) */
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] Changes to emacs/lib-src/sorted-doc.c [lexbind],
Miles Bader <=