141 lines
3.3 KiB
C#
141 lines
3.3 KiB
C#
//
|
|
// The assembler: Help compiler.
|
|
//
|
|
// Author:
|
|
// Miguel de Icaza (miguel@gnome.org)
|
|
//
|
|
// (C) 2003 Ximian, Inc.
|
|
//
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Linq;
|
|
using System.Xml;
|
|
using Monodoc;
|
|
using Monodoc.Providers;
|
|
using Mono.Options;
|
|
|
|
namespace Mono.Documentation {
|
|
|
|
public class MDocAssembler : MDocCommand {
|
|
static readonly string[] ValidFormats = {
|
|
"ecma",
|
|
"ecmaspec",
|
|
"error",
|
|
"hb",
|
|
"man",
|
|
"simple",
|
|
"xhtml"
|
|
};
|
|
|
|
public static Option[] CreateFormatOptions (MDocCommand self, Dictionary<string, List<string>> formats)
|
|
{
|
|
string cur_format = "ecma";
|
|
var options = new OptionSet () {
|
|
{ "f|format=",
|
|
"The documentation {FORMAT} used in DIRECTORIES. " +
|
|
"Valid formats include:\n " +
|
|
string.Join ("\n ", ValidFormats) + "\n" +
|
|
"If not specified, the default format is `ecma'.",
|
|
v => {
|
|
if (Array.IndexOf (ValidFormats, v) < 0)
|
|
self.Error ("Invalid documentation format: {0}.", v);
|
|
cur_format = v;
|
|
} },
|
|
{ "<>", v => AddFormat (self, formats, cur_format, v) },
|
|
};
|
|
return new Option[]{options[0], options[1]};
|
|
}
|
|
|
|
public override void Run (IEnumerable<string> args)
|
|
{
|
|
var formats = new Dictionary<string, List<string>> ();
|
|
string prefix = "tree";
|
|
var formatOptions = CreateFormatOptions (this, formats);
|
|
var options = new OptionSet () {
|
|
formatOptions [0],
|
|
{ "o|out=",
|
|
"Provides the output file prefix; the files {PREFIX}.zip and " +
|
|
"{PREFIX}.tree will be created.\n" +
|
|
"If not specified, `tree' is the default PREFIX.",
|
|
v => prefix = v },
|
|
formatOptions [1],
|
|
};
|
|
List<string> extra = Parse (options, args, "assemble",
|
|
"[OPTIONS]+ DIRECTORIES",
|
|
"Assemble documentation within DIRECTORIES for use within the monodoc browser.");
|
|
if (extra == null)
|
|
return;
|
|
|
|
List<Provider> list = new List<Provider> ();
|
|
EcmaProvider ecma = null;
|
|
bool sort = false;
|
|
|
|
foreach (string format in formats.Keys) {
|
|
switch (format) {
|
|
case "ecma":
|
|
if (ecma == null) {
|
|
ecma = new EcmaProvider ();
|
|
list.Add (ecma);
|
|
sort = true;
|
|
}
|
|
foreach (string dir in formats [format])
|
|
ecma.AddDirectory (dir);
|
|
break;
|
|
|
|
case "xhtml":
|
|
case "hb":
|
|
list.AddRange (formats [format].Select (d => (Provider) new XhtmlProvider (d)));
|
|
break;
|
|
|
|
case "man":
|
|
list.Add (new ManProvider (formats [format].ToArray ()));
|
|
break;
|
|
|
|
case "error":
|
|
list.AddRange (formats [format].Select (d => (Provider) new ErrorProvider (d)));
|
|
break;
|
|
|
|
case "ecmaspec":
|
|
list.AddRange (formats [format].Select (d => (Provider) new EcmaSpecProvider (d)));
|
|
break;
|
|
|
|
case "addins":
|
|
list.AddRange (formats [format].Select (d => (Provider) new AddinsProvider (d)));
|
|
break;
|
|
}
|
|
}
|
|
|
|
HelpSource hs = new HelpSource (prefix, true);
|
|
hs.TraceLevel = TraceLevel;
|
|
|
|
foreach (Provider p in list) {
|
|
p.PopulateTree (hs.Tree);
|
|
}
|
|
|
|
if (sort && hs.Tree != null)
|
|
hs.Tree.RootNode.Sort ();
|
|
|
|
//
|
|
// Flushes the EcmaProvider
|
|
//
|
|
foreach (Provider p in list)
|
|
p.CloseTree (hs, hs.Tree);
|
|
|
|
hs.Save ();
|
|
}
|
|
|
|
private static void AddFormat (MDocCommand self, Dictionary<string, List<string>> d, string format, string file)
|
|
{
|
|
if (format == null)
|
|
self.Error ("No format specified.");
|
|
List<string> l;
|
|
if (!d.TryGetValue (format, out l)) {
|
|
l = new List<string> ();
|
|
d.Add (format, l);
|
|
}
|
|
l.Add (file);
|
|
}
|
|
}
|
|
|
|
}
|