Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/mono/api-doc-tools.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/mdoc
diff options
context:
space:
mode:
authorAlexander Köplinger <alex.koeplinger@outlook.com>2016-01-29 21:17:03 +0300
committerDuncan Mak <duncanm@microsoft.com>2016-10-08 03:31:11 +0300
commitf3de407a13d9f79c796710b6a8301f152583a368 (patch)
treeb9e3d17e111e6b0af9cb222ded1ce1e5cf7c7a87 /mdoc
parent8008a2bcb49ecebd4f7f3aef82f51480e9a1f112 (diff)
Remove ChangeLog files from the repo
They weren't updated in the last 6 years and aren't helpful anymore (e.g. by causing unrelated matches during git grep searches).
Diffstat (limited to 'mdoc')
-rw-r--r--mdoc/ChangeLog2575
1 files changed, 0 insertions, 2575 deletions
diff --git a/mdoc/ChangeLog b/mdoc/ChangeLog
deleted file mode 100644
index 15a2b4a0..00000000
--- a/mdoc/ChangeLog
+++ /dev/null
@@ -1,2575 +0,0 @@
-2010-06-10 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: Regenerate all index.{opts.ext}
- files if any of the source .xml files have changed. This allows
- new <summary/> values to be inserted into the index.{opts.ext}
- files, instead of the index files being "stale". Fixes #573121.
-
-2010-04-16 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Add System.Xml.Linq.dll to the referenced assemblies.
- * Mono.Documentation/webdoc.cs: Allow .source files to be provided to
- 'mdoc export-html-webdoc', which will cause the .source files to be
- read and all referenced .tree/.zip files to be processed.
-
-2010-04-16 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Use Int64 instead of UInt64 for
- enum values, so that we can properly capture negative values.
-
-2010-02-28 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: Add --use-system-sources option so
- that 'mdoc export-html-webdoc' will use the system-installed sources
- in addition to any -r'd sources (which was the behavior 2 commits
- ago).
-
-2010-02-26 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/assembler.cs: Allow other apps to get the same
- '--format' logic, specifically 'mdoc export-html-webdoc'.
- * Mono.Documentation/webdoc.cs: Allow it to be more "stand-alone".
- Previously, it would depend upon the system-wide .source files.
- This is bad, because you might want to generate the 'cache'
- directory for a different installation, with a different set of
- .tree/.zip/.source files, and you might not want to replace your own
- and/or you often forget, as is the case with me. Instead, allow a
- format to be specified for .tree files, and allow additional .source
- files to be referenced so that extension methods will be found within
- the specified sources. This allows for a "stand-alone" method of
- operation w/o depending upon the system-wide .source files.
-
-2010-01-11 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2slashdoc.cs: Fix NamespaceSummaries.xml
- generation to look at the ns-NAMESPACE.xml files, not just
- NAMESPACE.xml files.
-
-2009-12-03 Jonathan Pryor <jpryor@novell.com>
-
- * Resources/stylesheet.xsl: Add support for generating namespace links
- for <see cref="N:..." />.
- * Test/DocTest-v1.cs: Add namespace links for testing.
- * Test/en.expected.importslashdoc/Mono.DocTest/Color.xml,
- Test/en.expected.importslashdoc/NoNamespace.xml,
- Test/html.expected/index.html,
- Test/html.expected/Mono.DocTest/Color.html,
- Test/html.expected/NoNamespace.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush.
-
-2009-12-03 Jonathan Pryor <jpryor@novell.com>
-
- * Test/html.expected/Mono.DocTest.Generic/MyList`1.html,
- Test/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush to sync
- with updated mdoc. Inherited members are now shown (as they were
- supposed to be, but a bug had prevented from being found).
-
-2009-12-02 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: Enable debug output in
- XslCompiledTransform when --debug is specified.
- * Resources/overview.xsl: Add xmlns, exclude-result-prefixes so that
- .NET won't complain about the stylesheet. (Why's it complain?)
- * Resources/stylesheet.xsl: .NET compatibility fixes:
- - Use msxsl:node-set() when necessary.
- - Change XPath expressions so that they work properly everywhere.
- * Makefile: Don't build an 'mdoc-net.exe' anymore, as the normal
- mdoc.exe can now run normally under .NET.
-
-2009-11-25 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: When copying mdoc-net.exe into ./mdoc-net, rename it to
- mdoc.exe so that .NET users continue to use the name 'mdoc'. This
- will make documentation easier, etc.
-
-2009-11-25 Jonathan Pryor <jpryor@novell.com>
-
- + Giving up on getting mdoc to fully work under .NET; specifically,
- mdoc-export-html makes use of many Mono XSLT "extensions" (part of
- XSLT 2.0, apparently) which .NET doesn't support. To run mdoc under
- .NET, use mdoc-net.exe, which is a "static" mdoc.exe, including the
- sources for BOTH monodoc.dll AND Mono's System.Xml.dll in the binary.
- Yes, this makes it huge.
-
- * . (svn:ignore): Ignore generated files.
- * Makefile: If the NET variable is present (e.g. 'make NET=1'),
- generate mdoc-net.exe instead of mdoc.exe, otherwise generate
- mdoc.exe (the default, with normal dependencies). When NET is
- present, also create a 'mdoc-net' directory which contains
- mdoc-net.exe and all assembly dependencies (to make it easier to
- grab all the deps at once).
- * mdoc-net.exe.sources: Added; sources to use for mdoc-net.exe.
- * Mono.Documentation/monodocs2html.cs: Ensure that the "Index" XSLT
- variable is set before generating output.
-
-2009-11-24 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: Use XslCompiledTransform, as
- it's *significantly* faster under .NET than XslTransform --
- 1.7s vs ~3 minutes 7s (for a trivial test case).
-
-2009-11-23 Jonathan Pryor <jpryor@novell.com>
-
- * Resources/overview.xsl, Resources/stylesheet.xsl: Remove the 'ext'
- and 'language' global <xsl:param>'s, as they cause "variable 'foo'
- was duplicated within the same scope" errors under .NET.
-
-2009-11-23 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: ".NET support": ensure that we
- always get Unix line endings so that we can update documentation
- under both Mono & .NET w/o continually changing the file due to
- line-ending differences.
-
-2009-11-06 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: When deleting the ExtensionMethods
- element, remove it from the correct parent XML node. Fixes #553144.
-
-2009-09-19 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: Add --with-profile=PROFILE
- option, which just provides a simple mapping between profile names
- like net_3_5 to the versions used in that profile.
-
-2009-09-19 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: By request of Edd Dumbill, add
- --with-version=VERSION option. This will generate HTML
- documentation for ONLY those types/members which exist within
- VERSION. This makes it easy to generate HTML that will show e.g.
- only MonoTouch docs (and not the full class library docs).
- * Makefile: Add test for 'mdoc export-html --with-version=VERSION'.
- Somewhat brain-dead, as it only checks for added types (and not
- added members), but better than nothing...
-
-2009-09-09 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: Fix behavior when multiple
- source directories are provided, e.g. 'mdoc export-html -o o a b c'
- with docs located in directories a, b, and c. Previously this would
- be equivalent to running aginst a, b, and c separately, resulting in
- o/index.html being continually overwritten (and thus not showing ALL
- available types).
- * Resources/stylesheet.xsl: Make $Index a parameter (as monodocs2html
- will create an in-memory index containing all types from all
- specified directories), and various changes to cope with $Index no
- longer being a file. Better support files in the global namespace.
- * Test/html.expected/NoNamespace.html: Fix assembly link.
-
-2009-08-12 Jonathan Pryor <jpryor@novell.com>
-
- * Test/DocTest-v1.cs: Add a comment which uses <format/>, to test html
- escaping behavior.
- * Resources/monodoc-ecma.xsd: Permit <format/> in various elements.
- * Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- Test/html.expected/Mono.DocTest/DocAttribute.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush.
-
-2009-08-12 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Add ../monodoc/Resources/mdoc-html-format.xsl as a resource.
-
-2009-08-06 Jonathan Pryor <jpryor@novell.com>
-
- * mdoc.exe.sources: Add ../../build/common/Consts.cs to the build.
- * Mono.Documentation/mdoc.cs: mdoc version is Consts.MonoVersion, not
- some hard-coded, perpetually out-of-date version.
-
-2009-08-02 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Sometimes <AssemblyVersion/> is
- found twice when it's actually present only once (!). Attempt to
- work around this by usinq LINQ instead of a foreach (which oddly
- works...).
-
-2009-07-31 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Record attributes that are placed
- on property get/set and event add/remove accessors.
- * Test/DocTest-v1.cs: Add attributes to some accessors.
- * Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- Test/en.expected.since/Mono.DocTest/Widget.xml,
- Test/en.expected/Mono.DocTest/Widget.xml,
- Test/html.expected/Mono.DocTest/Widget.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush.
-
-2009-06-23 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Don't generate an exception when an
- enumeration contains multiple names with the same value.
- Fixes #515030.
- * Test/DocTest-v1.cs: Add test for #515030.
- * Test/en.expected/Mono.DocTest/Color.xml,
- Test/en.expected.since/Mono.DocTest/Color.xml,
- Test/html.expected/Mono.DocTest/Color.html,
- Test/msxdoc-expected.importslashdoc.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Color.xml: Flush.
-
-2009-04-18 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: Change -o semantics to be a directory
- prefix, e.g. `mdoc export-html-webdoc -o cache.new foo.tree` will
- output files into `cache.new/foo` instead of directly into
- `cache.new`. This makes it easier to specify more than one
- .tree/.zip file on the command line.
-
-2009-04-16 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2slashdoc.cs: Code refactor; use
- EcmaDoc.GetCref() to generate //member/@name values.
- * Mono.Documentation/dump.cs: Add -f=FORMAT support, so that we can
- load an appropriate HelpSource (if supplied) so that an appropriate
- Node.PublicUrl can be displayed in the output.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: Remove console debug spew. If you run
- with `mdoc -v`, each URL will be printed as it's processed.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: When extracting files from the .zip
- file, ensure that the output file is closed. Properly pre-render
- ecma namespace documentation.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Add reference to ICSharpCode.SharpZipLib.dll.
- * mdoc.exe.sources: Add Mono.Rocks/ObjectRocks.cs,
- Mono.Rocks/StreamRocks.cs.
- * Mono.Documentation/webdoc.cs: Refactor into smaller methods. Extract
- ZIP file contents in addition to generating HTML output. Use
- monodoc helper methods to determine cache directory.
- * Mono.Documentation/ObjectRocks.cs: Rename to
- Mono.Rocks/ObjectRocks.cs.
- * Mono.Rocks/ObjectRocks.cs: Add Check.Destination().
- * Mono.Rocks/StreamRocks.cs: Added; extension methods for Streams.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: The timestamp logic was wrong it the
- output directory didn't exist. Fix.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: Do as make(1) does: if the
- target directory already exists and is newer than the source files,
- don't regenerate output. (Greatly speeds things up if nothing has
- changed.) Add a --force-update option to disable this behavior.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: Change the default -o value to
- include a "cache" intermediate directory. This makes it easier to
- kill the entire cache at once.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: Provide nice default -o value.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/webdoc.cs: Load documentation through a
- HelpSource, not through the RootTree, as URLs of the form
- "ecma:0#AvoidExtensionMethodOnSystemObjectRule/" use the number (0
- in this case) as a HelpSource-relative identifier. Result: you get
- the wrong documentation if you go through RootTree.
-
-2009-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Add reference to System.Web.dll, for HttpUtility.
- * mdoc.exe.sources: Add ObjectRocks.cs, webdoc.cs to the build.
- * Mono.Documentation/mdoc.cs: Add export-html-webdoc command, which
- "pre-renders" HTML for use by the webdoc ASP.NET renderer.
- * Mono.Documentation/webdoc.cs: Added; MDocExportWebdocHtml
- implementation; attempts to pre-render HTML based on .tree/.zip
- file contents.
- * Mono.Documentation/ObjectRocks.cs: Added; extension methods for tree
- traversal (from Mono.Rocks). For use in webdoc.cs.
-
-2009-04-09 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Using a single IAssemblyResolver is
- an improvement, but doesn't fix all problems. In particular, some
- assemblies will depend upon other assemblies to load (e.g. 3rd party
- assemblies) but these dependent assemblies shouldn't be documented.
- Add support for -r:ASSEMBLY and -L:DIRECTORY arguments to allow the
- user to manually add to the assembly search path so that assemblies
- can be found. Assemblies added via -r will NOT be documented.
-
-2009-04-08 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Use a single IAssemblyResolver
- shared amongst all AssemblyDefinitions to resolve assembly/type
- references with Cecil. Otherwise, if we have deeply nested
- directories with cross-directory assembly dependencies, then Cecil
- won't find the necessary assemblies (e.g. b/bin/Debug/b.dll has a
- type which inherits from a/bin/Debug/a.dll -- here, we'll have two
- separate AssemblyDefinitions, and when b.dll's AssemblyDefinition
- tries to resolve types from a.dll, it fails).
- See: http://lists.ximian.com/pipermail/mono-devel-list/2009-April/031646.html
-
-2009-03-29 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/exceptions.cs: Add
- ExceptionLocations.AddedMember, used for --exceptions=added support.
- * Mono.Documentation/monodocer.cs: Add --exceptions=added, which will
- only add <exception/> elements for newly added elements. This is
- useful for updating documentation for established projects which
- already have <exception/> corrections (e.g. *removal* of
- <exception/> elements because the exceptions weren't actually
- possible), so only new members should have <exception/> created.
-
-2009-03-20 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: Perform the timestamp check for
- the top-level and namespace-level index files.
-
-2009-03-21 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Be nice to make,
- mdoc-export-html, and other apps that use file timetamps: if the
- file contents haven't changed after the update, don't replace the
- "original" file. This preserves file timestamps, thus allowing
- other apps to behave nicely (e.g. mdoc-export-html won't update all
- documentation after running mdoc-update, as the files won't change
- unless something has *actually* changed).
-
-2009-03-20 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocs2html.cs: Do as make(1) does: if the
- target file already exists and is newer than the source file, don't
- regenerate it. (Greatly speeds things up if only a few .xml files
- changed.) Add a --force-update option to disable this behavior.
-
-2009-02-26 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/assembler.cs: When processing an empty directory,
- it's possible for HelpSource.Tree to be null; avoid an NRE.
-
-2009-02-17 Jonathan Pryor <jpryor@novell.com>
-
- * Test/DocTest-v1.cs: Add test for #475814.
- * Mono.Documentation/exceptions.cs, Mono.Documentation/monodocer.cs:
- Use the new Mono.Cecil .Resolve() methods instead of (erroneously)
- duplicating their functionality with the .GetDefinition() methods.
- ExceptionLookup.this[IMemberReference] checks for multi-dimensional
- arrays, as MD arrays are "special" (Cecil can't resolve them, as
- they're internal to the runtime with no specific associated IL).
- Fixes #475814.
-
-2009-02-17 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Check that the cref attribute is
- non-null before trying to use it when importing slashdoc sources.
- Fixes #475852.
- * Test/DocTest-v1.cs: Add an <exception/> doc comment with an invalid
- attribute value for testing.
-
-2009-02-17 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/mdoc.cs: Set Environment.ExitCode=1 if an
- exception occurs, so that calling code can determine that an error
- occurred w/o resorting to parsing stderr. Fixes #475746.
-
-2009-02-16 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Support C#4 variant generics, e.g.
- `delegate TRet Func<in TArg, out TRet>(TArg a)'. Alas, this
- required making MemberFormatter explicitly stateful, so any thoughts
- of using instances w/o locking are now out the window... (Not that
- threads are currently used, but they're planned to be used...)
- TODO: Add a test to Test/DocTest-v1.cs. This wasn't done as the
- current gmcs support doesn't like intermixing variance with generic
- parameter attributes, and I don't want to introduce a new delegate
- type (and the ~6 new files that would imply) just for this feature.
-
-2009-02-10 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Cleanup: turn static data into
- instance data (for future Threading changes, as only static data
- will be tracked for thread-safety); use MDocCommand.Message() and
- MDocCommand.Error() for message reporting; remove warnings.
-
-2009-01-05 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Fix $(PROGRAM) dependencies so that mdoc.exe is rebuilt
- when one of the dependent ../monodoc/Resources/* files is changed.
-
-2009-01-05 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/mdoc.cs: `mdoc' (no arguments) shouldn't print an
- index out of range error. Fix.
- * Mono.Documentation/monodocer.cs: Rename -fno-member-assembly-info to
- -fno-assembly-versions, which prevents generation of //AssemblyVersion
- elements. This suffers the same warning as -fno-member-assembly-info,
- so don't use unless you can guarantee that no members will
- ever be removed from your public API. :-)
- Clean up -f handling so that -f:no-assembly-versions will work as
- expected.
-
-2009-01-05 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Add -fno-member-assembly-info,
- which remove /Type/Members/Member/AssemblyInfo elements.
- Requested by Mike Kestner.
- Warning: this option will break automatic version tracking, so if a
- member is present in e.g. v1.0 and is removed in e.g. v2.0,
- the //Member element will be removed entirely when updating the
- documentation against the 2.0 assembly. Use with care.
-
-2008-12-06 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Remove "exception" from DocsNodeOrder
- so that <exception/> elements aren't grouped together. This causes
- `make doc-update` to result in ~0 changes in ../../class/corlib.
- Change the sorting of --exceptions-generated <exception/> nodes so
- that namespaces are taken into consideration, thus "properly"
- grouping types by namespaces, as I'd usually expect...
-
-2008-12-05 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs, Mono.Documentation/monodocs2html.cs:
- Reorder parameters to be in sorted order, so `mdoc help COMMAND`
- parameters are sorted.
- * Mono.Documentation/monodocer.cs: Remove try/catch in
- MDocUpdater.Run(MDocUpdaterOptions), so that any generated exceptions
- will be handled within mdoc itself (thus allowing the normal
- "See `mdoc help' for more information." message). Improve some
- error messages so they're more useful.
-
-2008-12-04 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Specify --exceptions=all in mdoc-update invocations.
- * exceptions.cs: Add support for documenting a *subset* of all
- possible exceptions. Subsets include: the member itself, the member
- and methods it calls that are in the same assembly, and all possible
- methods across all assemblies.
- * monodocer.cs: Allow --exceptions to take a SOURCES argument, to
- control which location sources will be searched for exceptions.
-
-2008-12-02 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Add --exceptions to `mdoc update` invocations to test
- <exception/> generation.
- * mdoc.exe.sources: Add Mono.Documentation/exceptions.cs to the build.
- * Mono.Documentation/exceptions.cs: Added; searches through the
- callgraph of an IMemberReference, recording which exception types
- are created (and where they're created from).
- * Mono.Documentation/monodocer.cs: Generate <exception/> elements.
- * Test/DocTest-v1.cs: Modify some methods so that exceptions are
- emitted (thus testing <exception/> generation).
- * Test/DocTest-v2.patch: Update (so patch(1) doesn't complain).
- * Test/en.expected.importecmadoc/System/Array.xml,
- Test/en.expected.importecmadoc/System/Environment.xml,
- Test/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- Test/en.expected.importslashdoc/System/Array.xml,
- Test/en.expected.importslashdoc/System/Environment.xml,
- Test/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- Test/en.expected.since/Mono.DocTest/DocAttribute.xml,
- Test/en.expected.since/Mono.DocTest/DocValueType.xml,
- Test/en.expected.since/Mono.DocTest/UseLists.xml,
- Test/en.expected.since/Mono.DocTest/Widget.xml,
- Test/en.expected.since/System/Array.xml,
- Test/en.expected.since/System/Environment.xml,
- Test/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- Test/en.expected/Mono.DocTest/DocAttribute.xml,
- Test/en.expected/Mono.DocTest/DocValueType.xml,
- Test/en.expected/Mono.DocTest/UseLists.xml,
- Test/en.expected/Mono.DocTest/Widget.xml,
- Test/en.expected/System/Array.xml,
- Test/en.expected/System/Environment.xml,
- Test/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- Test/html.expected/Mono.DocTest/DocAttribute.html,
- Test/html.expected/Mono.DocTest/DocValueType.html,
- Test/html.expected/Mono.DocTest/UseLists.html,
- Test/html.expected/Mono.DocTest/Widget.html,
- Test/html.expected/System/Array.html,
- Test/html.expected/System/Environment.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush; adds <exception/>
- elements (and/or HTML-rendered output of <exception/> elements).
-
-2008-11-19 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Add the assembly's directory to
- Cecil's BaseAssemblyResolver search list so that assemblies in the
- same directory as the assembly we're processing can be found.
- Allows mono-tools/gendarme to be built with a Cecil-using mdoc.
-
-2008-11-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Properties on interfaces shouldn't
- have `abstract' on them.
- * Test/DocTest-v1.cs: Add a property to an interface to check above.
- * Test/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
- Test/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
- Test/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
- Test/html.expected/Mono.DocTest/Widget+IMenuItem.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush.
-
-2008-11-15 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Fix regressions found from
- `make doc-update` in corlib:
- - Ensure that custom attributes are sorted (they weren't before,
- resulting in spurious differences between Reflection & Cecil
- output).
- - CecilExtensions.GetMethod() should return null if the method can't
- be found.
- - DocUtils.IsDelegate() should ensure that the delegate type isn't
- abstract (otherwise it dies on System.MulticastDelegate, which is
- an abstract type lacking an "Invoke" method).
- - Properly count generic argument counts for nested types (fixes IOE
- from S.C.G.Dictionary`2.KeyCollection.Enumerator).
- * Test/DocTest-v1.cs: Add doubly-nested class under a generic class to
- simulate S.C.G.Dictionary`2.KeyCollection.Enumerator behavior.
- * Test/en.expected.importslashdoc/index.xml,
- Test/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.xml,
- Test/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+NestedCollection.xml,
- Test/en.expected.since/index.xml,
- Test/en.expected.since/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.xml,
- Test/en.expected.since/Mono.DocTest.Generic/GenericBase`1+NestedCollection.xml,
- Test/en.expected/index.xml,
- Test/en.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.xml,
- Test/en.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection.xml,
- Test/html.expected/index.html,
- Test/html.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.html,
- Test/html.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection.html,
- Test/html.expected/Mono.DocTest.Generic/index.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush (new types/changes
- from DocTest-v1.cs changes).
-
-
-2008-11-14 Jb Evain <jbevain@novell.com>
-
- * Makefile: Use Mono.Cecil from class/lib/net_1_1, not net_2_0.
-
-2008-11-14 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Don't build monodocer1.exe, and add Mono.Cecil.dll to the
- list of assembly references for mdoc.exe.
- * Mono.Documentation/monodocer.cs: Migrate from System.Reflection to
- Mono.Cecil. This was done for two reasons:
- 1. mscorlib.dll: Reflection can load only one mscorlib.dll into an
- AppDomain, which must be the same mscorlib.dll as the runtime
- version. Thus, in order to run monodocer on mscorlib.dll v1.1,
- monodocer must be a .NET 1.1 application, and to document
- mscorlib.dll v2.0, monodocer must be a .net 2.0 app.
- 1.a I don't think it's feasable to drop support for
- mscorlib.dll v1.1.
- 1.b This has been previously handled (so far) with conditional
- compilation, but the conditional compilation is painful to
- maintain, and prevents use of LINQ in ongoing development.
- 1.c .NET 4.0 will be coming out "soon" (within 2 years?), and it's
- possible that mono will maintain the same limitation, thus
- necessitating having *three* different monodocer programs to
- document mscorlib.dll for v1.1, v2.0, and v4.0. Yech.
- 2. Future directions: It would be nice to parse method/property IL
- bodies to determine which exceptions can be generated, thus
- generating <exception cref="..."/> stubs. Even with empty stubs,
- I belive this would be useful within e.g. MonoDevelop to know
- which exceptions a method is able to generate.
- This cannot be done (at present) with System.Reflection, and
- would require Mono.Cecil.
- Downsides: mdoc now depends upon Mono.Cecil, which is API-unstable.
- This will likely also complicate execution under .NET, as Mono.Cecil
- would need to be XCOPY deployed into mdoc.exe's directory.
- * Test/DocTest-v1.cs: Add additional tests for Custom Attribute
- generation.
- * Test/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
- Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- Test/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
- Test/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- Test/en.expected.since/Mono.DocTest/DocAttribute.xml,
- Test/en.expected.since/Mono.DocTest/Widget+Direction.xml,
- Test/en.expected.since/Mono.DocTest/Widget.xml,
- Test/en.expected/Mono.DocTest.Generic/Func`2.xml,
- Test/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- Test/en.expected/Mono.DocTest/DocAttribute.xml,
- Test/en.expected/Mono.DocTest/Widget+Direction.xml,
- Test/en.expected/Mono.DocTest/Widget.xml,
- Test/html.expected/Mono.DocTest.Generic/Func`2.html,
- Test/html.expected/Mono.DocTest.Generic/MyList`2.html,
- Test/html.expected/Mono.DocTest/DocAttribute.html,
- Test/html.expected/Mono.DocTest/Widget+Direction.html,
- Test/html.expected/Mono.DocTest/Widget.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush -- updated output due
- to new custom attributes, better implemented interface detection --
- care of the Mono.Cecil migration -- etc.
-
-2008-11-13 Jonathan Pryor <jpryor@novell.com>
-
- * Test/html.expected/**: Update
- //meta[@http-equiv='Content-Type']/@content attribute value (changed
- due to yesterday's defaulttemplate.xsl fix).
-
-2008-11-12 Jonathan Pryor <jpryor@novell.com>
-
- * Resources/defaulttemplate.xsl: Update /html/head/meta/@content value
- so that IE7 properly recognizes the file as UTF-8 encoded.
- Fixes #444009.
-
-2008-10-27 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Fix build error caused by filenames containing '`'.
-
-2008-10-27 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/mdoc.cs: TraceLevel.Error messages should go to
- Console.Error, as per Unix convention.
- * Makefile: cehck-mdoc-validate* needs to also capture standard error.
-
-2008-10-27 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/validate.cs: Remove warnings
- * Test/validate.check.monodocer, Test/validate.check.monodocer.since:
- Don't generate output if no errors are found.
- * Test/validate.check.monodocer.importslashdoc: Prefix error messages
- with "mdoc:", as per Unix convention.
-
-2008-10-24 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Fixup mdoc.exe dependencies so that it's rebuilt if the
- resources or monodoc.dll change. Add tests for mdoc-validate.
- * Mono.Documentation/assembler.cs, Mono.Documentation/mdoc.cs,
- Mono.Documentation/monodocer.cs, Mono.Documentation/monodocs2html.cs,
- Mono.Documentation/monodocs2slashdoc.cs,
- Mono.Documentation/validate.cs:
- - Major rearchitecture; instead of having the option parsing
- centralized within mdoc.cs, keep option parsing within the relevant
- files/types.
- - Introduce the MDocCommand abstract class to serve as the base class
- -- primarily done to introduce the new Message() and Error()
- methods, in which Message() will only show the message if the
- current message level is >= the message's level (thus minimizing
- console spew); see ../monodoc for more details.
- - Add `-v' ("verbose") top-level argument to allow setting/adding
- levels, so that `mdoc -v -v assemble ...` will show *all*
- assemble-associated messages (which can be quite voluminous).
- - Remove compiler warnings, when able.
- * Mono.Documentation/XhtmlWriter.cs: Remove warning about unused
- variable.
- * Resources/monodoc-ecma.xsd: Extend the XSD to support more
- elements/attributes on various elements -- e.g. mdoc-update looks
- for a //code/@src attribute, which wasn't defined in the XSD. Oops.
- * Test/validate.check.monodocer.importslashdoc: Flush (due to above
- XSD changes).
-
-2008-10-22 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Correct path names.
- * Mono.Documentation/monodocer.cs: Better support nested types.
- * Test/DocTest-v1.cs: Add 4 levels of nested types.
- * Test/en.expected.importslashdoc/index.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass+Double+Triple.xml,
- Test/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass+Double.xml,
- Test/en.expected.since/index.xml,
- Test/en.expected.since/Mono.DocTest/Widget.xml,
- Test/en.expected.since/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.xml,
- Test/en.expected.since/Mono.DocTest/Widget+NestedClass+Double+Triple.xml,
- Test/en.expected.since/Mono.DocTest/Widget+NestedClass+Double.xml,
- Test/en.expected/index.xml,
- Test/en.expected/Mono.DocTest/Widget.xml,
- Test/en.expected/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.xml,
- Test/en.expected/Mono.DocTest/Widget+NestedClass+Double+Triple.xml,
- Test/en.expected/Mono.DocTest/Widget+NestedClass+Double.xml,
- Test/html.expected/index.html,
- Test/html.expected/Mono.DocTest/index.html,
- Test/html.expected/Mono.DocTest/Widget.html,
- Test/html.expected/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.html,
- Test/html.expected/Mono.DocTest/Widget+NestedClass+Double+Triple.html,
- Test/html.expected/Mono.DocTest/Widget+NestedClass+Double.html,
- Test/msxdoc-expected.importslashdoc.xml: Flush.
-
-2008-10-17 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Reference the monodoc.dll from the net_1_1 profile, as
- that's the only one that will get built.
-
-2008-10-17 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile: Fix $(EXTRA_DISTFILES) so that `make distcheck` doesn't
- fail on mdoc anymore...
-
-2008-10-18 Raja R Harinath <harinath@hurrynot.org>
-
- * Makefile (MCS1): Use 'class/lib/net_1_1', not 'class/lib/1.0'.
-
-2008-10-17 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: -overrides & -pretty should default
- to true. (Not a major change, as mdoc.exe already did this, so it
- really only impacts monodocer1.exe, which is internal...)
-
-2008-10-17 Jonathan Pryor <jpryor@novell.com>
-
- * Mono.Documentation/monodocer.cs: Only provide a Main() method and
- use Mono.GetOptions when targeting .NET 1.0 (i.e. monodocer1.exe).
-
-2008-10-16 Jonathan Pryor <jpryor@novell.com>
-
-Migration from monodoc/tools to mcs/tools/mdoc...
-
- * . (svn:ignore), Test (svn:ignore): Ignore generated files.
- * assembler.cs, mdoc.cs, monodocer.cs, monodocs2html.cs,
- monodocs2slashdoc.cs, normalize.cs, validate.cs, XhtmlWriter.cs:
- Move to Mono.Documentation.
- * defaulttemplate.xsl, overview.xsl, stylesheet.xsl: Moved to
- Resources.
- * DocTest: Moved to Test.
- * DocTest-v1.cs, DocTest-v2.patch, TestEcmaDocs.xml: Moved to Test.
- * mdoc.exe.sources: Added; mcs include file to build mdoc.exe.
- * Makefile: Added; build mdoc.exe, monodocer1.exe, and unit tests for
- mdoc.exe
- * Mono.Documentation/assembler.cs, Mono.Documentation/normalize.cs,
- Mono.Documentation/mdoc.cs, Mono.Documentation/monodocs2slashdoc.cs,
- Mono.Documentation/monodocs2html.cs, Mono.Documentation/validate.cs:
- Modify command line handling to remove Mono.GetOptions dependency.
- * Test/DocTest-v1.cs: Update //code/@src attribute due to changed paths.
- * Test/msxdoc-expected.importslashdoc.xml,
- * Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml: Flush
- due to above DocTest-v1.cs change.
-
-2008-10-16 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Fixup sorting of explicitly-implement generic members.
- This keeps members from "bouncing around" in random orders when
- updating documentation...
- * DocTest-v1.cs: Explicitly implement some generic interface members on
- MyList<A,B> to provoke the bug fixed above.
- Dictionary<K,V>.ValueCollection in mscorlib was the original
- example.
- * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/msxdoc-expected.importslashdoc.xml: Flush.
-
-2008-10-15 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Ignore some attributes, because they're ~meaningless
- for documentation purposes (e.g. who cares if we need attributes to
- represent decimal constants, or that a method shouldn't be stepped
- into with the debugger, or...).
- * DocTest/en.expected/index.xml,
- * DocTest/en.expected/Mono.DocTest/Widget.xml,
- * DocTest/en.expected/Mono.DocTest.Generic/Extensions.xml,
- * DocTest/en.expected.since/index.xml,
- * DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- * DocTest/en.expected.since/Mono.DocTest.Generic/Extensions.xml,
- * DocTest/html.expected/Mono.DocTest/Widget.html,
- * DocTest/html.expected/Mono.DocTest.Generic/Extensions.html,
- * DocTest/en.expected.importslashdoc/index.xml,
- * DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- * DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Extensions.xml:
- Flush.
-
-2008-10-05 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: When sorting <Member/> elements elements, take generic
- type parameters into account, so that methods with the same number
- of type parameters are sorted together, instead of strewn across the
- file according to the full //Member/@MemberName comparison.
- * DocTest/**: Flush (and wtf is with the [DebuggerHidden] appearance?).
-
-2008-09-19 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest-v1.cs: Add a member with a "deeply nested" generic parameter
- list, so test the mdoc-html-utils.xsl fix.
- * DocTest/msxdoc-expected.importslashdoc.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush.
-
-2008-09-16 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: FieldInfo.GetValue() may throw, particularly if getting
- the value of a public+static+readonly field, and the constructor for
- the type of said field throws an exception (though DocTest-v1.cs has
- a similar scenario). This is bad, as it prevents monodocer from
- completing its work. Found by Dan Morgan.
- * DocTest-v1.cs: Create a `public static readonly` field that will
- generate an exception from the class constructor.
- * DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/msxdoc-expected.importslashdoc.xml: Flush.
-
-2008-09-16 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Allow #region/#endregion parsing to cope with blank lines.
-
-2008-09-15 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Strip off leading whitespace up to the indent level that
- #region was found. This allows controlling how much leading whitespace is
- preserved within the documentation (as too much whitespace will cause the
- code to be indented significantly when rendered to e.g. html).
- * DocTest-v1.cs: Indent the #region, to test the above.
- * DocTest/msxdoc-expected.importslashdoc.xml,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml:
- Flush.
-
-2008-09-15 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Allow //code/@src to include an anchor, in which the
- anchor specifies a #region to include, instead of including the
- entire document. This is currently limited to C# code. For example,
- `<code lang="C#" src="foo.cs#Text"/>` would look insert all text
- between `#region Text` and `#endregion` within foo.cs.
- * DocTest-v1.cs: Add a #region, <code/> block to test the above.
- * DocTest/msxdoc-expected.importslashdoc.xml,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml:
- Flush.
-
-2008-09-11 Jonathan Pryor <jpryor@novell.com>
-
- * stylesheet.xsl: Post-process $cref so that we can use "nice"
- //see/@cref strings that can actually refer to the right member.
- For example, `<see cref="P:Foo.Bar{T}.Baz"/>` is needed to get a
- nicely rendered "Foo.Bar<T>.Baz" link text, but previously it
- wouldn't link to anything -- you'd need
- `<see cref="P:Foo.Bar`1.Baz"/>` to get a functioning link for HTML
- output. This now works.
-
-2008-09-04 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: You can't use FieldInfo.GetValue() on generic types.
- * DocTestv1.cs: Add checks for static fields on generic types.
- * DocTest/**: Flush.
-
-2008-09-04 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Clear out existing <value/> elements when import XML
- documentation which also contains a <value/> element. (This keeps us from
- getting multiple duplicate <value/> elements every time we update while
- importing.)
-
-2008-08-31 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest-v1.cs: Update XML doc comment to mention correct cref.
- * monodocer.cs: Further fixup XML documentation import and import the actual
- *contents* of the <exception/> element (oops). Add support for importing
- XML documentation for explicitly implemented interface members (CSC-style,
- not gmcs-style).
-
-2008-08-27 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Fixup XML documentation import to be more consistent with
- ECMA XML import. In particular, this fixes <exception/> import so that
- the same element isn't imported multiple times, leading to duplicate
- <exception/> elements the more often monodocer is run.
- * DocTest/msxdoc-expected.importslashdoc.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
- Changes order of imported XML to reflect the original element order.
-
-2008-08-11 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Build fix (gmcs doesn't like using-alias-directives to
- private nested types anymore).
-
-2008-05-06 Wade Berrier <wberrier@novell.com>
-
- * Makefile.am: Add Options.cs to EXTRA_DIST
-
-2008-04-22 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest/en.expected/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
- DocTest/html.expected/Mono.DocTest.Generic/Func`2.html: Flush: n377596
- got fixed, so we can now retrieve custom attributes on all generic type
- parameters.
-
-2008-04-15 Jonathan Pryor <jpryor@novell.com>
-
- * . (svn:ignore): ignore generated files.
- * Makefile.am: Add XmlDocUtils.cs to the build. Add unit tests for
- monodocs2slashdoc; other monodocs2slashdoc changes.
- * mdoc.cs: Update the arguments accepted by monodocs2slashdoc.
- * monodocs2slashdoc.cs: Move DocUtils class into ../engine/XmlDocUtils.cs.
- Add support for a -o parameter which contains all output (if specified).
- * monodocer.cs:
- - Add special support for extension methods -- index.xml now contains an
- /Overview/ExtensionMethods element which contains ExtensionMethod
- elements for all extension methods within all assemblies processed.
- - The <ExtensionMethod/> element contains a subset of the <Member/> of the
- actual extension method (and thus will contain a useful subset of the
- documentation the source <Member/> contains), along with a <Targets/>
- element describing all types the extension method applies to.
- - Consequently, if you edit the documentation of your extension method,
- you need to re-run monodocer to get the newly written documentation
- inserted into index.xml.
- - //Parameter/@RefType is "overloaded" to contain the "this" modifier of
- extension methods (as this was easiest within mdoc-html-utils.xsl).
- - Within CSharpMemberFormatter, insert generic type constraints for
- methods. (Previously constraints were only done on types due to an
- oversight.)
- * monodocs2html.cs: Before rendering documentation via the XSLT, insert any
- extension methods applicable to the type so that the extension methods
- will be displayed.
- * DocTest-v1.cs: Add a class providing extension methods.
- * stylesheet.xsl: Extension methods shouldn't be documented within the type,
- just declared (and linked to the actual type's documentation).
- * DocTest/msxdoc-expected.importslashdoc.xml: Added; expected output for
- monodocs2slashdoc unit test.
- * DocTest/en.expected/index.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected/Mono.DocTest.Generic/Extensions.xml,
- DocTest/en.expected/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/index.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/Extensions.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Extensions.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/html.expected/index.html,
- DocTest/html.expected/NoNamespace.html,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/IProcess.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.html,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/System/Array.html: Flush; also contains additional
- <Attributes/> elements on generic type parameters due to a mono fix.
-
-2008-04-09 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html: Fix the
- System.EventHandler link.
-
-2008-04-08 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest-v1.cs: Add more attributes, generic constraints to further test
- monodocer.
- * Makefile.am: Add check-md-html-dir target to help with testing
- monodocs2html w/o re-generating the DocTest/en.actual directory.
- * monodocer.cs: Lots of changes:
- - Format change: /Type/TypeParameters/TypeParameter doesn't store the type
- parameter name as it's value (e.g. <TypeParameter>A</TypeParameter>),
- but instead stores the name as an attribute (e.g.
- <TypeParameter Name="A" />). This was done as Generic Arguments can
- contain both constraints and attributes which were previously
- unrecorded.
- - Record constraints under a //TypeParameter/Constraints element, and
- attributes under a //TypeParameter/Attributes element.
- - Generic arguments for methods are now recorded in a
- /Type/Members/Member/TypeParameters element, with the same schema as
- type-level arguments.
- - Properly insert the [return:...] attributes on delegates.
- - Modify CSharpFullMemberFormatter to generate generic argument
- constraints on type and member signatures.
- - Note: attributes are currently not inserted due to n#322399.
- * stylesheet.xsl: Properly escape generic type names so that all anchors
- are modeled after ECMA-334 CREFs, e.g. T:Foo.Bar`1, not T:Foo.Bar<T>.
- * DocTest/en.expected/index.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
- DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/System/Action`1.xml,
- DocTest/en.expected/System/Array.xml,
- DocTest/en.expected.since/index.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/System/Action`1.xml,
- DocTest/en.expected.since/System/Array.xml,
- DocTest/en.expected.importecmadoc/System/Action`1.xml,
- DocTest/en.expected.importecmadoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/System/Action`1.xml,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/html.expected/index.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.html,
- DocTest/html.expected/Mono.DocTest.Generic/Func`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/System/Action`1.html,
- DocTest/html.expected/System/Array.html: Flush.
-
-2008-04-04 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest-v1.cs: Add nested generic type for testing.
- * DocTest/en.expected/index.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.since/index.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/html.expected/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html: Flush.
-
-2008-03-31 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest-v1.cs: Add a member returning an IEnumerator<int[]> to test n375291.
- * DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html: Flush.
-
-2008-03-26 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush due to
- ../engine/mdoc-html-utils.xsl changes with migration of explicitly
- implemented interface members to a separate section.
-
-2008-03-26 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html: Flush due to
- ../engine/mdoc-html-utils.xsl changes with s/System.Collections.Generic//.
-
-
-2008-03-26 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile.am: Import docs for System.Action<T>.
- * DocTest-v1.cs: Add System.Action<T> to test generic type importing.
- * monodocer.cs: Misc. fixes:
- - Properly lookup generic types when importing ECMA docs, so that e.g.
- System.Collections.Generic.List<T> docs can be imported.
- - Fix member duplicate checking so that we don't get an exception due to
- seenmembers.Add(sig, "") for duplicate sigs.
- - Fix UpdateParameters() to handle updating <param/> nodes on delegates.
- * TestEcmaDocs.xml: Add docs for System.Action<T>.
- * DocTest/en.expected/index.xml, DocTest/en.expected/System/Action`1.xml,
- DocTest/en.expected.importecmadoc/System/Action`1.xml,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/System/Action`1.xml,
- DocTest/en.expected.since/index.xml,
- DocTest/en.expected.since/System/Action`1.xml,
- DocTest/html.expected/index.html, DocTest/html.expected/System/index.html,
- DocTest/html.expected/System/Action`1.html: Flush.
-
-2008-03-25 Jonathan Pryor <jpryor@novell.com>
-
- * stylesheet.xsl: Implement CreateEditLink() for mdoc-html-utils.xsl.
-
-2008-03-24 Jonathan Pryor <jpryor@novell.com>
-
- * stylesheet.xsl: Implement CreateExpandedToggle() for
- mdoc-sections-css.xsl.
-
-2008-03-24 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush due to
- changes in ID string generation in ../engine/mdoc-html-utils.xsl.
-
-2008-03-17 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Modify index.xml so that there's a //Type/@Kind attribute.
- This allows mkestner's doc engine to display the tree view (e.g. "Foo
- Class") w/o loading the underlying Foo.xml file, improving start time.
- * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
- DocTest/en.expected.importslashdoc/index.xml: Flush.
-
-2008-03-15 Jonathan Pryor <jpryor@novell.com>
-
- * monodocs2html.cs: Fix DumpTemplate() -- sending the output through an
- intermediate XmlDocument seems to "corrupt" the file, such that any user
- of the dumped file will get errors such as "Could not resolve named
- template create-default-style."
-
-2008-03-15 Jonathan Pryor <jpryor@novell.com>
-
- * defaulttemplate.xsl: Cleanup (add/remove CSS properties, etc.).
- * Makefile.am: monodocs2html needs to pull in resources from ../engine.
- * monodocs2html.cs: Use ManifestResourceResolver so that .xsl files embedded
- within the monodocs2html.exe assembly can refer to each other; use
- XhtmlWriter so that certain XHTML elements are "closed", e.g. <br/>
- instead of <br></br>.
- * XhtmlWriter.cs: Added; XmlWriter subclass which generates nicer XHTML.
- * stylesheet.xsl: *Major* refactor to share XSLT code with ../engine.
- * DocTest/html.expected/index.html, DocTest/html.expected/NoNamespace.html,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest/Color.html,
- DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/Widget+Del.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/IProcess.html,
- DocTest/html.expected/Mono.DocTest/index.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html,
- DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/html.expected/System/Environment+SpecialFolder.html,
- DocTest/html.expected/System/Array.html,
- DocTest/html.expected/System/Environment.html,
- DocTest/html.expected/System/index.html,
- DocTest/html.expected/System/AsyncCallback.html: Flush.
-
-2008-03-07 Jonathan Pryor <jpryor@novell.com>
-
- * mdoc.cs: Rename export-slashdoc command to export-msxdoc. Add a space
- between the `usage:' and command description to ease reading.
-
-2008-03-07 Jonathan Pryor <jpryor@novell.com>
-
- * monodocs2slashdoc.cs: Update to cope with .NET 2.0 generics.
- * DocTest-v1.cs: Fix CREF comments.
- * DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html: Flush
- due to above CREF changes.
-
-2008-03-06 Joshua Tauberer <jit@occams.info>
-
- * monodocer.cs: Use Path.Combine in a few places.
-
-2008-03-03 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile.am: Test the new -import: monodocer option.
- * mdoc.cs: Make --import take only one parameter, the file to import.
- * monodocer.cs: Add a new -import option which auto-detects the XML format
- so that mdoc (and the user) doesn't need to care about file formats.
- * Options.cs: Flush (fixes "<>" error when parsing 2-value "i|import").
-
-2008-02-29 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile.am: Use mcs1 to build monodocer1.exe (as mcs now targets the 2.0
- profile by default).
-
-2008-02-29 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile.am: Corrections to pass distcheck.
-
-2008-02-27 Jonathan Pryor <jpryor@novell.com>
-
- * mdoc.cs: `mdoc assemble` should default to the "ecma" format, as that's
- what most of the other mdoc tools produce & consume.
-
-2008-02-26 Jonathan Pryor <jpryor@novell.com>
-
- * mdoc.cs: Allow multiple formats to be specified on the `mdoc assemble`
- command line; directories use the last specified format. This allows more
- than one format to be specified at once, e.g.
- `mdoc assemble -o foo --format=ecma A B --format=error C D`.
- * Options.cs: Update to permit the above "argument run" parsing behavior.
-
-2008-02-24 Jonathan Pryor <jpryor@novell.com>
-
- * mdoc.cs: Remove array index out of bound exception in ExportHtml; remove
- debug messages.
- * defaulttemplate.xsl: s/<tab>/ /; add create-default-collection-title,
- create-default-title, create-default-summary, create-default-signature,
- create-default-remarks, create-default-members named templates (for use by
- importing XSLT files).
- * DocTest/html.expected/**/*.html: Flush (whitespace changes).
-
-2008-02-21 Jonathan Pryor <jpryor@novell.com>
-
- * Makefile.am: Add mdoc.exe to the build.
- * monodocer.cs: Place into the Mono.Documentation namespace;
- rename Stub to Updater.
- * monodocs2slashdoc.cs: Place into the Mono.Documentation namespace; allow
- it to convert multiple directories.
- * mdoc.cs: Added; a unifying front-end to the various monodoc-related
- utilities such as monodocer, monodocs2html, mdassembler, etc.
- * Options.cs: An option parser; DO NOT EDIT; instead, see NDesk.Options at
- http://www.ndesk.org/Options.
-
-2008-02-19 Jonathan Pryor <jpryor@novell.com>
-
- * defaulttemplate.xsl: Insert id attributes so that an "index" can be added;
- Add a small "index" to the top of the page to simplify navigation --
- useful when there are lots of docs that make the "Members" section
- difficult to otherwise find. Add a http-equiv Content-Type, so that the
- charset is set to UTF-8.
- * stylesheet.xsl: Don't use generate-id(), as the result includes the full
- path of the input file, which breaks unit tests if run on a different
- machine (and everyone runs the unit tests, right?). Add id attributes so
- that defaulttemplate.xsl can create an index.
- * DocTest/html.expected/System/Environment+SpecialFolder.html,
- DocTest/html.expected/System/Array.html,
- DocTest/html.expected/System/Environment.html,
- DocTest/html.expected/System/index.html,
- DocTest/html.expected/System/AsyncCallback.html,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/index.html,
- DocTest/html.expected/Mono.DocTest/Color.html,
- DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/Widget+Del.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/IProcess.html,
- DocTest/html.expected/Mono.DocTest/index.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html,
- DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/html.expected/NoNamespace.html: Flush.
-
-2008-02-15 Jonathan Pryor <jpryor@novell.com>
-
- * defaulttemplate.xsl: Move the <style/> and (new) <script/> into named
- templates so that this file can be <xsl:import/>d and the named templates
- invoked without clobbering the importing document; add toggle_display()
- JavaScript function for some bling. Modify CSS so things look nicer.
- * stylesheet.xsl: Make monodocs2html output not suck (as badly):
- - Allow *all* headers to also act as show/hide toggles, so that e.g.
- Remarks, Examples, Parameters, etc. can be hidden.
- - Move the summary information above the member prototype (consistent
- with MSDN, and I think it looks nicer).
- - Provide an `id' attribute for enumeration members, so that
- <see cref="F:..." /> will work reasonably.
- - Allow the <pre/> blocks to use the `prettyprint.js' file (used by
- monologue for syntax coloring) -- requires setting the <pre/> class to
- e.g. code-csharp for C# coloring.
- * DocTest/html.expected/System/Environment+SpecialFolder.html,
- DocTest/html.expected/System/Array.html,
- DocTest/html.expected/System/Environment.html,
- DocTest/html.expected/System/index.html,
- DocTest/html.expected/System/AsyncCallback.html,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/index.html,
- DocTest/html.expected/Mono.DocTest/Color.html,
- DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/Widget+Del.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/IProcess.html,
- DocTest/html.expected/Mono.DocTest/index.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html,
- DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/html.expected/NoNamespace.html: Flush (lots of HTML changes due to
- defaulttemplate.xsl and stylesheet.xsl changes).
-
-2008-02-14 Jonathan Pryor <jpryor@novell.com>
-
- * stylesheet.xsl: Support <typeparamref/>.
-
-2008-02-13 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest-v1.cs: Add/fix doc comments; add a
- Widget(Converter<string,string>) constructor for testing.
- * stylesheet.xsl: Fix display issues:
- - Generic types should have GetTypeDisplayName() on their constituent
- parts, so System.Converter<System.String,System.String>
- gets converted into the nicer Converter<string, string>.
- - Generic types within method argument lists should be supported.
- - Permit constructor references to contain arguments, so that
- "C:My.Full.Type(Type1,Type2)" actually works.
- - Fix remote type references so
- <see cref="M:System.Collections.Generic.List{System.Int32}.Remove(`0)"/>
- properly reference the remote uri
- System.Collections.Generic.List`1.Remove(`0).
- * DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/html.expected/System/Array.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html: Flush.
-
-2008-02-08 Jonathan Pryor <jpryor@novell.com>
-
- * stylesheet.xsl: Allow use of both <see cref="GenericType{A}" /> and
- <see cref="GenericType&lt;A&gt;" /> to be consistent wrt each other.
- - Canonicalize generic types within link targets so that {} is used, as
- 1. this is what the */@id code generates, so such links will actually
- work (as opposed to <>-using links, which will fail), and
- 2. the {} links are shorter and easier to read due to less markup.
- - Canonicalize generic types within link text to use <>, so e.g.
- <see cref="System.Action{`0}" /> is displayed as System.Action<`0>.
- This also allows output to be consistent, no matter what the see/@cref
- text uses.
- - When creating links to go-mono.com, ensure that generic type names are
- of the form Type`N, not Type{...}, as go-mono.com doesn't generate
- useful output for the latter form of URL.
- * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush.
-
-2008-01-06 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Yet another "if you remove a node while traversing its
- containing list, you skip elements" bug (in this case, if you had extra
- <param/> elements for non-existant parameters, only the first extra
- <param/> was removed, and the others were skipped). Modify the messge
- displayed for undeletable <param/> nodes to provide more contextual
- information.
-
-2008-01-05 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs:
- - Fix duplicate and removed member checking/handling, so that duplicate
- and removed members are properly warned about/removed (depending
- on MemberDocsHaveUserContent()).
- - Member sorting should take the return type into consideration, as I've
- seen some ../class/** members which change the return type between
- v1.0 and v2.0, causing the order of these members to "float" (as they
- previously had the same sort order).
-
-2008-01-03 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: XmlNodeList doesn't appear to support removing nodes while
- you're traversing the list. (It doesn't complain, but it doesn't iterate
- over all the nodes either if you do so.) Don't do that.
-
-2008-01-02 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Don't generate files that contain characters that are
- invalid on Win32 platforms. These are frequently compiler-generated
- types, e.g. '<>c__CompilerGenerated2+<>c__CompilerGenerated13', but are
- occasionally public when they shouldn't be. Fix the
- UpdateAssemblyVersions() logic to return true IFF there are > 0
- <AssemblyVersion/> elements.
-
-2008-01-02 Jonathan Pryor <jpryor@novell.com>
-
- * DocTest-v1.cs: Add a type to the root namespace.
- * monodocer.cs: Permit types to exist in the root namespace. This is needed
- to properly document ../class/Npgsql, though I have no idea how `monodoc'
- will actually display these types...
- * overview.xsl: Support types within the root namespace.
- * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/html.expected/System/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/index.html,
- DocTest/html.expected/Mono.DocTest/index.html: Flush.
- * DocTest/en.expected/NoNamespace.xml,
- DocTest/en.expected/ns-.xml,
- DocTest/en.expected.importslashdoc/NoNamespace.xml,
- DocTest/en.expected.importslashdoc/ns-.xml,
- DocTest/en.expected.since/NoNamespace.xml,
- DocTest/en.expected.since/ns-.xml,
- DocTest/html.expected/NoNamespace.html: Added.
-
-2008-01-02 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs:
- - Write namespace files as 'ns-<Namespace>.xml', not '<Namespace>.xml', as
- the previous behavior would break monodoc checkout on Win32 (due to dir
- class/System.Security/en/System.Security.Cryptography.Xml vs. file
- class/System.Security/en/System.Security.Cryptography.xml).
- - This will rename existing <Namespace>.xml to ns-<Namespace>.xml
- automatically.
- - gmcs/mcs changed Reflection names (again); cope.
- * DocTest/en.expected/System.xml,
- DocTest/en.expected/Mono.DocTest.Generic.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest.xml, DocTest/en.expected.since/System.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.xml,
- DocTest/en.expected.importslashdoc/System.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.xml: Rename to have a
- 'ns-' prefix.
- * Makefile.am: Remove obsolete targets; add -show_exceptions to tests so we
- get more information on errors.
- * overview.xsl: Use the 'ns-' prefixed namespace documentation files.
-
-2007-12-19 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: PropertyInfo.GetValue() may throw (in particular, within
- System.Data when trying to read ToolboxItemAttribute which references an
- assembly not present within the GAC). Workaround this.
-
-2007-12-19 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Add a -show_exceptions argument to provide full stack traces
- when an error occurs (helps with debugging). Allow VersionComparer to
- work on "slightly" malformed Version strings like 1.0.x.x, which some
- existing documentation uses.
-
-2007-12-18 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Don't append ';' to property declarations.
- * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
-
-2007-12-18 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Insert [return:] custom attributes within <ReturnValue/>.
- * DocTest-v1.cs: Add custom attributes to various members for testing.
- * DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html: Flush.
-
-2007-12-17 Jonathan Pryor <jpryor@novell.com>
-
- * monodocer.cs: Document protected events.
- * DocTest-v1.cs: Change the visibility of various members so we can better
- test the monodocs2html output.
- * stylesheet.xsl: Fix the `protected' check so that public members aren't
- displayed under the Protected [MemberType] section.
- * DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
-
-2007-12-13 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Er, *really* sort the <AssemblyVersion/> entries.
-
-2007-12-12 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Sort the <AssemblyVersion/> entries so that when rendering
- them within monodoc we show versions in increasing order.
-
-2007-12-11 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Don't use File.OpenWrite(), as that doesn't truncate the
- file (resulting in invalid XML errors if the new file is smaller than the
- previous file). Add a local OpenWrite() to ensure that UTF8 is used
- everywhere.
-
-2007-12-11 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Generate a per-member <AssemblyInfo/> element, not an
- <AssemblyVersions/> element. This makes it easeier to write the XSLT
- used in the docbrowser to generate the Requirements section.
- * stylesheet.xsl: Use <AssemblyInfo/>, not <AssemblyVersions/>.
- * DocTest/en.expected/System/Environment.xml,
- DocTest/en.expected/System/AsyncCallback.xml,
- DocTest/en.expected/System/Environment+SpecialFolder.xml,
- DocTest/en.expected/System/Array.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected/Mono.DocTest/IProcess.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected/Mono.DocTest/Color.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected.since/System/Environment.xml,
- DocTest/en.expected.since/System/AsyncCallback.xml,
- DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.since/System/Array.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.since/Mono.DocTest/Color.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected.importecmadoc/System/Environment.xml,
- DocTest/en.expected.importecmadoc/System/AsyncCallback.xml,
- DocTest/en.expected.importecmadoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/System/Environment.xml,
- DocTest/en.expected.importslashdoc/System/AsyncCallback.xml,
- DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.importslashdoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
- Flush; s/AssemblyVersion/AssemblyInfo/g.
-
-2007-12-10 Jonathan Pryor <jonpryor@vt.edu>
-
- * DocTest-v2.patch: Remove some members so that we can see some
- <AssemblyVersions/> differences in the XML output.
- * monodocer.cs: Add a <AssemblyVersions/> element under every type and member
- to better track versioning information. The XML documentation now becomes
- a "version database" of sorts, in which each member lists which assembly
- versions it exists in. This permits tracking which members were added or
- removed over time with greater fidelity than <since/>. This also removes
- the need for -ignore_extra_docs, which is maintained (for compatibility)
- but ignored.
- * DocTest-v1.cs: Have differing visibility on a property to ensure it works
- properly.
- * stylesheet.xsl: Print out the per-member <AssemblyVersions/> element.
- * DocTest/en.expected/System/Environment.xml,
- DocTest/en.expected/System/AsyncCallback.xml,
- DocTest/en.expected/System/Environment+SpecialFolder.xml,
- DocTest/en.expected/System/Array.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected/Mono.DocTest/IProcess.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected/Mono.DocTest/Color.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected.since/System/Environment.xml,
- DocTest/en.expected.since/System/AsyncCallback.xml,
- DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.since/System/Array.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.since/Mono.DocTest/Color.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
- DocTest/html.expected/System/Array.html,
- DocTest/html.expected/System/Environment.html,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/en.expected.importecmadoc/System/Environment.xml,
- DocTest/en.expected.importecmadoc/System/AsyncCallback.xml,
- DocTest/en.expected.importecmadoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/System/Environment.xml,
- DocTest/en.expected.importslashdoc/System/AsyncCallback.xml,
- DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.importslashdoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
- Flush, inserting <AssemblyVersion/> elements as necessary.
-
-2007-10-28 Jonathan Pryor <jonpryor@vt.edu>
-
- * DocTest-v1.cs: Correct doc comment.
- * DocTest/html.expected/System/Environment.html,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/en.expected.importslashdoc/System/Environment.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml: mcs and gmcs
- got many bug fixes with /doc support, changing many things that depend on
- /doc output.
-
-2007-09-27 Raja R Harinath <rharinath@novell.com>
-
- * Makefile.am (DocTest.dll-v1, DocTest.dll-v2): Pick source from $srcdir.
-
-2007-07-19 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Always fully consume <Docs/> children. If we have e.g.
- <Docs><param name="foo"><see cref="T:Bar"/></param></Docs>, but there is
- no existing parameter "foo", we would previously process the nested
- <see/> node and append it to the <Docs/> child nodes.
-
-2007-07-18 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Change OrderDocsNodes() so that it uses
- XmlNode.InsertAfter() instead of XmlNode.InsertBefore(). The result is
- mostly the same (i.e. no regression test changes), but if you have a
- non-ordered node between other nodes this will force the non-ordered node
- to the *end* of the <Docs/> children, not the start. For example, given
- the input <Docs><summary/><exception/><remarks/></Docs/>, we used to get
- <Docs><exception/><summary/><remarks/></Docs>, while we now get
- <Docs><summary/><remarks/><exception/></Docs>.
-
-2007-07-17 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Insert the type's <Docs/> node before <Members/>. This is
- consistent with ECMA documentation ordering, and makes more sense (when
- editing the file you can edit the Type documentation before member
- documentation, instead of after all members as was the case before).
- * DocTest/en.expected/System/Environment.xml,
- DocTest/en.expected/System/Environment+SpecialFolder.xml,
- DocTest/en.expected/System/Array.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected/Mono.DocTest/IProcess.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected/Mono.DocTest/Color.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected.since/System/Environment.xml,
- DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.since/System/Array.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
- DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.since/Mono.DocTest/Color.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected.importecmadoc/System/Environment.xml,
- DocTest/en.expected.importecmadoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/System/Environment.xml,
- DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.importslashdoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
- Update so that <Docs/> comes before <Members/>, not after.
-
-2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: If a <Type/> had an empty <Members/> element, we'd start
- reading the <Member/> elements from the *next* <Type/>; oops.
- * DocTest-v1.cs: Add System.AsyncCallback, which is a delegate and thus had
- an empty <Members/> element.
- * Makefile.am: Also import docs for System.AsyncCallback.
- * overview.xsl: Update $max-types so that adding System.AsyncCallback
- doesn't trigger the alternate behavior, creating a larger diff than
- necessary.
- * TestEcmaDocs.xml: Add docs for System.AsyncCallback.
- * DocTest/en.expected/System/AsyncCallback.xml,
- DocTest/en.expected/index.xml,
- DocTest/en.expected.since/System/AsyncCallback.xml
- DocTest/en.expected.since/index.xml,
- DocTest/html.expected/System/AsyncCallback.html
- DocTest/html.expected/System/index.html, DocTest/html.expected/index.html,
- DocTest/en.expected.importecmadoc/System/AsyncCallback.xml,
- DocTest/en.expected.importslashdoc/System/AsyncCallback.xml,
- DocTest/en.expected.importslashdoc/index.xml: Added; expected imported
- documentation for System.AsyncCallback.
-
-2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Remove the "While Importing ECMA <Docs/> chidren, found
- node..." error by ensuring that we're at the start of an actual
- non-whitespace element before hitting the switch statement.
-
-2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Don't call DoUpdateType() with non-public types. This
- allows `monodocer -importecmadoc` to fully run and import mscorlib.dll.
-
-2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Ensure that getting a MemberInfo based on the documentation
- that the MemberInfo was actually found... (Allows a full mscorlib.dll
- import to run for > 15s before dying.)
-
-2007-07-04 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Use XmlReader instead of XPathDocument to process the ECMA
- documentation import. This cuts down a -type:System.Array import from
- ~10-12s to ~7-8s (not great, but better). "Fix" the ordering of <Docs/>
- child elements so that importing ECMA/slashdoc documentation doesn't
- change the normal ordering.
- * DocTest/en.expected.importecmadoc/System/Array.xml,
- DocTest/en.expected.importecmadoc/System/Environment.xml: Alter order of
- <Docs/> elements to match the normally generated order.
-
-2007-06-20 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Sort /Type/Members/Member elements so that the order is not
- dependent upon Reflection order.
- * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/en.expected.importecmadoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml:
- Flush (sort <Member/> elements).
-
-2007-06-19 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Sort <Namespace/> and <Type/> elements by their Name
- attribute. This helps keep diff's smaller, as the generated order won't
- be dependent upon Reflection order.
- * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
- DocTest/en.expected.importslashdoc/index.xml: Flush (sort namespaces and
- types alphabetically).
-
-2007-06-19 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Cleanup Console output.
- - Use Console.Error for error messages, not status messages.
- - Error should be prefixed by "monodocer" (follows Unix conventions).
- - Don't print "Updating..." followed by "New Type..." for the same type.
- - Use __monodocer-seen__ sentinal for imported nodes so that we don't try
- to lookup the corresponding member later in GetDocumentationMembers().
-
-2007-06-19 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Lots 'o fixes/improvements.
- - Allow multiple -type parameters to be specified.
- - Remove type member enumeration from UpdateTypes() -- use DoUpdateType2().
- - Iterate over assembly types in Ecma Documentation order (so that we read
- the Ecma docs sequentially, not randomly).
- - Allow -type to *create* new documentation files.
- - Remove unused methods.
- * Makefile.am: Add check-monodocer-importecmadoc,
- check-monodocer-importecmadoc-update targets (unit tests for
- -importecmadoc).
- * TestEcmaDocs.xml: Added; ECMA Documentation input file for use with
- -importecmadoc tests.
- * DocTest-v1.cs: Add System.Array to help test -importecmadoc behavior.
- * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
- DocTest/html.expected/System/index.html, DocTest/html.expected/index.html,
- DocTest/en.expected.importslashdoc/index.xml: Flush (add System.Array to
- index files).
- * DocTest/en.expected/System/Array.xml,
- DocTest/en.expected.since/System/Array.xml,
- DocTest/html.expected/System/Array.html,
- DocTest/en.expected.importecmadoc/System/Environment.xml,
- DocTest/en.expected.importecmadoc/System/Array.xml,
- DocTest/en.expected.importslashdoc/System/Array.xml: Added; expected
- output for System.Array type for various tests.
-
-2007-06-18 Wade Berrier <wberrier@novell.com>
-
- * monodocer.cs: Move assembly information up top because having it at the bottom
- fails to compile with mcs from trunk.
-
-2007-06-14 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Use XPathDocument instead of XmlDocument to process the ECMA
- documentation import. This cuts down a -type:System.Array import from
- ~15-20s to ~10-12s (not great, bug better). Fix importing of <exception/>
- elements -- previously we would skip them if the mono docs lacked them.
-
-2007-06-12 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: The previous fix was buggy -- if the type parameters were
- renamed (ConvertAll<T,U> in ECMA, ConvertAll<TInput,TOutput> in Mono),
- then the existing element wouldn't be found, but the MemberInfo would.
- Result: duplicate XML elements (BOTH ConvertAll<T,U> AND
- ConvertAll<TInput,TOutput>), one of which is wrong, which clearly isn't
- desirable. If the Mono XML element can't be found, try looking it up
- based on the MemberInfo found from the ECMA docs to avoid duplication.
-
-2007-06-11 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Add support for renaming of template parameters (useful
- because ECMA 335 refers to Array.ConvertAll<T,U> while Mono/.NET have
- Array.ConvertAll<TInput,TOutput>). Not terribly intelligent, but smart
- enough that all but two System.Array members can now be imported (a
- private constructor, and a member with an incorrectly documented parameter
- type, neither of which I plan on supporting). Cleanup some of the
- `#if NET_1_0` blocks by using `using' aliases -- alas, requires moving the
- [assembly:...] attributes; see bugzilla #81855.
-
-2007-06-11 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Add support for explicity-implemented interface members.
- Minor cleanup. Replace catch(NotSupportedException){} blocks.
- * Makefile.am (clean): Cleanup monodocer.exe* files.
- * DocTest-v1.cs: Add IFoo<T>, explicitly implement some interfaces on
- MyList<A,B> to test explicitly-implemented member support.
- * DocTest/en.expected/index.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/index.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/index.html,
- DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml:
- Update.
- * DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
- DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html: Added.
-
-2007-05-29 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Invert ECMA documentation importing -- instead of iterating
- over the monodoc XML and importing ECMA docs as encountered (randomly),
- iterate over the ECMA docs in-order and access the monodoc types randomly.
- This significantly improves access as the ECMA docs are ~7.2MB in size,
- while the monodoc XML types 10's-100's of KB (randomly accessing a 7.2 MB
- XML document == BAD; randomly accessing a several hundred KB document is
- better). This cuts down a -type:System.Array import from ~4 minutes to
- < ~20s. Alas, it appears to miss a few members as well, so it's not done.
-
-2007-05-19 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Create diff(1)-friendly output for -importecmadocs.
- Previously, we'd remove <summary/>, <remarks/>, etc., and re-add them at
- the end of the <Docs/> node, which results in major changes for diff(1),
- so instead we replace the contents of existing elements when appropriate.
- Remove '\r' from the imported document (also to remove diff(1)-reported
- changes as the line endings would change).
-
-2007-05-17 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Add -importecmadoc flag, which will import
- documentation found within an ECMA documetation file (e.g. the
- CLILibraryTypes.xml from the ECMA-335 standard).
- WARNING: import is currently SLOW.
-
-2007-05-17 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Refactor MakeDocNode() so that there's only one
- version, not three overloads, and use a (new) DocsNodeInfo type to
- pass information to the new MakeDocNode() method. This doesn't
- change anything per-se, but it'll make it easier to pass new
- parameters to MakeDocNode() without making the rediculously long
- parameter list even longer...
-
-2007-05-12 Joshua Tauberer <jit@occams.info>
-
- * overview.xsl: Always sort type names, since when updating
- docs monodocer can make the list in index.xml out of order.
- * monodocer.cs: When deleting duplicate member entries, delay
- deletion until after loop is finished.
- * Makefile.am, DocTest-v1.cs, DocTest/en.expected.importslashdoc,
- DocTest/html.expected: Revise monodocs2html tests to use
- the /doc file so we can test those tags too. And changed two
- <c> tags to <see cref=/>.
- * stylesheet.xsl, DocTest/html.expected: Fix see-links to methods,
- which didn't recognize '(' as delimiting type from args, and
- display nice type names for arguments.
-
-2007-03-15 Lluis Sanchez Gual <lluis@novell.com>
-
- * monodocer.cs: When deleting a member, don't remove it from the
- parent xml element until all members are checked, since doing
- it breaks the loop.
- Properly import internal protected members.
-
-2006-12-29 Jonathan Pryor <jonpryor@vt.edu>
-
- * Makefile.am: Add check-monodocer-ignore_extra_docs-update,
- check-doc-tools-update, and check-update targets.
- * monodocer.cs: Fix generation of attribute parameters, as e.g.
- `AttributeUsage.Class|Struct' doesn't look right; it should
- instead be `AttributeUsage.Class | AttributeUsage.Struct'.
- * DocTest-v1.cs: Add new public Attribute with an AttributeUsage for tests.
- * DocTest/en.expected/index.xml,
- DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
- DocTest/en.expected.since/index.xml,
- DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
- DocTest/html.expected/index.html,
- DocTest/html.expected/Mono.DocTest/index.html,
- DocTest/html.expected/Mono.DocTest/DocAttribute.html: Added; update
- expected output for new tests.
-
-2006-12-29 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Fix C# type name generation for nested types in the System
- namespace. Remove TypeCastException when dealing with custom attributes.
- * DocTest-v1.cs: Add System.Environment type for testing System handling.
- * DocTest/en.expected/index.xml, DocTest/en.expected/System.xml,
- DocTest/en.expected/System/Environment.xml,
- DocTest/en.expected/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.since/index.xml, DocTest/en.expected.since/System.xml,
- DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
- DocTest/en.expected.since/System/Environment.xml,
- DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/System.xml,
- DocTest/en.expected.importslashdoc/System/Environment.xml,
- DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
- DocTest/html.expected/index.html, DocTest/html.expected/System/index.html,
- DocTest/html.expected/System/Environment.html,
- DocTest/html.expected/System/Environment+SpecialFolder.html:
- Added; update expected output for new tests.
-
-2006-12-29 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: `abstract sealed' classes are actually `static' classes.
-
-2006-12-27 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Re-order the attributes in <Type/> elements so that the
- ordering is (somewhat) well defined. This helps with `diff' output in
- ../class, as it prevents "false positives" when the attributes are
- re-ordered. Fix CSharpFullMemberFormatter.GetTypeDeclaration() so that
- when handling C# builtin types (e.g. System.Byte) it uses the real name in
- the declaration instead of the C# keyword (`class byte' is wrong).
-
-2006-12-26 Jonathan Pryor <jonpryor@vt.edu>
-
- * Makefile.am: Add check-monodocer-ignore_extra_docs test.
- * monodocer.cs: Fix -ignore_extra_docs. Previously, it would just ignore
- "missing" types, but it would still remove "missing" members.
-
-2006-12-26 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Don't insert internal attributes into the documentation.
- * DocTest-v1.cs: Add test for use of an internal attribute.
-
-2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Don't include full namespace for System.* types. *Do*
- include the full namespace for nested System types, e.g.
- System.Collections.IEnumerable. This is what is currently in
- ../class/corlib/en, and making this change results in a smaller diff.
- * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml:
- Update unit tests for above monodocer.cs change.
-
-2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Don't include full namespace for System.* types. This is
- what ECMA-335 CLILibraryTypes.xml does for C# declarations -- no
- namespaces within e.g. inheritance lists or parameter lists for the System
- namespace and namespaces nested within System.
- Remove unnecessary console output.
- * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml:
- Update unit tests for above monodocer.cs change.
-
-2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Make sure that the types we document are *really* public.
- For some reason public nested types of internal types are returned by
- Assembly.GetTypes(), e.g. ``internal class A { public class B {} }''
- These types shouldn't be documented.
- * DocTest-v1.cs: Add test case for above.
-
-2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Add -ignore_extra_docs flag; when set, it will not rename
- .xml files for types not found to .xml.remove. This is useful in ../class
- when we're processing assemblies multiple times for the 1.0 & 2.0
- profiles, as when processing the 1.0 profile we'll be "missing" the 2.0
- types, and we don't want those to be renamed.
-
-2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
-
- * Makefile.am: Add a monodocer1.exe target, which is a version of monodocer
- which runs under the 1.0 runtime. This is necessary so that we can still
- generate/update docs for mscorlib.dll 1.0 (as only one mscorlib.dll can
- ever be loaded into a process).
- * monodocer.cs: Split out the .NET 2.0 functionality so that it can be built
- for both 1.0 and 2.0 runtimes. 1.0 support is controlled by the
- NET_1_0 define.
-
-2006-12-20 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Don't try too hard in UpdateParameters(). Previously, if a
- the number of parameters a method accepted changed from > 1 to 1, the
- "easy" <param/> handling would (inadvertently?) change all <param/>s to have
- the @name of the method's single parameter -- so if you _had_ parameters
- A, B, and C but the method now only has D, then A, B, and C would all have
- their @name attribute changed to D. Odd, but possibly acceptable...
- ...until we try to make sure that the <param/>s are in the right order, in
- which case we'll record the index of D as 0 (it's the 1st parameter), but
- find a parameter with a different index (the old B & C), causing us to
- reinsert the parameter to make sure it's in the proper order. This
- results in an infinite loop within System.Xml -- see Bugzilla #80331.
- It's safer to just ignore the extra parameters.
-
-2006-12-07 Jonathan Pryor <jonpryor@vt.edu>
-
- * DocTest-v1.patch: Add an operator returning a generic parameter (triggers
- error fixed in monodocer.cs).
- * DocTest-v2.patch: Update (due to changes in DocTest-v1.cs).
- * monodocer.cs: CSharpFullMemberFormatter.AppendVisibility() needs to accept null
- MethodBases (when called from GetEventDeclaration() and e.GetAddMethod()
- returns null); fix SlashDocMemberFormatter.GetMethodDeclaration() so that
- generic types can be the return value of methods. These changes allow
- generation of documentation on Mono's 2.0 mscorlib.dll.
- * stylesheet.xsl: Use GetParameterType() to emit the return type of
- explicit/implicit operators, as they can be/use generic arguments.
- * DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html:
- Flush to match current output.
-
-2006-11-22 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Don't generate documentation/prototypes for non-public
- property get/set accessors. Patch from Ivan N. Zlatev.
-
-2006-11-01 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: When importing -importslashdoc documentation, convert
- <seealso/> elements into <altmember/> elements (as the former is the
- recommended element within ECMA-334, while the latter is the actual
- element used for our ECMA documentation).
- * DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
-
-2006-10-27 Jonathan Pryor <jonpryor@vt.edu>
-
- * stylesheet.xsl: Generate more correct string id's for "id" attribute
- values, so that string ids match the output of CSC.EXE 2.0. Changes:
- append ``N instead of `N for generic methods, and use the correct 0-based
- type parameter index, not a 1-based index.
- * DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html: Flush.
-
-2006-10-24 Jonathan Pryor <jonpryor@vt.edu>
-
- * DocTest-v1.cs: Add /doc comments (for use with `make
- check-monodocer-importslashdoc`).
- * DocTest-v2.patch: Update (due to changes in DocTest-v1.cs).
- * Makefile.am: Add check-monodocer-importslashdoc,
- check-monodocer-importslashdoc-update targets.
- * monodocer.cs: Fix -importslashdoc. Massively refactor generation of
- strings from MemberInfos (Type, MethodInfo, etc.) so that commonalities
- between DocType, C#, and /doc string IDs can be shared and easily
- customized (as opposed to dealing with the > 100 line FillDocTypeName()
- method, which was already too complex).
- * DocTest/en.expected.importslashdoc/index.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
- DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
- Added; expected output for `make check-monodocer-importslashdoc'.
-
-2006-10-19 Jonathan Pryor <jonpryor@vt.edu>
-
- * Makefile.am: Change check-monodocer target to add a `monodocer -namespace'
- check, as `-namespace' would use a bad filename generation algorithm.
- * monodocer.cs: Don't use Type.Name (or equivalent) to generate filenames,
- but use GetTypeFileName(), so that Foo<T> only tries to open the file
- Foo`1, instead of the file Foo<T> which (1) is wrong, we never generate
- filenames like that, and (2) fails horribly on Win32 (as '<' and '>' are
- invalid path characters).
-
-2006-10-19 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Sort member ordering so that when the order of members
- returned by Type.GetMembers() changes (as it did between 1.1.17 and
- 1.1.18) the order of the documentation members won't change (leading to
- "errors" in the regression tests).
- * DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected/Mono.DocTest/Color.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest/Color.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest/Color.html,
- DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html: Flush. Since monodocer
- generates a different member ordering, *everything* gets a different
- ordering. <sigh>
-
-2006-10-12 Jonathan Pryor <jonpryor@vt.edu>
-
- * monodocer.cs: Add support for inserting Docs/since element. This element
- is *only* inserted for NEW type/members, never updated, and is only
- inserted if the -since:SINCE command-line argument is provided.
- * DocTest.cs: Renamed to DocTest-v1.cs.
- * Makefile.am: Add DocTest.dll-v1, DocTest.dll-v2, check-monodocer-since,
- check-monodocer-since-update, check targets.
- * DocTest-v2.patch: Patch file applied to DocTest-v1.cs to get DocTest.dll
- version 2.0.0.0.
- * DocTest/en.expected.since/index.xml,
- DocTest/en.expected.since/Mono.DocTest.xml,
- DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
- DocTest/en.expected.since/Mono.DocTest/Color.xml,
- DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
- DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml: Added;
- expected output for DocTest.dll v2.0.0.0.
-
-2006-10-11 Jonathan Pryor <jonpryor@vt.edu>
-
- * stylesheet.xsl: Add /Members/Docs node in GetInheritedMembers() so that
- GetLinkId() sees typeparam elements for type replacement in parameters for
- members of base types. Make sure that "simple" type arguments are
- replaced, e.g. T --> `1.
- TODO: figure out type replacements for nested types.
- * DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Change link id's
- and targets for proper type replacements within parameters.
-
-2006-10-10 Joshua Tauberer <jit@occams.info>
-
- * monodocer.cs: Fixed a bug in WriteElement that would put
- nodes in the wrong place if some node in the path already
- existed.
- - To prevent TypeParameters from always being put at the
- end on an update, don't delete that node in an update, just
- clear it.
- - Update the DisplayName attribute in index.xml on doc updates.
- * DocTest/*: Updated for the DisplayName fix, and also put
- into a pristine state (I had committed them as an update,
- which put the TypeParameters block at the end of the files.)
-
-2006-10-09 Joshua Tauberer <jit@occams.info>
-
- * monodocer.cs: Update a type's name attributes during an update
- because generic argument names may change even if filename
- hasn't.
- - Added a Type/TypeParameters section which includes type
- parameters that come from the declaring type, for nested types.
- - When inheriting from a generic type, added a BaseTypeArguments
- section which maps type parameters on the base type's type
- definition to types instantiating those parameters. i.e.:
- class X<T> { }
- class Y<U> : X<U> { }
- Y gets a mapping in its BaseType node from T to U.
- * stylesheet.xsl: Don't attempt to link to a generic type
- parameter, just display it in italics. And when displaying
- inherited members, try to replace generic type parameters
- in the base type with the types that have instantiated them
- in this type.
- * The DocTests are updated to show off these things.
-
-2006-10-08 Joshua Tauberer <jit@occams.info>
-
- * monodocer.cs: Track which members have been seen in the XML file
- not by putting MemberInfos into a hashtable, which seems to
- not always work right, but instead by their (string) signature.
- - Get custom attribute data with the new 2.0 CustomAttributeData
- classes, so that we can reconstruct what the constructor actually
- looked like.
- - Hide System.Runtime.InteropServices.Out attributes since it is
- fake and already in the RefType XML attribute.
- - Structs weren't getting their interfaces listed in their C# type
- signatures.
- * monodocs2html.cs: Don't override the default XSLT URI resolver anymore.
- * stylesheet.xsl: Get the index.xml document at the start while we're
- sure we have the right base path (the XML document being transformed).
- - Display inherited members in a type's member list when the base type
- is documented in the same monodocer document set.
- - Make sure there's a space between a method's parameters and return
- value type in the member list.
- * DocTest: Updated to test these things.
-
-2006-10-06 Jonathan Pryor <jonpryor@vt.edu>
-
- * overview.xsl: When generating a Namespace/index.html file, we should
- insert the namespace remarks as well. (This *should* have been done, but
- the remarks selection was relative to '.', not to the provided $ns. :-(
- * DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest/index.html: Flush.
-
-2006-10-06 Jonathan Pryor <jonpryor@vt.edu>
-
- * Makefile.am: Fix -update targets so they don't delete .svn/*.
- * monodocer.cs: Don't key off of DisplayName to insert new <Type> elements,
- as this will result in updating all existing documentation (rather silly).
- Key off of Name instead, and only create a DisplayName attribute if it
- differs from Name.
- * DocTest/en.expected/index.xml: Update to latest monodocer output.
- * monodocs2html.cs: If DisplayName doesn't exist, fall back to
- Name ("legacy" behavior, now made current due to change in monodocer.cs).
- * stylesheet.xsl: For "Name [Generic ] [MemberType]" descriptions, make the
- 2nd space part of "Generic". Otherwise we get double spaces for
- non-generic members, e.g. "Name [MemberType]".
- * overview.xsl: Fallback to @Name if @DisplayName doesn't exist.
- * DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html: Update to latest
- monodocs2html output.
-
-2006-10-06 Jonathan Pryor <jonpryor@vt.edu>
-
- * Makefile.am: Build with gmcs; add `-debug' to compile lines; add
- DocTest.dll, check-monodocer, check-monodocer-update, check-monodocs2html/
- check-monodocs2html-update targets for unit tests.
- * monodocer.cs: Major overhaul for Generics support. Documentation
- generated follows the pattern used in CLILibraryTypes.xml from ECMA-335.
- - Remove some warnings about unused variables.
- - Don't assume that Type.FullName is always what we want, but instead
- build a C# typename from the Type information. This is needed to nicely
- deal with generics, as the FullName for Foo<int> would be
- Foo[[System.Int32, mscorlib]], while we really want Foo<int>.
- - For index.xml files, insert a File attribute, as the Type name won't
- match the filename for generic types (Foo<T> is the file Foo`1.xml).
- - For GetMember(), remove generic parameters before using Type.GetMember()
- with the member name.
- - Code refactoring so that <param/> and <typeparam/> generation & updating
- is consistent.
- - Properly use `this' for method name on indexers.
- * monodocs2html.cs: Add Generics support -- use the @File attribute instead
- of assuming that @Name contains the proper filename.
- * defaulttemplate.xsl: Use <h1> instead of <div>; add CSS for
- `.InnerSignatureTable tr' and `.TypePermissionTable tr'.
- * overview.xsl: If there are fewer than $max-types (20) types in the
- assembly, show them all in the top-level index.html, no matter how many
- namespaces are present. Otherwise, provide links to the
- Namespace/index.html files, so that things don't suddenly look different
- as soon as you go from 1 namespace to > 1 namespaces in an assembly.
- Use <h2/> instead of <div/>.
- * stylesheet.xsl: Major overhaul for Generics support, some re-indentation.
- - Use <h2/>...<h4/> instead of <div/>
- - Allow output to validate against XHTML.
- - Don't use generate-id(), but instead generate member ID's manually so
- that we can properly refer to them from outside the current page.
- - Add support for <see cref=""/> translation to non-types --
- constructors, methods, properties, fields, events. These can refer to
- members from a different file, since generate-id() is no longer used.
- - Update the mono-docs site so links to System.* types work.
- - Add support for additional Mono.* namespaces on the mono-docs site.
- - Properly display C# indexers ("type this [params]", not
- "type Item [params]").
- - Generate documentation for <typeparam/> elements.
- * DocTest.cs: Added; Source for DocTest.dll, used by unit tests.
- * DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
- DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
- DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
- DocTest/html.expected/Mono.DocTest/DocValueType.html,
- DocTest/html.expected/Mono.DocTest/IProcess.html,
- DocTest/html.expected/Mono.DocTest/index.html,
- DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
- DocTest/html.expected/Mono.DocTest/Color.html,
- DocTest/html.expected/Mono.DocTest/Widget+Del.html,
- DocTest/html.expected/Mono.DocTest/UseLists.html,
- DocTest/html.expected/Mono.DocTest/Widget.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/index.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
- DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
- DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
- DocTest/html.expected/index.html,
- DocTest/en.expected/Mono.DocTest.Generic.xml,
- DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
- DocTest/en.expected/Mono.DocTest/IProcess.xml,
- DocTest/en.expected/Mono.DocTest/Widget.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
- DocTest/en.expected/Mono.DocTest/DocValueType.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
- DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
- DocTest/en.expected/Mono.DocTest/Widget+Del.xml,
- DocTest/en.expected/Mono.DocTest/UseLists.xml,
- DocTest/en.expected/Mono.DocTest/Color.xml,
- DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
- DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
- DocTest/en.expected/index.xml, DocTest/en.expected/Mono.DocTest.xml:
- Added. Expected output for monodocer (en.expected) and
- monodocs2html (html.expected).
-
-2006-04-01 Joshua Tauberer <tauberer@for.net>
-
- * monodocs2html.cs: Skip files that are missing.
-
-2006-03-09 Joshua Tauberer <tauberer@for.net>
-
- * monodocer.cs: Reverted all of the Cecil changes. Ah well.
-
-2006-03-04 Joshua Tauberer <tauberer@for.net>
-
- * monodocer.cs: Using Cecil now! (Some Cecil fixes
- need to be committed.)
-
-2006-03-03 Joshua Tauberer <tauberer@for.net>
-
- * monodocer.cs: Don't change up whitespace unless user says so.
- That makes it hard to see differences against svn.
-
-2006-01-12 Jonathan Pryor <jonpryor@vt.edu>
-
- * bsd-man-to-ecma.pl, bsd-man-to-exception.pl: Added; scripts to help
- convert BSD man pages into ECMA XML formats. Run `perldoc PROGRAM` for
- program documentation.
- * Makefile.am: Add bsd-man-to-ecma.pl and bsd-man-to-exception.pl to
- EXTRA_DIST.
-
-2005-08-11 Dan Winship <danw@novell.com>
-
- * monodocer.cs: Don't preserve whitespace when reading the old
- doc, and don't add any whitespace when creating the new doc. Just
- let the XmlTextWriter handle indentation and it will all just
- work.
-
-2005-08-03 Atsushi Enomoto <atsushi@ximian.com>
-
- * monodocer.cs : update name attribute in paramref elements in sync
- with that of param element.
-
-2005-07-09 Joshua Tauberer <tauberer@for.net>
-
- From Rodolfo Campero <rodolfo.campero@gmail.com>
- (more or less):
- * monodocs2slashdoc.cs: Updated for changes in
- index.xml for documenting multiple assemblies.
- This app now writes out XML files for each assembly
- as well as NamespaceSummaries.xml to the working
- directory.
-
-2005-06-12 Joshua Tauberer <tauberer@for.net>
-
- * monodocer.cs: Added --importslashdoc option to
- import the contents of /doc-generated xml docs
- into the generated files.
-
-2005-06-09 Joshua Tauberer <tauberer@for.net>
-
- * monodocer.cs : When documenting a single assembly,
- default the Title in index.xml to the name of the
- assembly.
-
-2005-06-04 Eric Butler <eric@extremeboredom.net>
-
- (copied from ChangeLog in parent directory)
- * monodocer.cs
- - Now exits with an exit code of 1 in the event of an error
- - Added '-name' command line argument
- - Use above argument for <Title> element
-
-2005-06-01 Joshua Tauberer <tauberer@for.net>
-
- * monodocer.cs : Old index.xml files need to have new nodes
- created for multiple assemblies, and the old Assembly and
- Attributes nodes removed. Added a Title element for 2html.
-
- * overview.xsl : Revised monodocs2html to use the Title
- element in index.xml for page titles, rather than the
- assembly name, which isn't available anymore since there
- may be more than one assembly.
-
-2005-05-23 Mike Kestner <mkestner@novell.com>
-
- * monodocer.cs : add multiple assembly updating.
-
-2005-05-09 Joshua Tauberer <tauberer@for.net>
-
- * Thanks for pushing me to use a ChangeLog.
- * Disallow documenting types in the root namespace (type.Namespace ==
- null).
- * When a <code> tag has a 'src' attribute, monodocer will replace
- the contents of the element with the text in the indicated file.
- the path is relative to the path given as the --path option.
- * Properties that have different access modifiers on their accessors
- are now given signatures that reflect that. (But Monodoc doesn't
- recognize this properly. A format change is needed.)
- * monodocs2html: Create the destination directory if it doesn't exist.
-
-2005-01-29 Jonathan Pryor <jonpryor@vt.edu>
-
- * ChangeLog: Added
- * monodocer.cs (GetTypeFileName): Add check for type.Namespace == null.
- Fixes NullReferenceException when trying to update Mono.Posix.dll.
-