diff options
| author | Glenn Morris | 2012-12-12 20:25:50 -0800 |
|---|---|---|
| committer | Glenn Morris | 2012-12-12 20:25:50 -0800 |
| commit | 98c94021a11107484998b260ade4db0cf295f7a8 (patch) | |
| tree | 20d4e62e6c2bcf0437189fe7ec07f1b6802ec445 /doc | |
| parent | cfa49c1e3385ec06ca12648c494fc1a5a143fb86 (diff) | |
| download | emacs-98c94021a11107484998b260ade4db0cf295f7a8.tar.gz emacs-98c94021a11107484998b260ade4db0cf295f7a8.zip | |
Add bovine manual to build process
* doc/misc/bovine.texi: Small edits. Set copyright to FSF, update license to
GFDL 1.3+, remove empty index.
* doc/misc/Makefile.in (INFO_TARGETS, DVI_TARGETS, PDF_TARGETS): Add bovine.
(bovine, $(buildinfodir)/bovine$(INFO_EXT), bovine.dvi, bovine.pdf):
New targets.
* doc/misc/makefile.w32-in (INFO_TARGETS, DVI_TARGETS, clean): Add bovine.
($(infodir)/bovine$(INFO_EXT), bovine.dvi): New targets.
* info/dir: Add bovine.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/misc/ChangeLog | 10 | ||||
| -rw-r--r-- | doc/misc/Makefile.in | 13 | ||||
| -rw-r--r-- | doc/misc/bovine.texi | 69 | ||||
| -rw-r--r-- | doc/misc/makefile.w32-in | 13 |
4 files changed, 64 insertions, 41 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 3557e27184c..6985439f356 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,13 @@ | |||
| 1 | 2012-12-13 Glenn Morris <rgm@gnu.org> | ||
| 2 | |||
| 3 | * bovine.texi: Small edits. Set copyright to FSF, update license to | ||
| 4 | GFDL 1.3+, remove empty index. | ||
| 5 | * Makefile.in (INFO_TARGETS, DVI_TARGETS, PDF_TARGETS): Add bovine. | ||
| 6 | (bovine, $(buildinfodir)/bovine$(INFO_EXT), bovine.dvi, bovine.pdf): | ||
| 7 | New targets. | ||
| 8 | * makefile.w32-in (INFO_TARGETS, DVI_TARGETS, clean): Add bovine. | ||
| 9 | ($(infodir)/bovine$(INFO_EXT), bovine.dvi): New targets. | ||
| 10 | |||
| 1 | 2012-12-13 Eric Ludlam <zappo@gnu.org> | 11 | 2012-12-13 Eric Ludlam <zappo@gnu.org> |
| 2 | David Ponce <david@dponce.com> | 12 | David Ponce <david@dponce.com> |
| 3 | Richard Kim <emacs18@gmail.com> | 13 | Richard Kim <emacs18@gmail.com> |
diff --git a/doc/misc/Makefile.in b/doc/misc/Makefile.in index ecff9a97d4e..905a81f4d6a 100644 --- a/doc/misc/Makefile.in +++ b/doc/misc/Makefile.in | |||
| @@ -41,7 +41,7 @@ INFO_OPTS=@INFO_OPTS@ | |||
| 41 | MAKEINFO = @MAKEINFO@ | 41 | MAKEINFO = @MAKEINFO@ |
| 42 | MAKEINFO_OPTS = --force -I$(emacsdir) | 42 | MAKEINFO_OPTS = --force -I$(emacsdir) |
| 43 | 43 | ||
| 44 | INFO_TARGETS = ada-mode auth autotype calc ccmode cl \ | 44 | INFO_TARGETS = ada-mode auth autotype bovine calc ccmode cl \ |
| 45 | dbus dired-x ebrowse ede ediff edt eieio \ | 45 | dbus dired-x ebrowse ede ediff edt eieio \ |
| 46 | emacs-mime epa erc ert eshell eudc efaq \ | 46 | emacs-mime epa erc ert eshell eudc efaq \ |
| 47 | flymake forms gnus emacs-gnutls idlwave info.info \ | 47 | flymake forms gnus emacs-gnutls idlwave info.info \ |
| @@ -54,6 +54,7 @@ DVI_TARGETS = \ | |||
| 54 | ada-mode.dvi \ | 54 | ada-mode.dvi \ |
| 55 | auth.dvi \ | 55 | auth.dvi \ |
| 56 | autotype.dvi \ | 56 | autotype.dvi \ |
| 57 | bovine.dvi \ | ||
| 57 | calc.dvi \ | 58 | calc.dvi \ |
| 58 | cc-mode.dvi \ | 59 | cc-mode.dvi \ |
| 59 | cl.dvi \ | 60 | cl.dvi \ |
| @@ -107,6 +108,7 @@ PDF_TARGETS = \ | |||
| 107 | ada-mode.pdf \ | 108 | ada-mode.pdf \ |
| 108 | auth.pdf \ | 109 | auth.pdf \ |
| 109 | autotype.pdf \ | 110 | autotype.pdf \ |
| 111 | bovine.pdf \ | ||
| 110 | calc.pdf \ | 112 | calc.pdf \ |
| 111 | cc-mode.pdf \ | 113 | cc-mode.pdf \ |
| 112 | cl.pdf \ | 114 | cl.pdf \ |
| @@ -220,6 +222,15 @@ autotype.dvi: ${srcdir}/autotype.texi | |||
| 220 | autotype.pdf: ${srcdir}/autotype.texi | 222 | autotype.pdf: ${srcdir}/autotype.texi |
| 221 | $(ENVADD) $(TEXI2PDF) ${srcdir}/autotype.texi | 223 | $(ENVADD) $(TEXI2PDF) ${srcdir}/autotype.texi |
| 222 | 224 | ||
| 225 | bovine : $(buildinfodir)/bovine$(INFO_EXT) | ||
| 226 | $(buildinfodir)/bovine$(INFO_EXT): ${srcdir}/bovine.texi | ||
| 227 | $(mkinfodir) | ||
| 228 | $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ ${srcdir}/bovine.texi | ||
| 229 | bovine.dvi: ${srcdir}/bovine.texi | ||
| 230 | $(ENVADD) $(TEXI2DVI) ${srcdir}/bovine.texi | ||
| 231 | bovine.pdf: ${srcdir}/bovine.texi | ||
| 232 | $(ENVADD) $(TEXI2PDF) ${srcdir}/bovine.texi | ||
| 233 | |||
| 223 | calc : $(buildinfodir)/calc$(INFO_EXT) | 234 | calc : $(buildinfodir)/calc$(INFO_EXT) |
| 224 | $(buildinfodir)/calc$(INFO_EXT): ${srcdir}/calc.texi $(emacsdir)/emacsver.texi | 235 | $(buildinfodir)/calc$(INFO_EXT): ${srcdir}/calc.texi $(emacsdir)/emacsver.texi |
| 225 | $(mkinfodir) | 236 | $(mkinfodir) |
diff --git a/doc/misc/bovine.texi b/doc/misc/bovine.texi index b24e0e0dd7d..a263cadabae 100644 --- a/doc/misc/bovine.texi +++ b/doc/misc/bovine.texi | |||
| @@ -1,6 +1,6 @@ | |||
| 1 | \input texinfo @c -*-texinfo-*- | 1 | \input texinfo @c -*-texinfo-*- |
| 2 | @c %**start of header | 2 | @c %**start of header |
| 3 | @setfilename bovine.info | 3 | @setfilename ../../info/bovine |
| 4 | @set TITLE Bovine parser development | 4 | @set TITLE Bovine parser development |
| 5 | @set AUTHOR Eric M. Ludlam, David Ponce, and Richard Y. Kim | 5 | @set AUTHOR Eric M. Ludlam, David Ponce, and Richard Y. Kim |
| 6 | @settitle @value{TITLE} | 6 | @settitle @value{TITLE} |
| @@ -23,29 +23,26 @@ | |||
| 23 | @c %**end of header | 23 | @c %**end of header |
| 24 | 24 | ||
| 25 | @copying | 25 | @copying |
| 26 | This manual documents Bovine parser development in Semantic | 26 | Copyright @copyright{} 1999-2004, 2012 Free Software Foundation, Inc. |
| 27 | |||
| 28 | Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004 Eric M. Ludlam | ||
| 29 | Copyright @copyright{} 2001, 2002, 2003, 2004 David Ponce | ||
| 30 | Copyright @copyright{} 2002, 2003 Richard Y. Kim | ||
| 31 | 27 | ||
| 32 | @quotation | 28 | @quotation |
| 33 | Permission is granted to copy, distribute and/or modify this document | 29 | Permission is granted to copy, distribute and/or modify this document |
| 34 | under the terms of the GNU Free Documentation License, Version 1.1 or | 30 | under the terms of the GNU Free Documentation License, Version 1.3 or |
| 35 | any later version published by the Free Software Foundation; with the | 31 | any later version published by the Free Software Foundation; with no |
| 36 | Invariant Sections being list their titles, with the Front-Cover Texts | 32 | Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' |
| 37 | being list, and with the Back-Cover Texts being list. A copy of the | 33 | and with the Back-Cover Texts as in (a) below. A copy of the license |
| 38 | license is included in the section entitled ``GNU Free Documentation | 34 | is included in the section entitled ``GNU Free Documentation License''. |
| 39 | License''. | 35 | |
| 36 | (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and | ||
| 37 | modify this GNU manual. Buying copies from the FSF supports it in | ||
| 38 | developing GNU and promoting software freedom.'' | ||
| 40 | @end quotation | 39 | @end quotation |
| 41 | @end copying | 40 | @end copying |
| 42 | 41 | ||
| 43 | @ifinfo | 42 | @dircategory Emacs misc features |
| 44 | @dircategory Emacs | ||
| 45 | @direntry | 43 | @direntry |
| 46 | * Semantic bovine parser development: (bovine). | 44 | * Bovine: (bovine). Semantic bovine parser development. |
| 47 | @end direntry | 45 | @end direntry |
| 48 | @end ifinfo | ||
| 49 | 46 | ||
| 50 | @iftex | 47 | @iftex |
| 51 | @finalout | 48 | @finalout |
| @@ -54,28 +51,19 @@ License''. | |||
| 54 | @c @setchapternewpage odd | 51 | @c @setchapternewpage odd |
| 55 | @c @setchapternewpage off | 52 | @c @setchapternewpage off |
| 56 | 53 | ||
| 57 | @ifinfo | ||
| 58 | This file documents parser development with the bovine parser generator | ||
| 59 | @emph{Infrastructure for parser based text analysis in Emacs} | ||
| 60 | |||
| 61 | Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004 @value{AUTHOR} | ||
| 62 | @end ifinfo | ||
| 63 | |||
| 64 | @titlepage | 54 | @titlepage |
| 65 | @sp 10 | 55 | @sp 10 |
| 66 | @title @value{TITLE} | 56 | @title @value{TITLE} |
| 67 | @author by @value{AUTHOR} | 57 | @author by @value{AUTHOR} |
| 68 | @vskip 0pt plus 1 fill | ||
| 69 | Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004 @value{AUTHOR} | ||
| 70 | @page | 58 | @page |
| 71 | @vskip 0pt plus 1 fill | 59 | @vskip 0pt plus 1 fill |
| 72 | @insertcopying | 60 | @insertcopying |
| 73 | @end titlepage | 61 | @end titlepage |
| 74 | @page | 62 | @page |
| 75 | 63 | ||
| 76 | @c MACRO inclusion | 64 | @macro semantic{} |
| 77 | @include semanticheader.texi | 65 | @i{Semantic} |
| 78 | 66 | @end macro | |
| 79 | 67 | ||
| 80 | @c ************************************************************************* | 68 | @c ************************************************************************* |
| 81 | @c @ Document | 69 | @c @ Document |
| @@ -97,13 +85,17 @@ extension. When compiled, the contents is converted into a file of | |||
| 97 | the form @file{NAME-by.el}. This, in turn is byte compiled. | 85 | the form @file{NAME-by.el}. This, in turn is byte compiled. |
| 98 | @inforef{top, Grammar Framework Manual, grammar-fw}. | 86 | @inforef{top, Grammar Framework Manual, grammar-fw}. |
| 99 | 87 | ||
| 88 | @ifnottex | ||
| 89 | @insertcopying | ||
| 90 | @end ifnottex | ||
| 91 | |||
| 100 | @menu | 92 | @menu |
| 101 | * Starting Rules:: The starting rules for the grammar. | 93 | * Starting Rules:: The starting rules for the grammar. |
| 102 | * Bovine Grammar Rules:: Rules used to parse a language | 94 | * Bovine Grammar Rules:: Rules used to parse a language. |
| 103 | * Optional Lambda Expression:: Actions to take when a rule is matched | 95 | * Optional Lambda Expression:: Actions to take when a rule is matched. |
| 104 | * Bovine Examples:: Simple Samples | 96 | * Bovine Examples:: Simple Samples. |
| 105 | * GNU Free Documentation License:: | 97 | * GNU Free Documentation License:: The license for this documentation. |
| 106 | * Index:: | 98 | @c * Index:: |
| 107 | @end menu | 99 | @end menu |
| 108 | 100 | ||
| 109 | @node Starting Rules | 101 | @node Starting Rules |
| @@ -160,9 +152,9 @@ semantic-appdev}. | |||
| 160 | means that a syntactic token of class @code{FOO} must be matched. | 152 | means that a syntactic token of class @code{FOO} must be matched. |
| 161 | 153 | ||
| 162 | @menu | 154 | @menu |
| 163 | * How Lexical Tokens Match:: | 155 | * How Lexical Tokens Match:: |
| 164 | * Grammar-to-Lisp Details:: | 156 | * Grammar-to-Lisp Details:: |
| 165 | * Order of components in rules:: | 157 | * Order of components in rules:: |
| 166 | @end menu | 158 | @end menu |
| 167 | 159 | ||
| 168 | @node How Lexical Tokens Match | 160 | @node How Lexical Tokens Match |
| @@ -462,11 +454,14 @@ which would return | |||
| 462 | @node GNU Free Documentation License | 454 | @node GNU Free Documentation License |
| 463 | @appendix GNU Free Documentation License | 455 | @appendix GNU Free Documentation License |
| 464 | 456 | ||
| 465 | @include fdl.texi | 457 | @include doclicense.texi |
| 466 | 458 | ||
| 459 | @c There is nothing to index at the moment. | ||
| 460 | @ignore | ||
| 467 | @node Index | 461 | @node Index |
| 468 | @unnumbered Index | 462 | @unnumbered Index |
| 469 | @printindex cp | 463 | @printindex cp |
| 464 | @end ignore | ||
| 470 | 465 | ||
| 471 | @iftex | 466 | @iftex |
| 472 | @contents | 467 | @contents |
diff --git a/doc/misc/makefile.w32-in b/doc/misc/makefile.w32-in index d8054ce62fe..0213ce97cce 100644 --- a/doc/misc/makefile.w32-in +++ b/doc/misc/makefile.w32-in | |||
| @@ -55,7 +55,7 @@ INFO_TARGETS = $(infodir)/ccmode$(INFO_EXT) \ | |||
| 55 | $(infodir)/epa$(INFO_EXT) $(infodir)/mairix-el$(INFO_EXT) $(infodir)/sasl$(INFO_EXT) \ | 55 | $(infodir)/epa$(INFO_EXT) $(infodir)/mairix-el$(INFO_EXT) $(infodir)/sasl$(INFO_EXT) \ |
| 56 | $(infodir)/auth$(INFO_EXT) $(infodir)/eieio$(INFO_EXT) $(infodir)/ede$(INFO_EXT) \ | 56 | $(infodir)/auth$(INFO_EXT) $(infodir)/eieio$(INFO_EXT) $(infodir)/ede$(INFO_EXT) \ |
| 57 | $(infodir)/semantic$(INFO_EXT) $(infodir)/edt$(INFO_EXT) $(infodir)/emacs-gnutls$(INFO_EXT) \ | 57 | $(infodir)/semantic$(INFO_EXT) $(infodir)/edt$(INFO_EXT) $(infodir)/emacs-gnutls$(INFO_EXT) \ |
| 58 | $(infodir)/srecode$(INFO_EXT) | 58 | $(infodir)/srecode$(INFO_EXT) $(infodir)/bovine$(INFO_EXT) |
| 59 | DVI_TARGETS = calc.dvi cc-mode.dvi cl.dvi dbus.dvi dired-x.dvi \ | 59 | DVI_TARGETS = calc.dvi cc-mode.dvi cl.dvi dbus.dvi dired-x.dvi \ |
| 60 | ediff.dvi forms.dvi gnus.dvi message.dvi emacs-mime.dvi \ | 60 | ediff.dvi forms.dvi gnus.dvi message.dvi emacs-mime.dvi \ |
| 61 | sieve.dvi pgg.dvi mh-e.dvi \ | 61 | sieve.dvi pgg.dvi mh-e.dvi \ |
| @@ -66,7 +66,7 @@ DVI_TARGETS = calc.dvi cc-mode.dvi cl.dvi dbus.dvi dired-x.dvi \ | |||
| 66 | newsticker.dvi rcirc.dvi erc.dvi ert.dvi \ | 66 | newsticker.dvi rcirc.dvi erc.dvi ert.dvi \ |
| 67 | remember.dvi nxml-mode.dvi \ | 67 | remember.dvi nxml-mode.dvi \ |
| 68 | epa.dvi mairix-el.dvi sasl.dvi auth.dvi eieio.dvi ede.dvi \ | 68 | epa.dvi mairix-el.dvi sasl.dvi auth.dvi eieio.dvi ede.dvi \ |
| 69 | semantic.dvi edt.dvi emacs-gnutls.dvi srecode.dvi | 69 | semantic.dvi edt.dvi emacs-gnutls.dvi srecode.dvi bovine.dvi |
| 70 | INFOSOURCES = info.texi | 70 | INFOSOURCES = info.texi |
| 71 | 71 | ||
| 72 | # The following rule does not work with all versions of `make'. | 72 | # The following rule does not work with all versions of `make'. |
| @@ -364,6 +364,12 @@ $(infodir)/srecode$(INFO_EXT): srecode.texi doclicense.texi | |||
| 364 | srecode.dvi: srecode.texi doclicense.texi | 364 | srecode.dvi: srecode.texi doclicense.texi |
| 365 | $(ENVADD) $(TEXI2DVI) $(srcdir)/srecode.texi | 365 | $(ENVADD) $(TEXI2DVI) $(srcdir)/srecode.texi |
| 366 | 366 | ||
| 367 | $(infodir)/bovine$(INFO_EXT): bovine.texi doclicense.texi | ||
| 368 | $(MAKEINFO) $(MAKEINFO_OPTS) $(INFO_OPTS) -o $@ bovine.texi | ||
| 369 | bovine.dvi: bovine.texi doclicense.texi | ||
| 370 | $(ENVADD) $(TEXI2DVI) $(srcdir)/bovine.texi | ||
| 371 | |||
| 372 | |||
| 367 | mostlyclean: | 373 | mostlyclean: |
| 368 | - $(DEL) *.log *.cp *.fn *.ky *.pg *.vr core *.tp *.core gnustmp.* | 374 | - $(DEL) *.log *.cp *.fn *.ky *.pg *.vr core *.tp *.core gnustmp.* |
| 369 | 375 | ||
| @@ -392,7 +398,8 @@ clean: mostlyclean | |||
| 392 | $(infodir)/mairix-el* $(infodir)/auth* \ | 398 | $(infodir)/mairix-el* $(infodir)/auth* \ |
| 393 | $(infodir)/eieio* $(infodir)/ede* \ | 399 | $(infodir)/eieio* $(infodir)/ede* \ |
| 394 | $(infodir)/semantic* $(infodir)edt* \ | 400 | $(infodir)/semantic* $(infodir)edt* \ |
| 395 | $(infodir)/emacs-gnutls* $(infodir)/srecode* | 401 | $(infodir)/emacs-gnutls* $(infodir)/srecode* \ |
| 402 | $(infodir)/bovine* | ||
| 396 | 403 | ||
| 397 | distclean: clean | 404 | distclean: clean |
| 398 | - $(DEL) makefile | 405 | - $(DEL) makefile |