X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/615d868ee6add5d37db574d266f0d166c2f16bb8..29993416fb4d19c1c3bb146367fc4bed74845486:/doc/misc/semantic.texi diff --git a/doc/misc/semantic.texi b/doc/misc/semantic.texi index 52434f4a6e..9b9f29f1f1 100644 --- a/doc/misc/semantic.texi +++ b/doc/misc/semantic.texi @@ -1,8 +1,9 @@ \input texinfo -@setfilename ../../info/semantic +@setfilename ../../info/semantic.info @set TITLE Semantic Manual @set AUTHOR Eric M. Ludlam, David Ponce, and Richard Y. Kim @settitle @value{TITLE} +@documentencoding UTF-8 @c ************************************************************************* @c @ Header @@ -24,19 +25,19 @@ @copying This manual documents the Semantic library and utilities. -Copyright @copyright{} 1999-2005, 2007, 2009-2011 Free Software Foundation, Inc. +Copyright @copyright{} 1999--2005, 2007, 2009--2014 Free Software +Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no -Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' +Invariant Sections, with the Front-Cover Texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled ``GNU Free Documentation License.'' (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and -modify this GNU manual. Buying copies from the FSF supports it in -developing GNU and promoting software freedom.'' +modify this GNU manual.'' @end quotation @end copying @@ -49,6 +50,9 @@ developing GNU and promoting software freedom.'' @center @titlefont{Semantic} @sp 4 @center by @value{AUTHOR} +@page +@vskip 0pt plus 1filll +@insertcopying @end titlepage @page @@ -64,7 +68,7 @@ developing GNU and promoting software freedom.'' @macro obsolete{old,new} @sp 1 @strong{Compatibility}: -@code{\new\} introduced in @semantic{} version 2.0 supercedes +@code{\new\} introduced in @semantic{} version 2.0 supersedes @code{\old\} which is now obsolete. @end macro @@ -223,12 +227,12 @@ grammar developers; it is useful mostly for the hackers who would like to learn more about how @semantic{} works. @menu -* Parser code :: Code used for the parsers -* Tag handling :: Code used for manipulating tags -* Semanticdb Internals :: Code used in the semantic database -* Analyzer Internals :: Code used in the code analyzer -* Tools :: Code used in user tools -* Tests :: Code used for testing +* Parser code:: Code used for the parsers +* Tag handling:: Code used for manipulating tags +* Semanticdb Internals:: Code used in the semantic database +* Analyzer Internals:: Code used in the code analyzer +* Tools:: Code used in user tools +* Tests:: Code used for testing @end menu @node Parser code @@ -306,7 +310,7 @@ Files associated with tags. Goto-tag, file for include, and file for a prototype. @item semantic-tag-ls.el -Language dependant features of a tag, such as parent calculation, slot +Language dependent features of a tag, such as parent calculation, slot protection, and other states like abstract, virtual, static, and leaf. @item semantic-dep.el @@ -349,9 +353,9 @@ This file also provides support for @code{semanticdb-minor-mode}, which automatically associates files with tables in databases so that tags are @emph{saved} while a buffer is not in memory. -The database and tables both also provide applicate cache information, +The database and tables both also provide applicable cache information, and cache flushing system. The semanticdb search routines use caches -to save datastructures that are complex to calculate. +to save data structures that are complex to calculate. Lastly, it provides the concept of @dfn{project root}. It is a system by which a file can be associated with the root of a project, so if @@ -380,7 +384,7 @@ with the search results format. @item semanticdb-ref.el Tracks crossreferences. Cross references are needed when buffer is -reparsed, and must alert other tables that any dependant caches may +reparsed, and must alert other tables that any dependent caches may need to be flushed. References are in the form of include files. @end table @@ -421,7 +425,7 @@ local variables, and tag lists in scope for various reasons, such as C++ using statements. @item semanticdb-typecache.el -The typecache is part of @code{semanticdb}, but is used primarilly by +The typecache is part of @code{semanticdb}, but is used primarily by the analyzer to look up datatypes and complex names. The typecache is bound across source files and builds a master lookup table for data type names. @@ -520,7 +524,7 @@ Regression tests from the older Semantic 1.x API. @node Glossary @appendix Glossary -@table @keyword +@table @asis @item BNF In semantic 1.4, a BNF file represented ``Bovine Normal Form'', the grammar file used for the 1.4 parser generator. This was a play on @@ -536,7 +540,7 @@ the buffer. @item bovine parser A parser using the bovine parser generator. It is an LL parser -suitible for small simple languages. +suitable for small simple languages. @item context @@ -603,17 +607,17 @@ Emacs Lisp. It is an LALR parser suitable for complex languages. @c LocalWords: backquote bnf bovinate bovinates LALR @c LocalWords: bovinating bovination bovinator bucketize @c LocalWords: cb cdr charquote checkcache cindex CLOS -@c LocalWords: concat concocting const constantness ctxt Decl defcustom +@c LocalWords: concat concocting const ctxt Decl defcustom @c LocalWords: deffn deffnx defun defvar destructor's dfn diff dir @c LocalWords: doc docstring EDE EIEIO elisp emacsman emph enum -@c LocalWords: eq Exp EXPANDFULL expresssion fn foo func funcall -@c LocalWords: ia ids iff ifinfo imenu imenus init int isearch itemx java kbd +@c LocalWords: eq Exp EXPANDFULL expression fn foo func funcall +@c LocalWords: ia ids ifinfo imenu imenus init int isearch itemx java kbd @c LocalWords: keymap keywordtable lang languagemode lexer lexing Ludlam @c LocalWords: menubar metaparent metaparents min minibuffer Misc mode's @c LocalWords: multitable NAvigaTOR noindent nomedian nonterm noselect @c LocalWords: nosnarf obarray OLE OO outputfile paren parsetable POINT's @c LocalWords: popup positionalonly positiononly positionormarker pre -@c LocalWords: printf printindex Programmatically pt punctuations quotemode +@c LocalWords: printf printindex Programmatically pt quotemode @c LocalWords: ref regex regexp Regexps reparse resetfile samp sb @c LocalWords: scopestart SEmantic semanticdb setfilename setq @c LocalWords: settitle setupfunction sexp sp SPC speedbar speedbar's