\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
@copying
This manual documents the Semantic library and utilities.
-Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007,
-2009, 2010, 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
-@dircategory Emacs
+@dircategory Emacs misc features
@direntry
* Semantic: (semantic). Source code parser library and utilities.
@end direntry
@center @titlefont{Semantic}
@sp 4
@center by @value{AUTHOR}
+@page
+@vskip 0pt plus 1filll
+@insertcopying
@end titlepage
@page
@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
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
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
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
@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
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.
@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
@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
@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