projects/dil: trunk/src/cmd/DDoc.d annotate

annotate trunk/src/cmd/DDoc.d @ 747:00f872d949ea

Added method scanCommentText() to DDocEmitter. Added method writeParams() and scanCodeSection(). Added method scanMacro() to MacroParser. Made fixes and improvements to the MacroExpander. Applied other minor fixes.

author	Aziz K?ksal <aziz.koeksal@gmail.com>
date	Mon, 11 Feb 2008 03:15:45 +0100
parents	7173ece1b696
children	8caf18892c1b

rev	line source
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	1 /++
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	2 Author: Aziz Köksal
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	3 License: GPL3
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	4 +/
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	5 module cmd.DDoc;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	6
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	7 import dil.doc.Parser;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	8 import dil.doc.Macro;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	9 import dil.doc.Doc;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	10 import dil.ast.Node;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	11 import dil.ast.Declarations,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	12 dil.ast.Statements,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	13 dil.ast.Expression,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	14 dil.ast.Parameters,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	15 dil.ast.Types;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	16 import dil.ast.DefaultVisitor;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	17 import dil.lexer.Token;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	18 import dil.lexer.Funcs;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	19 import dil.semantic.Module;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	20 import dil.semantic.Pass1;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	21 import dil.semantic.Symbol;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	22 import dil.semantic.Symbols;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	23 import dil.Information;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	24 import dil.File;
739 49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	25 import dil.Converter;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	26 import common;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	27
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	28 import tango.stdc.time : time_t, time, ctime;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	29 import tango.stdc.string : strlen;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	30 import tango.text.Ascii : toUpper;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	31 import tango.io.File;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	32 import tango.io.FilePath;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	33
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	34 void execute(string[] filePaths, string destDir, string[] macroPaths,
740 f3dead0310ce Added '-v' (verbose) option to command 'ddoc'. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 739 diff changeset	35 bool incUndoc, bool verbose, InfoManager infoMan)
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	36 {
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	37 // Parse macro files.
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	38 MacroTable mtable;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	39 MacroParser mparser;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	40 foreach (macroPath; macroPaths)
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	41 {
739 49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	42 auto macros = mparser.parse(loadMacroFile(macroPath));
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	43 mtable = new MacroTable(mtable);
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	44 mtable.insert(macros);
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	45 }
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	46
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	47 // foreach (k, v; mtable.table)
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	48 // Stdout(k)("=")(v.text);
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	49
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	50 foreach (filePath; filePaths)
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	51 {
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	52 auto mod = new Module(filePath, infoMan);
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	53 // Parse the file.
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	54 mod.parse();
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	55 if (mod.hasErrors)
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	56 continue;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	57
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	58 // Start semantic analysis.
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	59 auto pass1 = new SemanticPass1(mod);
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	60 pass1.start();
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	61
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	62 // Generate documentation.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	63 auto dest = new FilePath(destDir);
742 fc8f0e61bc42 Fixed building of time_str. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 741 diff changeset	64 dest.append(mod.getFQN() ~ ".html");
744 7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	65 InfoManager infoMan2; // Collects warnings from the macro expander.
742 fc8f0e61bc42 Fixed building of time_str. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 741 diff changeset	66 if (verbose)
744 7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	67 {
742 fc8f0e61bc42 Fixed building of time_str. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 741 diff changeset	68 Stdout.formatln("{} > {}", mod.filePath, dest);
744 7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	69 infoMan2 = new InfoManager();
7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	70 }
7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	71 writeDocFile(dest.toString(), mod, mtable, incUndoc, infoMan2);
7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	72 if (infoMan2)
7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	73 infoMan ~= infoMan2.info;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	74 }
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	75 }
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	76
744 7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	77 void writeDocFile(string dest, Module mod, MacroTable mtable, bool incUndoc,
7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	78 InfoManager infoMan)
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	79 {
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	80 // Create a macro environment for this module.
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	81 mtable = new MacroTable(mtable);
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	82 // Define runtime macros.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	83 mtable.insert("TITLE", mod.getFQN());
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	84 mtable.insert("DOCFILENAME", mod.getFQN());
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	85
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	86 time_t time_val;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	87 time(&time_val);
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	88 char* str = ctime(&time_val);
742 fc8f0e61bc42 Fixed building of time_str. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 741 diff changeset	89 char[] time_str = str[0 .. strlen(str)-1]; // -1 removes trailing '\n'.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	90 mtable.insert("DATETIME", time_str.dup);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	91 mtable.insert("YEAR", time_str[20..24].dup);
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	92
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	93 auto doc = new DDocEmitter(mtable, incUndoc);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	94 doc.emit(mod);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	95 // Set BODY macro to the text produced by the DDocEmitter.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	96 mtable.insert("BODY", doc.text);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	97 // Do the macro expansion pass.
744 7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	98 auto fileText = MacroExpander.expand(mtable, "$(DDOC)", mod.filePath, infoMan);
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	99 // fileText ~= "\n<pre>\n" ~ doc.text ~ "\n</pre>";
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	100 // Finally write the file out to the harddisk.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	101 auto file = new File(dest);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	102 file.write(fileText);
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	103 }
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	104
739 49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	105 string loadMacroFile(string filePath)
49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	106 {
49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	107 return sanitizeText(loadFile(filePath));
49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	108 }
49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	109
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	110 /// Traverses the syntax tree and writes DDoc macros to a string buffer.
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	111 class DDocEmitter : DefaultVisitor
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	112 {
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	113 char[] text;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	114 bool includeUndocumented;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	115 MacroTable mtable;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	116
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	117 this(MacroTable mtable, bool includeUndocumented)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	118 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	119 this.mtable = mtable;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	120 this.includeUndocumented = includeUndocumented;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	121 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	122
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	123 /// Entry method.
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	124 char[] emit(Module mod)
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	125 {
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	126 if (auto d = mod.moduleDecl)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	127 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	128 if (ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	129 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	130 if (auto copyright = cmnt.takeCopyright())
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	131 mtable.insert(new Macro("COPYRIGHT", copyright.text));
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	132 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	133 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	134 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	135 MEMBERS("MODULE", { visitD(mod.root); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	136 write(\n);
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	137 return text;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	138 }
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	139
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	140 char[] textSpan(Token* left, Token* right)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	141 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	142 //assert(left && right && (left.end <= right.start \|\| left is right));
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	143 //char[] result;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	144 //TODO: filter out whitespace tokens.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	145 return Token.textSpan(left, right);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	146 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	147
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	148 bool isTemplatized; /// True if an aggregate declaration is templatized.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	149 TemplateParameters tparams; /// The template parameters of the declaration.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	150
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	151 DDocComment cmnt; /// Current comment.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	152 DDocComment prevCmnt; /// Previous comment in scope.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	153 /// An empty comment. Used for undocumented symbols.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	154 static const DDocComment emptyCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	155
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	156 static this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	157 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	158 this.emptyCmnt = new DDocComment(null, null, null);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	159 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	160
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	161 /// Keeps track of previous comments in each scope.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	162 scope class Scope
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	163 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	164 DDocComment old_prevCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	165 this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	166 { // Save the previous comment of the parent scope.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	167 old_prevCmnt = this.outer.prevCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	168 // Entering a new scope. Set to null.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	169 this.outer.prevCmnt = null;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	170 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	171
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	172 ~this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	173 { // Restore the previous comment of the parent scope.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	174 this.outer.prevCmnt = old_prevCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	175 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	176 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	177
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	178 DDocComment ddoc(Node node)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	179 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	180 auto c = getDDocComment(node);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	181 this.cmnt = null;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	182 if (c)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	183 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	184 if (c.isDitto)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	185 this.cmnt = this.prevCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	186 else
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	187 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	188 this.cmnt = c;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	189 this.prevCmnt = c;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	190 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	191 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	192 else if (includeUndocumented)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	193 this.cmnt = this.emptyCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	194 return this.cmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	195 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	196
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	197 static char[][char[]] specialSections;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	198 static this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	199 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	200 foreach (name; ["AUTHORS", "BUGS", "COPYRIGHT", "DATE", "DEPRECATED",
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	201 "EXAMPLES", "HISTORY", "LICENSE", "RETURNS", "SEE_ALSO",
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	202 "STANDARDS", "THROWS", "VERSION"])
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	203 specialSections[name] = name;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	204 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	205
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	206 void writeComment()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	207 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	208 auto c = this.cmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	209 assert(c !is null);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	210 if (c.sections.length == 0)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	211 return;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	212 write("$(DDOC_SECTIONS ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	213 foreach (s; c.sections)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	214 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	215 if (s is c.summary)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	216 write("\n$(DDOC_SUMMARY ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	217 else if (s is c.description)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	218 write("\n$(DDOC_DESCRIPTION ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	219 else if (auto name = toUpper(s.name.dup) in specialSections)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	220 write("\n$(DDOC_" ~ *name ~ " ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	221 else if (s.Is("params"))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	222 { // Process parameters section.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	223 auto ps = new ParamsSection(s.name, s.text);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	224 write("\n$(DDOC_PARAMS ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	225 foreach (i, paramName; ps.paramNames)
741 35184354a502 Added method textBody() to IdentValueParser. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 740 diff changeset	226 write("\n$(DDOC_PARAM_ROW ",
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	227 "$(DDOC_PARAM_ID ", paramName, ")",
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	228 "$(DDOC_PARAM_DESC ", ps.paramDescs[i], ")",
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	229 ")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	230 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	231 continue;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	232 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	233 else if (s.Is("macros"))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	234 { // Declare the macros in this section.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	235 auto ms = new MacrosSection(s.name, s.text);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	236 mtable.insert(ms.macroNames, ms.macroTexts);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	237 continue;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	238 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	239 else
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	240 write("\n$(DDOC_SECTION $(DDOC_SECTION_H " ~ s.name ~ ":)");
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	241 write(scanCommentText(s.text), ")");
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	242 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	243 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	244 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	245
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	246 char[] scanCommentText(char[] text)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	247 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	248 char* p = text.ptr;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	249 char* end = p + text.length;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	250 char[] result = new char[text.length]; // Reserve space.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	251 result.length = 0;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	252
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	253 while (p < end)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	254 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	255 switch (*p)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	256 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	257 case '$':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	258 if (auto macroEnd = MacroParser.scanMacro(p, end))
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	259 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	260 result ~= makeString(p, macroEnd); // Copy macro invocation as is.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	261 p = macroEnd;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	262 continue;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	263 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	264 goto default;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	265 case '<':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	266 auto begin = p;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	267 p++;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	268 if (p+2 < end && *p == '!' && p[1] == '-' && p[2] == '-') // <!--
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	269 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	270 p += 2; // Point to 2nd '-'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	271 // Scan to closing "-->".
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	272 while (++p < end)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	273 if (p+2 < end && *p == '-' && p[1] == '-' && p[2] == '>')
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	274 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	275 p += 3; // Point one past '>'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	276 break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	277 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	278 result ~= makeString(begin, p);
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	279 } // <tag ...> or </tag>
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	280 else if (p < end && (isalpha(p) \|\| p == '/'))
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	281 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	282 while (++p < end && *p != '>') // Skip to closing '>'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	283 {}
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	284 p != end && p++; // Skip '>'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	285 result ~= makeString(begin, p);
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	286 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	287 else
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	288 result ~= "<";
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	289 continue;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	290 case '(': result ~= "("; break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	291 case ')': result ~= ")"; break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	292 case '\'': result ~= "'"; break; // '
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	293 case '"': result ~= """; break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	294 case '>': result ~= ">"; break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	295 case '&':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	296 if (p+1 < end && (isalpha(p[1]) \|\| p[1] == '#'))
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	297 goto default;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	298 result ~= "&";
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	299 break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	300 case '-':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	301 if (p+2 < end && p[1] == '-' && p[2] == '-')
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	302 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	303 p += 2; // Point to 3rd '-'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	304 auto codeBegin = p + 1;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	305 while (++p < end)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	306 if (p+2 < end && *p == '-' && p[1] == '-' && p[2] == '-')
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	307 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	308 result ~= "$(D_CODE " ~ scanCodeSection(makeString(codeBegin, p)) ~ ")";
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	309 p += 3;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	310 break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	311 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	312 continue;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	313 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	314 //goto default;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	315 default:
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	316 result ~= *p;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	317 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	318 p++;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	319 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	320 return result;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	321 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	322
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	323 char[] scanCodeSection(char[] text)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	324 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	325 return text;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	326 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	327
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	328 void writeParams(Parameters params)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	329 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	330 if (!params.items.length)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	331 return write("()");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	332 write("(");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	333 auto lastParam = params.items[$-1];
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	334 foreach (param; params.items)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	335 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	336 if (param.isCVariadic)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	337 write("...");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	338 else
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	339 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	340 assert(param.type);
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	341 // Write storage classes.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	342 auto typeBegin = param.type.baseType.begin;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	343 if (typeBegin !is param.begin)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	344 write(textSpan(param.begin, typeBegin.prevNWS), " ");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	345 write(textSpan(typeBegin, param.type.end));
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	346 write(" $(DDOC_PARAM ", param.name.str, ")");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	347 if (param.isDVariadic)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	348 write("...");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	349 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	350 if (param !is lastParam)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	351 write(", ");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	352 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	353 write(")");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	354 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	355
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	356 void writeTemplateParams()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	357 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	358 if (!isTemplatized)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	359 return;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	360 write("(", (tparams ? textSpan(tparams.begin, tparams.end) : ""), ")");
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	361 isTemplatized = false;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	362 tparams = null;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	363 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	364
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	365 void writeInheritanceList(BaseClassType[] bases)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	366 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	367 if (bases.length == 0)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	368 return;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	369 text ~= " : " ~ textSpan(bases[0].begin, bases[$-1].end);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	370 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	371
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	372 void writeFuncHeader(Declaration d, FuncBodyStatement s)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	373 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	374 auto begin = d.begin;
741 35184354a502 Added method textBody() to IdentValueParser. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 740 diff changeset	375 auto end = d.end.prevNWS;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	376 if (!s.isEmpty)
741 35184354a502 Added method textBody() to IdentValueParser. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 740 diff changeset	377 end = s.begin.prevNWS;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	378 text ~= textSpan(begin, end);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	379 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	380
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	381 void write(char[][] strings...)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	382 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	383 foreach (s; strings)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	384 text ~= s;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	385 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	386
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	387 void SYMBOL(char[][] strings...)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	388 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	389 write("$(DDOC_PSYMBOL ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	390 write(strings);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	391 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	392 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	393
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	394 void DECL(void delegate() dg)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	395 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	396 write("\n$(DDOC_DECL ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	397 dg();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	398 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	399 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	400
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	401 void DESC(void delegate() dg)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	402 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	403 write("\n$(DDOC_DECL_DD ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	404 dg();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	405 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	406 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	407
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	408 void MEMBERS(char[] kind, void delegate() dg)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	409 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	410 write("\n$(DDOC_"~kind~"_MEMBERS ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	411 dg();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	412 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	413 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	414
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	415 void writeClassOrInterface(T)(T d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	416 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	417 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	418 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	419 scope s = new Scope();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	420 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	421 write(d.begin.srcText, " ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	422 SYMBOL(d.name.str);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	423 writeTemplateParams();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	424 writeInheritanceList(d.bases);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	425 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	426 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	427 writeComment();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	428 MEMBERS(is(T == ClassDeclaration) ? "CLASS" : "INTERFACE", {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	429 d.decls && super.visit(d.decls);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	430 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	431 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	432 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	433
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	434 void writeStructOrUnion(T)(T d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	435 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	436 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	437 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	438 scope s = new Scope();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	439 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	440 write(d.begin.srcText, d.name ? " " : "");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	441 if (d.name)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	442 SYMBOL(d.name.str);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	443 writeTemplateParams();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	444 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	445 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	446 writeComment();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	447 MEMBERS(is(T == StructDeclaration) ? "STRUCT" : "UNION", {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	448 d.decls && super.visit(d.decls);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	449 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	450 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	451 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	452
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	453 alias Declaration D;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	454
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	455 override:
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	456 // D visit(ModuleDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	457 // { return d; }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	458
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	459 D visit(AliasDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	460 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	461 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	462 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	463 DECL({ write(textSpan(d.begin, d.end)); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	464 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	465 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	466 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	467
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	468 D visit(TypedefDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	469 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	470 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	471 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	472 DECL({ write(textSpan(d.begin, d.end)); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	473 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	474 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	475 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	476
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	477 D visit(EnumDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	478 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	479 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	480 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	481 scope s = new Scope();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	482 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	483 write("enum", d.name ? " " : "");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	484 d.name && SYMBOL(d.name.str);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	485 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	486 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	487 writeComment();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	488 MEMBERS("ENUM", { super.visit(d); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	489 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	490 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	491 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	492
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	493 D visit(EnumMemberDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	494 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	495 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	496 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	497 DECL({ SYMBOL(d.name.str); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	498 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	499 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	500 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	501
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	502 D visit(TemplateDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	503 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	504 if (d.begin.kind != TOK.Template)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	505 { // This is a templatized class/interface/struct/union.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	506 this.isTemplatized = true;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	507 this.tparams = d.tparams;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	508 return super.visit(d.decls);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	509 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	510 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	511 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	512 scope s = new Scope();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	513 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	514 write("template ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	515 SYMBOL(d.name.str);
741 35184354a502 Added method textBody() to IdentValueParser. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 740 diff changeset	516 write(textSpan(d.begin.nextNWS.nextNWS, d.decls.begin.prevNWS));
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	517 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	518 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	519 writeComment();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	520 MEMBERS("TEMPLATE", {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	521 super.visit(d.decls);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	522 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	523 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	524 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	525 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	526
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	527 D visit(ClassDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	528 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	529 writeClassOrInterface(d);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	530 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	531 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	532
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	533 D visit(InterfaceDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	534 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	535 writeClassOrInterface(d);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	536 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	537 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	538
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	539 D visit(StructDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	540 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	541 writeStructOrUnion(d);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	542 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	543 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	544
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	545 D visit(UnionDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	546 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	547 writeStructOrUnion(d);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	548 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	549 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	550
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	551 D visit(ConstructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	552 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	553 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	554 return d;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	555 DECL({ write("this"); writeParams(d.params); });
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	556 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	557 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	558 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	559
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	560 D visit(StaticConstructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	561 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	562 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	563 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	564 DECL({ writeFuncHeader(d, d.funcBody); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	565 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	566 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	567 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	568
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	569 D visit(DestructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	570 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	571 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	572 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	573 DECL({ writeFuncHeader(d, d.funcBody); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	574 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	575 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	576 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	577
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	578 D visit(StaticDestructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	579 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	580 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	581 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	582 DECL({ writeFuncHeader(d, d.funcBody); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	583 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	584 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	585 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	586
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	587 D visit(FunctionDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	588 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	589 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	590 return d;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	591 auto type = textSpan(d.returnType.baseType.begin, d.returnType.end);
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	592 DECL({ write(type, " "); SYMBOL(d.name.str); writeParams(d.params); });
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	593 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	594 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	595 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	596
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	597 D visit(NewDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	598 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	599 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	600 return d;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	601 DECL({ write("new"); writeParams(d.params); });
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	602 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	603 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	604 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	605
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	606 D visit(DeleteDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	607 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	608 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	609 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	610 DECL({ writeFuncHeader(d, d.funcBody); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	611 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	612 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	613 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	614
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	615 D visit(VariablesDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	616 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	617 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	618 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	619 char[] type = "auto";
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	620 if (d.typeNode)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	621 type = textSpan(d.typeNode.baseType.begin, d.typeNode.end);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	622 foreach (name; d.names)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	623 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	624 DECL({ write(type, " "); SYMBOL(name.str); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	625 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	626 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	627 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	628 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	629
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	630 D visit(InvariantDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	631 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	632 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	633 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	634 DECL({ write("invariant"); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	635 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	636 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	637 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	638
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	639 D visit(UnittestDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	640 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	641 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	642 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	643 DECL({ write("unittest"); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	644 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	645 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	646 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	647
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	648 D visit(DebugDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	649 { return d; }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	650
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	651 D visit(VersionDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	652 { return d; }
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	653 }

Mercurial > projects > dil

annotate trunk/src/cmd/DDoc.d @ 747:00f872d949ea