mcs/tools/monodoc/ChangeLog

   1 2009-02-09  Jonathan Pryor  <jonpryor@vt.edu>
   2
   3         * Makefile: Don't include mono-ecma-css.js as a resource.
   4         * Monodoc/ecma-provider.cs: Insert helper.js, not mono-ecma-css.js.
   5         * Monodoc/provider.cs: Surround the contents of `helper.js' with a
   6           <script/> block so that valid HTMl is generated.
   7         * Resources/helper.js: Remove <script/> block, so that `helper.js' is an
   8           actual JavaScript file, not an SGML file w/ JavaScript content.
   9         * Resources/mono-ecma-css.js: Remove; use Resources/helper.js instead.
  10
  11 2009-01-05  Jonathan Pryor  <jonpryor@vt.edu>
  12
  13         * Makefile: Fix $(the_lib) dependencies so that monodoc.dll is rebuilt
  14           when one of Resources/* is modified.
  15         * Resources/mdoc-html-utils.xsl: Rework the Requirements block so that
  16           it doesn't require //AssemblyInfo or //AssemblyVersion.  This allows
  17           `mdoc update -fno-assembly-versions ...`-produced XML to still
  18           produce HTML with a Requirements section (skipping the Assembly
  19           Versions block but generating the Namespace and Assembly blocks).
  20           Change the behavior of //since generation so that instead of
  21           printing out a note before the method summary, a Since block is added
  22           to the Requirements section, and the Since block contains the
  23           //since/@version text.  All this to make Mike Kestner happier. :-)
  24
  25 2008-10-29  Jonathan Pryor  <jonpryor@vt.edu>
  26
  27         * Monodoc/xhtml-provider.cs: Use HelpSource.Message(), not
  28           Console.WriteLine().
  29
  30 2008-10-28  Jonathan Pryor  <jonpryor@vt.edu>
  31
  32         * Monodoc/provider.cs: Add HelpSource.InlineCss and
  33           HelpSource.InlineJavaScript virtual properties, so that the help
  34           source can provide specific CSS and JavaScript to be included into
  35           the generated HTML document.  This is used by the ASP.NET front-end,
  36           as it needs to insert the CSS & JavaScript separately (as it also
  37           inserts its own CSS & JavaScript).
  38         * Monodoc/ecma-provider.cs, Monodoc/ecmaspec-provider.cs,
  39           Monodoc/error-provider.cs: Override InlineCss & InlineJavaScript, as
  40           appropriate.
  41
  42 2008-10-24  Jonathan Pryor  <jonpryor@vt.edu>
  43
  44         * Monodoc/addins-provider.cs, Monodoc/ecma-provider.cs,
  45           Monodoc/ecmaspec-provider.cs, Monodoc/error-provider.cs,
  46           Monodoc/man-provider.cs, Monodoc/monohb-provider.cs,
  47           Monodoc/provider.cs: Remove Console.WriteLine() spew; helps cleanup
  48           `make` output in mcs/docs (from `mdoc assemble`, which indirectly
  49           invokes most of the *-provider files).  We solve this problem by
  50           providing a TraceLevel-based message system, so that messages are
  51           only generated if they are less than or equal to the requested
  52           output level (thus skipping the more verbose "every file" messages
  53           from ecma-provider.cs & error-provider.cs).
  54         * provider.cs: Change Node.CompareTo() to use a "natural sorting"
  55           algorithm -- this allows the C# Language Specification nodes to
  56           continue being displayed in the correct order.
  57
  58 2008-10-21  Jonathan Pryor  <jonpryor@vt.edu>
  59
  60         * Monodoc/provider.cs:
  61           - Fix Node.Sort() so that it doesn't NRE if nodes == null.
  62           - Fix Node.CompareTo() so that it can sort Nodes that haven't been
  63             loaded yet.
  64           - Add "libraries" as an alias for "root", so that .source files can
  65             refer to the parent "libraries" (which would allow us to change
  66             the location of "libraries" in the future, should we want to).
  67           - If a /monodoc/source/@path refers to a nonexistant node, then
  68             insert the contents under Various instead of ignoring it.
  69           - Sort the top-level nodes.
  70           - Sort the `parent` node after inserting children under it.  This
  71             allows multiple different .source files to insert nodes under the
  72             same parent node and still have the child nodes sorted as most
  73             mortals would expect.
  74           - Support a //node/@parent attribute, which allows for creating
  75             nodes underneath the specified parent node.  This allows multiple
  76             different .source files to contribute to the tree and depend upon
  77             each other.  Thus, instead of having a single monodoc.xml file
  78             that needs to know the entire tree in advance, the entire tree can
  79             be spread across multiple .source files and filled at runtime.
  80
  81 2008-10-18  Jonathan Pryor  <jonpryor@vt.edu>
  82
  83         * Makefile $(LIBRARY_PACKAGE): Set to `monodoc`, as we historically
  84           have had a monodoc package (and thus should preserve it).
  85
  86 2008-10-17  Jonathan Pryor  <jonpryor@vt.edu>
  87
  88         * Makefile: Distribute monodoc.dll.config.in.
  89
  90 2008-10-17  Jonathan Pryor  <jonpryor@vt.edu>
  91
  92         * Makefile: Generate a monodoc.dll.config (installed by gacutil), so
  93           that monodoc.dll can find the documentation sources.
  94
  95 2008-10-16  Jonathan Pryor  <jonpryor@vt.edu>
  96
  97         * Mono.Documentation/ManifestResourceResolver.cs,
  98           Mono.Documentation/XmlDocUtils.cs: Make types public so that they
  99           can be used from ../mdoc/mdoc.exe.
 100
 101 2008-10-16  Jonathan Pryor  <jonpryor@vt.edu>
 102
 103         * Makefile: Update $(thisdir).
 104
 105 2008-10-16  Jonathan Pryor  <jonpryor@vt.edu>
 106
 107         * Assmbly/AssemblyInfo.cs: Change location of mono.snk (since the
 108           monodoc directory was moved from mcs/class to mcs/tools).
 109
 110 2008-10-16  Jonathan Pryor  <jonpryor@vt.edu>
 111
 112         * Makefile: Improve `make clean` support.
 113
 114 2008-10-16  Jonathan Pryor  <jonpryor@vt.edu>
 115
 116         * Makefile: Add EXTRA_DISTFILES; monodoc.dll should depend upon
 117           Makefile (in case the /resource: lines change); shorten the .gif
 118           resource names.
 119
 120 2008-10-16  Jonathan Pryor  <jonpryor@vt.edu>
 121
 122         * Test (svn:ignore): Ignore generated files.
 123         * Makefile: Add tests for man-provider.
 124
 125 2008-10-16  Jonathan Pryor  <jonpryor@vt.edu>
 126
 127         * ChangeLog: Added/Started.
 128         * Makefile: Added; build monodoc.dll.
 129