Thread: [CEDET-devel] semantic manual udpate
Brought to you by:
zappo
From: <ry...@ds...> - 2003-02-27 08:01:59
|
Hi all, I cut and pasted all of the old semantic.texi to the new files under the semantic/doc directory. I'll be taking an inventory of what we already have by reading it all in the next day or two. I list some of the changes I made so far. Please let me know if any one of them needs to be changed. * Copied Free Document Licensing fil, fdl.texi, from wisent directory and cut and pasted FDL related lines from wisent to new semantic manual. * Changed copyright to Copyright @copyright{} 1999, 2000, 2001, 2002, 2003 Eric M. Ludlam Copyright @copyright{} 2001, 2002, 2003 David Ponce * Started using "Infrastructure for parser based text analysis in Emacs." whenever a brief description of semantic is uses such as info menu line. I think "parser generator" doesn't do justice to semantic, since it is far more than that. Let's see if we can think of better catchy phrase :) * Created "Glossary" chapter for now. I think it would be a good idea to define all the terms here so that we can reference them, e.g., @ref{lexical tokens}. I remember being confused early on between "lexical tokens" and "semantic tokens". I don't know whether we need to have a separate glossary chapter when we are done with the manual. We may instead choose to disperse all the definitions into other chapters. I defined the following macro for declaring each keyword. @c To be used within the glossary section. @macro keyword{kw} @anchor{\kw\} @b{\kw\} @end macro The only thing it does for now is to use the @anchor{} command so that you can use @ref{} to link to it. |
From: Eric M. L. <er...@si...> - 2003-02-28 11:57:02
|
>>> ry...@ds... seems to think that: >Hi all, > >I cut and pasted all of the old semantic.texi to the new files under >the semantic/doc directory. I'll be taking an inventory of what we >already have by reading it all in the next day or two. [ ... ] >* Started using "Infrastructure for parser based text analysis in Emacs." > whenever a brief description of semantic is uses such as info menu > line. I think "parser generator" doesn't do justice to semantic, > since it is far more than that. Let's see if we can think of better > catchy phrase :) I like your catch-phrase. Perhaps some of the tools (senator, analyze, speedbar, etc) should be moved into their own dependent package under cedet. >* Created "Glossary" chapter for now. I think it would be a good idea > to define all the terms here so that we can reference them, e.g., > @ref{lexical tokens}. I remember being confused early on between > "lexical tokens" and "semantic tokens". > > I don't know whether we need to have a > separate glossary chapter when we are done with the manual. > We may instead choose to disperse all the definitions into other > chapters. > > I defined the following macro for declaring each keyword. > > @c To be used within the glossary section. > @macro keyword{kw} > @anchor{\kw\} > @b{\kw\} > @end macro > > The only thing it does for now is to use the @anchor{} command so > that you can use @ref{} to link to it. [ ... ] This is neat. I had no idea you could do this in texinfo. Thanks! Eric -- Eric Ludlam: za...@gn..., er...@si... Home: http://www.ludlam.net Siege: www.siege-engine.com Emacs: http://cedet.sourceforge.net GNU: www.gnu.org |