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

annotate src/cmd/DDoc.d @ 810:525ee3f848d9

Added modules cmd.Compile and dil.ModuleManager. Added options -I, -release and -unittest to the compile command. Tidied main.d up a bit. Renamed start() methods of SemanticPass1 and 2 to run(). Moved function findModuleFilePath() to class ModuleManager. Added msg CouldntLoadModule. Corrected two others. Added member semanticPass to class Module. Implemented visit(ImportDeclaration) in SemanticPass1.

author	Aziz K?ksal <aziz.koeksal@gmail.com>
date	Tue, 11 Mar 2008 02:48:01 +0100
parents	28e1ff1dcfcf
children	451ede0105e0

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
799 fd719161e743 New ddoc emitter for XML type output. Jari-Matti M?kel? <jmjm@iki.fi> parents: 785 diff changeset	7 import cmd.DDocXML;
808 28e1ff1dcfcf Renamed generate command to highlight and refactored it. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 807 diff changeset	8 import cmd.Highlight;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	9 import dil.doc.Parser;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	10 import dil.doc.Macro;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	11 import dil.doc.Doc;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	12 import dil.ast.Node;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	13 import dil.ast.Declarations,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	14 dil.ast.Statements,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	15 dil.ast.Expression,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	16 dil.ast.Parameters,
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	17 dil.ast.Types;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	18 import dil.ast.DefaultVisitor;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	19 import dil.lexer.Token;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	20 import dil.lexer.Funcs;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	21 import dil.semantic.Module;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	22 import dil.semantic.Pass1;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	23 import dil.semantic.Symbol;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	24 import dil.semantic.Symbols;
778 78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	25 import dil.Compilation;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	26 import dil.Information;
739 49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	27 import dil.Converter;
764 4579e8505d5e Fixed unittests and removed dil.File. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 761 diff changeset	28 import dil.SourceText;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	29 import dil.Enums;
776 580d4ca9f1ff Added new module dil.Time. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 775 diff changeset	30 import dil.Time;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	31 import common;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	32
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	33 import tango.text.Ascii : toUpper;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	34 import tango.io.File;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	35 import tango.io.FilePath;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	36
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	37 /// The ddoc command.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	38 struct DDocCommand
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	39 {
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	40 string destDirPath; /// Destination directory.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	41 string[] macroPaths; /// Macro file paths.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	42 string[] filePaths; /// Module file paths.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	43 bool includeUndocumented; /// Whether to include undocumented symbols.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	44 bool writeXML; /// Whether to write XML instead of HTML docs.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	45 bool verbose; /// Whether to be verbose.
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	46
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	47 CompilationContext context;
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	48 InfoManager infoMan;
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	49 TokenHighlighter tokenHL; /// For DDoc code sections.
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	50
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	51 /// Executes the doc generation command.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	52 void run()
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	53 {
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	54 // Parse macro files and build macro table hierarchy.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	55 MacroTable mtable;
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	56 MacroParser mparser;
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	57 foreach (macroPath; macroPaths)
744 7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	58 {
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	59 auto macros = mparser.parse(loadMacroFile(macroPath, infoMan));
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	60 mtable = new MacroTable(mtable);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	61 mtable.insert(macros);
744 7173ece1b696 Wrapped some macro functions inside struct MacroExpander. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 743 diff changeset	62 }
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	63
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	64 // For DDoc code sections.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	65 tokenHL = new TokenHighlighter(infoMan, writeXML == false);
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	66
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	67 // Process D files.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	68 foreach (filePath; filePaths)
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	69 {
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	70 auto mod = new Module(filePath, infoMan);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	71 // Parse the file.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	72 mod.parse();
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	73 if (mod.hasErrors)
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	74 continue;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	75
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	76 // Start semantic analysis.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	77 auto pass1 = new SemanticPass1(mod, context);
810 525ee3f848d9 Added modules cmd.Compile and dil.ModuleManager. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 808 diff changeset	78 pass1.run();
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	79
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	80 // Build destination file path.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	81 auto destPath = new FilePath(destDirPath);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	82 destPath.append(mod.getFQN() ~ (writeXML ? ".xml" : ".html"));
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	83
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	84 if (verbose)
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	85 Stdout.formatln("{} > {}", mod.filePath, destPath);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	86
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	87 // Write the document file.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	88 writeDocFile(destPath.toString(), mod, mtable);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	89 }
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	90 }
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	91
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	92 void writeDocFile(string destPath, Module mod, MacroTable mtable)
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	93 {
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	94 // Create this module's own macro environment.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	95 mtable = new MacroTable(mtable);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	96 // Define runtime macros.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	97 // MODPATH is an extension by dil.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	98 mtable.insert("MODPATH", mod.getFQNPath() ~ "." ~ mod.fileExtension());
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	99 mtable.insert("TITLE", mod.getFQN());
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	100 mtable.insert("DOCFILENAME", mod.getFQN() ~ (writeXML ? ".xml" : ".html"));
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	101 auto timeStr = Time.toString();
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	102 mtable.insert("DATETIME", timeStr);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	103 mtable.insert("YEAR", Time.year(timeStr));
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	104
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	105 DDocEmitter docEmitter;
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	106 if (writeXML)
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	107 docEmitter = new DDocXMLEmitter(mod, mtable, includeUndocumented, tokenHL);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	108 else
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	109 docEmitter = new DDocEmitter(mod, mtable, includeUndocumented, tokenHL);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	110 docEmitter.emit();
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	111
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	112 // Set BODY macro to the text produced by the emitter.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	113 mtable.insert("BODY", docEmitter.text);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	114 // Do the macro expansion pass.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	115 auto fileText = MacroExpander.expand(mtable, "$(DDOC)",
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	116 mod.filePath,
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	117 verbose ? infoMan : null);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	118 // fileText ~= "\n<pre>\n" ~ doc.text ~ "\n</pre>";
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	119
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	120 // Finally write the file out to the harddisk.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	121 scope file = new File(destPath);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	122 file.write(fileText);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	123 }
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	124
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	125 /// Loads a macro file. Converts any Unicode encoding to UTF-8.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	126 static string loadMacroFile(string filePath, InfoManager infoMan)
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	127 {
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	128 auto src = new SourceText(filePath);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	129 src.load(infoMan);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	130 auto text = src.data[0..$-1]; // Exclude '\0'.
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	131 return sanitizeText(text);
a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	132 }
739 49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	133 }
49fe21aa387c Added sanitizeText() to dil.Converter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 737 diff changeset	134
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	135 /// 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	136 class DDocEmitter : DefaultVisitor
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	137 {
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	138 char[] text; /// The buffer that is written to.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	139 bool includeUndocumented;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	140 MacroTable mtable;
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	141 Module modul;
307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	142 TokenHighlighter tokenHL;
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	143
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	144 /// Constructs a DDocEmitter object.
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	145 /// Params:
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	146 /// modul = the module to generate text for.
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	147 /// mtable = the macro table.
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	148 /// includeUndocumented = whether to include undocumented symbols.
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	149 /// tokenHL = used to highlight code sections.
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	150 this(Module modul, MacroTable mtable, bool includeUndocumented,
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	151 TokenHighlighter tokenHL)
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	152 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	153 this.mtable = mtable;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	154 this.includeUndocumented = includeUndocumented;
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	155 this.modul = modul;
307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	156 this.tokenHL = tokenHL;
737 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
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	159 /// Entry method.
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	160 char[] emit()
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	161 {
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	162 if (auto d = modul.moduleDecl)
737 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 if (ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	165 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	166 if (auto copyright = cmnt.takeCopyright())
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	167 mtable.insert(new Macro("COPYRIGHT", copyright.text));
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	168 writeComment();
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	169 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	170 }
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	171 MEMBERS("MODULE", { visitD(modul.root); });
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	172 return text;
ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	173 }
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	174
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	175 char[] textSpan(Token* left, Token* right)
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 //assert(left && right && (left.end <= right.start \|\| left is right));
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	178 //char[] result;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	179 //TODO: filter out whitespace tokens.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	180 return Token.textSpan(left, right);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	181 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	182
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	183 TemplateParameters tparams; /// The template parameters of the current declaration.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	184
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	185 DDocComment cmnt; /// Current comment.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	186 DDocComment prevCmnt; /// Previous comment in scope.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	187 /// An empty comment. Used for undocumented symbols.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	188 static const DDocComment emptyCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	189
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	190 /// Initializes the empty comment.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	191 static this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	192 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	193 this.emptyCmnt = new DDocComment(null, null, null);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	194 }
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 /// Keeps track of previous comments in each scope.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	197 scope class Scope
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	198 {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	199 DDocComment saved_prevCmnt;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	200 bool saved_cmntIsDitto;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	201 uint saved_prevDeclOffset;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	202 this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	203 { // Save the previous comment of the parent scope.
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	204 saved_prevCmnt = this.outer.prevCmnt;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	205 saved_cmntIsDitto = this.outer.cmntIsDitto;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	206 saved_prevDeclOffset = this.outer.prevDeclOffset;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	207 // Entering a new scope. Clear variables.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	208 this.outer.prevCmnt = null;
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	209 this.outer.cmntIsDitto = false;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	210 this.outer.prevDeclOffset = 0;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	211 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	212
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	213 ~this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	214 { // Restore the previous comment of the parent scope.
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	215 this.outer.prevCmnt = saved_prevCmnt;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	216 this.outer.cmntIsDitto = saved_cmntIsDitto;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	217 this.outer.prevDeclOffset = saved_prevDeclOffset;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	218 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	219 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	220
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	221 bool cmntIsDitto; /// True if current comment is "ditto".
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	222
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	223 /// Returns the DDocComment for node.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	224 DDocComment ddoc(Node node)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	225 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	226 auto c = getDDocComment(node);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	227 this.cmnt = null;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	228 if (c)
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 if (c.isDitto)
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	231 {
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	232 this.cmnt = this.prevCmnt;
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	233 this.cmntIsDitto = true;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	234 }
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	235 else
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	236 {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	237 this.cmntIsDitto = false;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	238 this.cmnt = c;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	239 this.prevCmnt = c;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	240 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	241 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	242 else if (includeUndocumented)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	243 this.cmnt = this.emptyCmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	244 return this.cmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	245 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	246
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	247 /// List of predefined, special sections.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	248 static char[][char[]] specialSections;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	249 static this()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	250 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	251 foreach (name; ["AUTHORS", "BUGS", "COPYRIGHT", "DATE", "DEPRECATED",
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	252 "EXAMPLES", "HISTORY", "LICENSE", "RETURNS", "SEE_ALSO",
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	253 "STANDARDS", "THROWS", "VERSION"])
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	254 specialSections[name] = name;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	255 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	256
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	257 /// Writes the DDoc comment to the text buffer.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	258 void writeComment()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	259 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	260 auto c = this.cmnt;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	261 assert(c !is null);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	262 if (c.sections.length == 0)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	263 return;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	264 write("$(DDOC_SECTIONS ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	265 foreach (s; c.sections)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	266 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	267 if (s is c.summary)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	268 write("\n$(DDOC_SUMMARY ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	269 else if (s is c.description)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	270 write("\n$(DDOC_DESCRIPTION ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	271 else if (auto name = toUpper(s.name.dup) in specialSections)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	272 write("\n$(DDOC_" ~ *name ~ " ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	273 else if (s.Is("params"))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	274 { // Process parameters section.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	275 auto ps = new ParamsSection(s.name, s.text);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	276 write("\n$(DDOC_PARAMS ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	277 foreach (i, paramName; ps.paramNames)
741 35184354a502 Added method textBody() to IdentValueParser. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 740 diff changeset	278 write("\n$(DDOC_PARAM_ROW ",
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	279 "$(DDOC_PARAM_ID $(DDOC_PARAM ", paramName, "))",
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	280 "$(DDOC_PARAM_DESC ", ps.paramDescs[i], ")",
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	281 ")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	282 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	283 continue;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	284 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	285 else if (s.Is("macros"))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	286 { // Declare the macros in this section.
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	287 auto ms = new MacrosSection(s.name, s.text);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	288 mtable.insert(ms.macroNames, ms.macroTexts);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	289 continue;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	290 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	291 else
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	292 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	293 write(scanCommentText(s.text), ")");
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	294 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	295 write(")");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	296 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	297
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	298 /// Scans the comment text and:
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	299 /// $(UL
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	300 /// $(LI skips and leaves macro invocations unchanged)
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	301 /// $(LI skips HTML tags)
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	302 /// $(LI escapes '(', ')', '<', '>' and '&')
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	303 /// $(LI inserts $(DDOC_BLANKLINE) in place of \n\n)
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	304 /// $(LI highlights code in code sections)
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	305 /// )
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	306 char[] scanCommentText(char[] text)
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 char* p = text.ptr;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	309 char* end = p + text.length;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	310 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	311 result.length = 0;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	312
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	313 while (p < end)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	314 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	315 switch (*p)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	316 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	317 case '$':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	318 if (auto macroEnd = MacroParser.scanMacro(p, end))
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 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	321 p = macroEnd;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	322 continue;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	323 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	324 goto default;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	325 case '<':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	326 auto begin = p;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	327 p++;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	328 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	329 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	330 p += 2; // Point to 2nd '-'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	331 // Scan to closing "-->".
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	332 while (++p < end)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	333 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	334 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	335 p += 3; // Point one past '>'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	336 break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	337 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	338 result ~= makeString(begin, p);
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	339 } // <tag ...> or </tag>
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	340 else if (p < end && (isalpha(p) \|\| p == '/'))
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	341 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	342 while (++p < end && *p != '>') // Skip to closing '>'.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	343 {}
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	344 if (p == end)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	345 { // No closing '>' found.
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	346 p = begin + 1;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	347 result ~= "<";
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	348 continue;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	349 }
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	350 p++; // Skip '>'.
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	351 result ~= makeString(begin, p);
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 else
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	354 result ~= "<";
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	355 continue;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	356 case '(': result ~= "("; break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	357 case ')': result ~= ")"; break;
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	358 // case '\'': result ~= "'"; break; // '
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	359 // case '"': result ~= """; break;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	360 case '>': result ~= ">"; break;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	361 case '&':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	362 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	363 goto default;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	364 result ~= "&";
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	365 break;
754 c7a5499faa77 Improved DDoc related code. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 751 diff changeset	366 case '\n':
c7a5499faa77 Improved DDoc related code. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 751 diff changeset	367 if (!(p+1 < end && p[1] == '\n'))
c7a5499faa77 Improved DDoc related code. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 751 diff changeset	368 goto default;
c7a5499faa77 Improved DDoc related code. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 751 diff changeset	369 ++p;
c7a5499faa77 Improved DDoc related code. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 751 diff changeset	370 result ~= "$(DDOC_BLANKLINE)";
c7a5499faa77 Improved DDoc related code. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 751 diff changeset	371 break;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	372 case '-':
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	373 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	374 {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	375 while (p < end && *p == '-')
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	376 p++;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	377 auto codeBegin = p;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	378 p--;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	379 while (++p < end)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	380 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	381 break;
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	382 auto codeText = makeString(codeBegin, p);
307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	383 result ~= tokenHL.highlight(codeText, modul.filePath);
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	384 while (p < end && *p == '-')
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	385 p++;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	386 continue;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	387 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	388 //goto default;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	389 default:
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	390 result ~= *p;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	391 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	392 p++;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	393 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	394 return result;
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	395 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	396
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	397 /// Escapes '<', '>' and '&' with named HTML entities.
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	398 char[] escape(char[] text)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	399 {
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	400 char[] result = new char[text.length]; // Reserve space.
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	401 result.length = 0;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	402 foreach(c; text)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	403 switch(c)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	404 {
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	405 case '<': result ~= "<"; break;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	406 case '>': result ~= ">"; break;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	407 case '&': result ~= "&"; break;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	408 default: result ~= c;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	409 }
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	410 if (result.length != text.length)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	411 return result;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	412 // Nothing escaped. Return original text.
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	413 delete result;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	414 return text;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	415 }
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	416
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	417 /// Writes an array of strings to the text buffer.
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	418 void write(char[][] strings...)
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	419 {
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	420 foreach (s; strings)
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	421 text ~= s;
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	422 }
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	423
8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	424 /// Writes params to the text buffer.
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	425 void writeParams(Parameters params)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	426 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	427 if (!params.items.length)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	428 return write("()");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	429 write("(");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	430 auto lastParam = params.items[$-1];
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	431 foreach (param; params.items)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	432 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	433 if (param.isCVariadic)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	434 write("...");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	435 else
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	436 {
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	437 assert(param.type);
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	438 // Write storage classes.
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	439 auto typeBegin = param.type.baseType.begin;
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	440 if (typeBegin !is param.begin) // Write storage classes.
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	441 write(textSpan(param.begin, typeBegin.prevNWS), " ");
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	442 write(escape(textSpan(typeBegin, param.type.end))); // Write type.
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	443 if (param.name)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	444 write(" $(DDOC_PARAM ", param.name.str, ")");
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	445 if (param.isDVariadic)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	446 write("...");
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	447 if (param.defValue)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	448 write(" = ", escape(textSpan(param.defValue.begin, param.defValue.end)));
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	449 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	450 if (param !is lastParam)
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	451 write(", ");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	452 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	453 write(")");
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	454 }
00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	455
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	456 /// Writes the current template parameters to the text buffer.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	457 void writeTemplateParams()
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	458 {
766 0af3b145a405 Revised TemplateParameterList parsing functions. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 765 diff changeset	459 if (!tparams)
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	460 return;
766 0af3b145a405 Revised TemplateParameterList parsing functions. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 765 diff changeset	461 write(escape(textSpan(tparams.begin, tparams.end)));
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	462 tparams = null;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	463 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	464
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	465 /// Writes bases to the text buffer.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	466 void writeInheritanceList(BaseClassType[] bases)
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 if (bases.length == 0)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	469 return;
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	470 auto basesBegin = bases[0].begin.prevNWS;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	471 if (basesBegin.kind == TOK.Colon)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	472 basesBegin = bases[0].begin;
777 9f61e8af55d5 Added module dil.Compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 776 diff changeset	473 write(" : ", escape(textSpan(basesBegin, bases[$-1].end)));
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	474 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	475
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	476 /// Writes a symbol to the text buffer. E.g: $(SYMBOL Buffer, 123)
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	477 void SYMBOL(char[] name, Declaration d)
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	478 {
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	479 auto loc = d.begin.getRealLocation();
777 9f61e8af55d5 Added module dil.Compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 776 diff changeset	480 auto str = Format("$(SYMBOL {}, {})", name, loc.lineNum);
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	481 write(str);
26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	482 // write("$(DDOC_PSYMBOL ", name, ")");
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	483 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	484
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	485 /// Offset at which to insert a declaration which have a "ditto" comment.
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	486 uint prevDeclOffset;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	487
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	488 /// Writes a declaration to the text buffer.
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	489 void DECL(void delegate() dg, Declaration d, bool writeSemicolon = true)
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	490 {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	491 if (cmntIsDitto)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	492 { alias prevDeclOffset offs;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	493 assert(offs != 0);
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	494 auto savedText = text;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	495 text = "";
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	496 write("\n$(DDOC_DECL ");
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	497 dg();
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	498 writeSemicolon && write(";");
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	499 writeAttributes(d);
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	500 write(")");
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	501 // Insert text at offset.
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	502 auto len = text.length;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	503 text = savedText[0..offs] ~ text ~ savedText[offs..$];
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	504 offs += len; // Add length of the inserted text to the offset.
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	505 return;
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	506 }
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	507 write("\n$(DDOC_DECL ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	508 dg();
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	509 writeSemicolon && write(";");
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	510 writeAttributes(d);
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	511 write(")");
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	512 prevDeclOffset = text.length;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	513 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	514
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	515 /// Wraps the DDOC_DECL_DD macro around the text written by dg().
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	516 void DESC(void delegate() dg)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	517 {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	518 if (cmntIsDitto)
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	519 return;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	520 write("\n$(DDOC_DECL_DD ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	521 dg();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	522 write(")");
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
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	525 /// Wraps the DDOC_kind_MEMBERS macro around the text written by dg().
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	526 void MEMBERS(char[] kind, void delegate() dg)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	527 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	528 write("\n$(DDOC_"~kind~"_MEMBERS ");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	529 dg();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	530 write(")");
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
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	533 /// Writes a class or interface declaration.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	534 void writeClassOrInterface(T)(T d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	535 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	536 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	537 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	538 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	539 write(d.begin.srcText, " ");
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	540 SYMBOL(d.name.str, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	541 writeTemplateParams();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	542 writeInheritanceList(d.bases);
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	543 }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	544 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	545 writeComment();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	546 MEMBERS(is(T == ClassDeclaration) ? "CLASS" : "INTERFACE", {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	547 scope s = new Scope();
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	548 d.decls && super.visit(d.decls);
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 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	552
801 c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	553 // templated decls are not virtual so we need these:
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	554
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	555 /// Writes a class declaration.
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	556 void writeClass(ClassDeclaration d) {
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	557 writeClassOrInterface(d);
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	558 }
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	559
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	560 /// Writes an interface declaration.
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	561 void writeInterface(InterfaceDeclaration d) {
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	562 writeClassOrInterface(d);
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	563 }
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	564
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	565 /// Writes a struct or union declaration.
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	566 void writeStructOrUnion(T)(T 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 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	569 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	570 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	571 write(d.begin.srcText, d.name ? " " : "");
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	572 if (d.name)
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	573 SYMBOL(d.name.str, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	574 writeTemplateParams();
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	575 }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	576 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	577 writeComment();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	578 MEMBERS(is(T == StructDeclaration) ? "STRUCT" : "UNION", {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	579 scope s = new Scope();
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	580 d.decls && super.visit(d.decls);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	581 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	582 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	583 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	584
801 c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	585 // templated decls are not virtual so we need these:
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	586
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	587 /// Writes a struct declaration.
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	588 void writeStruct(StructDeclaration d) {
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	589 writeStructOrUnion(d);
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	590 }
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	591
807 a2880c95eda3 Refactored ddoc command. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 806 diff changeset	592 /// Writes a union declaration.
801 c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	593 void writeUnion(UnionDeclaration d) {
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	594 writeStructOrUnion(d);
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	595 }
c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	596
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	597 /// Writes an alias or typedef declaration.
773 6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	598 void writeAliasOrTypedef(T)(T d)
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	599 {
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	600 auto prefix = is(T == AliasDeclaration) ? "alias " : "typedef ";
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	601 if (auto vd = d.decl.Is!(VariablesDeclaration))
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	602 {
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	603 auto type = textSpan(vd.typeNode.baseType.begin, vd.typeNode.end);
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	604 foreach (name; vd.names)
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	605 DECL({ write(prefix); write(escape(type), " "); SYMBOL(name.str, d); }, d);
773 6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	606 }
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	607 else if (auto fd = d.decl.Is!(FunctionDeclaration))
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	608 {}
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	609 // DECL({ write(textSpan(d.begin, d.end)); }, false);
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	610 DESC({ writeComment(); });
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	611 }
6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	612
783 8380fb2c765f Added documentation comments. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 779 diff changeset	613 /// Writes the attributes of a declaration in brackets.
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	614 void writeAttributes(Declaration d)
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	615 {
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	616 char[][] attributes;
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	617
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	618 if (d.prot != Protection.None)
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	619 attributes ~= "$(PROT " ~ .toString(d.prot) ~ ")";
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	620
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	621 auto stc = d.stc;
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	622 stc &= ~StorageClass.Auto; // Ignore auto.
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	623 foreach (stcStr; .toStrings(stc))
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	624 attributes ~= "$(STC " ~ stcStr ~ ")";
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	625
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	626 LinkageType ltype;
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	627 if (auto vd = d.Is!(VariablesDeclaration))
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	628 ltype = vd.linkageType;
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	629 else if (auto fd = d.Is!(FunctionDeclaration))
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	630 ltype = fd.linkageType;
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	631
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	632 if (ltype != LinkageType.None)
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	633 attributes ~= "$(LINKAGE extern(" ~ .toString(ltype) ~ "))";
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	634
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	635 if (!attributes.length)
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	636 return;
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	637
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	638 write(" $(ATTRIBUTES ");
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	639 write(attributes[0]);
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	640 foreach (attribute; attributes[1..$])
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	641 write(", ", attribute);
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	642 write(")");
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	643 }
e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	644
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	645 alias Declaration 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 override:
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	648 D visit(AliasDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	649 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	650 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	651 return d;
773 6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	652 writeAliasOrTypedef(d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	653 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	654 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	655
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	656 D visit(TypedefDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	657 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	658 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	659 return d;
773 6dbbb403fc58 Improved the DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 772 diff changeset	660 writeAliasOrTypedef(d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	661 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	662 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	663
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	664 D visit(EnumDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	665 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	666 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	667 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	668 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	669 write("enum", d.name ? " " : "");
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	670 d.name && SYMBOL(d.name.str, d);
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	671 }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	672 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	673 writeComment();
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	674 MEMBERS("ENUM", { scope s = new Scope(); super.visit(d); });
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	675 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	676 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	677 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	678
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	679 D visit(EnumMemberDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	680 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	681 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	682 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	683 DECL({ SYMBOL(d.name.str, d); }, d, false);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	684 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	685 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	686 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	687
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	688 D visit(TemplateDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	689 {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	690 this.tparams = d.tparams;
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	691 if (d.begin.kind != TOK.Template)
765 bc812843603c Template functions are wrapped inside TemplateDeclarations now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 764 diff changeset	692 { // This is a templatized class/interface/struct/union/function.
bc812843603c Template functions are wrapped inside TemplateDeclarations now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 764 diff changeset	693 super.visit(d.decls);
bc812843603c Template functions are wrapped inside TemplateDeclarations now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 764 diff changeset	694 this.tparams = null;
bc812843603c Template functions are wrapped inside TemplateDeclarations now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 764 diff changeset	695 return d;
bc812843603c Template functions are wrapped inside TemplateDeclarations now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 764 diff changeset	696 }
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	697 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	698 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	699 DECL({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	700 write("template ");
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	701 SYMBOL(d.name.str, d);
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	702 writeTemplateParams();
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	703 }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	704 DESC({
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	705 writeComment();
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	706 MEMBERS("TEMPLATE", {
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	707 scope s = new Scope();
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	708 super.visit(d.decls);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	709 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	710 });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	711 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	712 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	713
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	714 D visit(ClassDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	715 {
801 c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	716 writeClass(d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	717 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	718 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	719
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	720 D visit(InterfaceDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	721 {
801 c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	722 writeInterface(d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	723 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	724 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	725
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	726 D visit(StructDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	727 {
801 c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	728 writeStruct(d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	729 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	730 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	731
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	732 D visit(UnionDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	733 {
801 c39667f1e814 Fixes to non-virtual functions. Commented out broken method for enums. Jari-Matti M?kel? <jmjm@iki.fi> parents: 800 diff changeset	734 writeUnion(d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	735 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	736 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	737
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	738 D visit(ConstructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	739 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	740 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	741 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	742 DECL({ SYMBOL("this", d); writeParams(d.params); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	743 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	744 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	745 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	746
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	747 D visit(StaticConstructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	748 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	749 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	750 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	751 DECL({ write("static "); SYMBOL("this", d); write("()"); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	752 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	753 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	754 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	755
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	756 D visit(DestructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	757 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	758 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	759 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	760 DECL({ write("~"); SYMBOL("this", d); write("()"); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	761 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	762 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	763 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	764
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	765 D visit(StaticDestructorDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	766 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	767 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	768 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	769 DECL({ write("static ~"); SYMBOL("this", d); write("()"); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	770 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	771 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	772 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	773
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	774 D visit(FunctionDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	775 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	776 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	777 return d;
747 00f872d949ea Added method scanCommentText() to DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 744 diff changeset	778 auto type = textSpan(d.returnType.baseType.begin, d.returnType.end);
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	779 DECL({
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	780 write(escape(type), " ");
770 26d8ed59806d Emitting SYMBOL macro with interesting parameters. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 766 diff changeset	781 SYMBOL(d.name.str, d);
751 8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	782 writeTemplateParams();
8caf18892c1b Improved DDocEmitter and fixed bugs. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 747 diff changeset	783 writeParams(d.params);
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	784 }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	785 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	786 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	787 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	788
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	789 D visit(NewDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	790 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	791 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	792 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	793 DECL({ SYMBOL("new", d); writeParams(d.params); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	794 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	795 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	796 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	797
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	798 D visit(DeleteDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	799 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	800 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	801 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	802 DECL({ SYMBOL("delete", d); writeParams(d.params); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	803 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	804 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	805 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	806
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	807 D visit(VariablesDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	808 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	809 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	810 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	811 char[] type = "auto";
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	812 if (d.typeNode)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	813 type = textSpan(d.typeNode.baseType.begin, d.typeNode.end);
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	814 foreach (name; d.names)
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	815 DECL({ write(escape(type), " "); SYMBOL(name.str, d); }, d);
761 307905dadf5d DDoc code sections are highlighted now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 754 diff changeset	816 DESC({ writeComment(); });
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	817 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	818 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	819
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	820 D visit(InvariantDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	821 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	822 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	823 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	824 DECL({ SYMBOL("invariant", d); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	825 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	826 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	827 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	828
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	829 D visit(UnittestDeclaration d)
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	830 {
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	831 if (!ddoc(d))
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	832 return d;
775 e76c9fdb83a3 DDocEmitter emits declaration attributes now. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 773 diff changeset	833 DECL({ SYMBOL("unittest", d); }, d);
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	834 DESC({ writeComment(); });
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	835 return d;
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	836 }
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	837
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	838 D visit(DebugDeclaration d)
778 78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	839 {
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	840 d.compiledDecls && visitD(d.compiledDecls);
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	841 return d;
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	842 }
737 f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	843
f88b5285b86b Implemented DDocEmitter. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 731 diff changeset	844 D visit(VersionDeclaration d)
778 78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	845 {
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	846 d.compiledDecls && visitD(d.compiledDecls);
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	847 return d;
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	848 }
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	849
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	850 D visit(StaticIfDeclaration d)
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	851 {
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	852 d.ifDecls && visitD(d.ifDecls);
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	853 return d;
78be32e3e157 Implemented conditional compilation. Aziz K?ksal <aziz.koeksal@gmail.com> parents: 777 diff changeset	854 }
731 ca7607226caa Added new module cmd.DDoc. Aziz K?ksal <aziz.koeksal@gmail.com> parents: diff changeset	855 }

Mercurial > projects > dil

annotate src/cmd/DDoc.d @ 810:525ee3f848d9