@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-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
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
@center @titlefont{Semantic}
@sp 4
@center by @value{AUTHOR}
+@page
+@vskip 0pt plus 1filll
+@insertcopying
@end titlepage
@page
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
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
@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 expression fn foo func funcall
@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