X-Git-Url: http://nitlanguage.org diff --git a/src/nitdoc.nit b/src/nitdoc.nit index 5a42c91..e0c343a 100644 --- a/src/nitdoc.nit +++ b/src/nitdoc.nit @@ -13,35 +13,62 @@ # limitations under the License. # Documentation generator for the nit language. +# # Generate API documentation in HTML format from nit source code. module nitdoc import modelbuilder import doc -# process options +redef class ToolContext + # Nitdoc generation phase. + var docphase: Phase = new Nitdoc(self, null) +end + +# Nitdoc phase explores the model and generate pages for each mentities found +private class Nitdoc + super Phase + redef fun process_mainmodule(mainmodule, mmodules) + do + var doc = new DocModel(mainmodule.model, mainmodule) + + var phases = [ + new ExtractionPhase(toolcontext, doc), + new IndexingPhase(toolcontext, doc), + new MakePagePhase(toolcontext, doc), + new POSetPhase(toolcontext, doc), + new ConcernsPhase(toolcontext, doc), + new StructurePhase(toolcontext, doc), + new InheritanceListsPhase(toolcontext, doc), + new IntroRedefListPhase(toolcontext, doc), + new LinListPhase(toolcontext, doc), + new GraphPhase(toolcontext, doc), + new RenderHTMLPhase(toolcontext, doc): DocPhase] + + for phase in phases do + toolcontext.info("# {phase.class_name}", 1) + phase.apply + end + end +end + +# build toolcontext var toolcontext = new ToolContext -var ctx = new NitdocContext(toolcontext) -ctx.process_options(args) -var arguments = ctx.toolcontext.option_context.rest +var tpl = new Template +tpl.add "Usage: nitdoc [OPTION]... ...\n" +tpl.add "Generates HTML pages of API documentation from Nit source files." +toolcontext.tooldescription = tpl.write_to_string + +# process options +toolcontext.process_options(args) +var arguments = toolcontext.option_context.rest # build model var model = new Model -var mbuilder = new ModelBuilder(model, ctx.toolcontext) -var mmodules = mbuilder.parse(arguments) +var mbuilder = new ModelBuilder(model, toolcontext) +var mmodules = mbuilder.parse_full(arguments) +# process if mmodules.is_empty then return mbuilder.run_phases -var mainmodule: MModule -if mmodules.length == 1 then - mainmodule = mmodules.first -else - mainmodule = new MModule(model, null, "
", new Location(null, 0, 0, 0, 0)) - mainmodule.is_fictive = true - mainmodule.set_imported_mmodules(mmodules) -end - -# generate doc -var nitdoc = new Nitdoc(ctx, model, mainmodule) -nitdoc.generate - +toolcontext.run_global_phases(mmodules)