1 2010-02-28 Jonathan Pryor <jpryor@novell.com>
3 * Mono.Documentation/webdoc.cs: Add --use-system-sources option so
4 that 'mdoc export-html-webdoc' will use the system-installed sources
5 in addition to any -r'd sources (which was the behavior 2 commits
8 2010-02-26 Jonathan Pryor <jpryor@novell.com>
10 * Mono.Documentation/assembler.cs: Allow other apps to get the same
11 '--format' logic, specifically 'mdoc export-html-webdoc'.
12 * Mono.Documentation/webdoc.cs: Allow it to be more "stand-alone".
13 Previously, it would depend upon the system-wide .source files.
14 This is bad, because you might want to generate the 'cache'
15 directory for a different installation, with a different set of
16 .tree/.zip/.source files, and you might not want to replace your own
17 and/or you often forget, as is the case with me. Instead, allow a
18 format to be specified for .tree files, and allow additional .source
19 files to be referenced so that extension methods will be found within
20 the specified sources. This allows for a "stand-alone" method of
21 operation w/o depending upon the system-wide .source files.
23 2010-01-11 Jonathan Pryor <jpryor@novell.com>
25 * Mono.Documentation/monodocs2slashdoc.cs: Fix NamespaceSummaries.xml
26 generation to look at the ns-NAMESPACE.xml files, not just
29 2009-12-03 Jonathan Pryor <jpryor@novell.com>
31 * Resources/stylesheet.xsl: Add support for generating namespace links
32 for <see cref="N:..." />.
33 * Test/DocTest-v1.cs: Add namespace links for testing.
34 * Test/en.expected.importslashdoc/Mono.DocTest/Color.xml,
35 Test/en.expected.importslashdoc/NoNamespace.xml,
36 Test/html.expected/index.html,
37 Test/html.expected/Mono.DocTest/Color.html,
38 Test/html.expected/NoNamespace.html,
39 Test/msxdoc-expected.importslashdoc.xml: Flush.
41 2009-12-03 Jonathan Pryor <jpryor@novell.com>
43 * Test/html.expected/Mono.DocTest.Generic/MyList`1.html,
44 Test/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush to sync
45 with updated mdoc. Inherited members are now shown (as they were
46 supposed to be, but a bug had prevented from being found).
48 2009-12-02 Jonathan Pryor <jpryor@novell.com>
50 * Mono.Documentation/monodocs2html.cs: Enable debug output in
51 XslCompiledTransform when --debug is specified.
52 * Resources/overview.xsl: Add xmlns, exclude-result-prefixes so that
53 .NET won't complain about the stylesheet. (Why's it complain?)
54 * Resources/stylesheet.xsl: .NET compatibility fixes:
55 - Use msxsl:node-set() when necessary.
56 - Change XPath expressions so that they work properly everywhere.
57 * Makefile: Don't build an 'mdoc-net.exe' anymore, as the normal
58 mdoc.exe can now run normally under .NET.
60 2009-11-25 Jonathan Pryor <jpryor@novell.com>
62 * Makefile: When copying mdoc-net.exe into ./mdoc-net, rename it to
63 mdoc.exe so that .NET users continue to use the name 'mdoc'. This
64 will make documentation easier, etc.
66 2009-11-25 Jonathan Pryor <jpryor@novell.com>
68 + Giving up on getting mdoc to fully work under .NET; specifically,
69 mdoc-export-html makes use of many Mono XSLT "extensions" (part of
70 XSLT 2.0, apparently) which .NET doesn't support. To run mdoc under
71 .NET, use mdoc-net.exe, which is a "static" mdoc.exe, including the
72 sources for BOTH monodoc.dll AND Mono's System.Xml.dll in the binary.
73 Yes, this makes it huge.
75 * . (svn:ignore): Ignore generated files.
76 * Makefile: If the NET variable is present (e.g. 'make NET=1'),
77 generate mdoc-net.exe instead of mdoc.exe, otherwise generate
78 mdoc.exe (the default, with normal dependencies). When NET is
79 present, also create a 'mdoc-net' directory which contains
80 mdoc-net.exe and all assembly dependencies (to make it easier to
81 grab all the deps at once).
82 * mdoc-net.exe.sources: Added; sources to use for mdoc-net.exe.
83 * Mono.Documentation/monodocs2html.cs: Ensure that the "Index" XSLT
84 variable is set before generating output.
86 2009-11-24 Jonathan Pryor <jpryor@novell.com>
88 * Mono.Documentation/monodocs2html.cs: Use XslCompiledTransform, as
89 it's *significantly* faster under .NET than XslTransform --
90 1.7s vs ~3 minutes 7s (for a trivial test case).
92 2009-11-23 Jonathan Pryor <jpryor@novell.com>
94 * Resources/overview.xsl, Resources/stylesheet.xsl: Remove the 'ext'
95 and 'language' global <xsl:param>'s, as they cause "variable 'foo'
96 was duplicated within the same scope" errors under .NET.
98 2009-11-23 Jonathan Pryor <jpryor@novell.com>
100 * Mono.Documentation/monodocer.cs: ".NET support": ensure that we
101 always get Unix line endings so that we can update documentation
102 under both Mono & .NET w/o continually changing the file due to
103 line-ending differences.
105 2009-11-06 Jonathan Pryor <jpryor@novell.com>
107 * Mono.Documentation/monodocer.cs: When deleting the ExtensionMethods
108 element, remove it from the correct parent XML node. Fixes #553144.
110 2009-09-19 Jonathan Pryor <jpryor@novell.com>
112 * Mono.Documentation/monodocs2html.cs: Add --with-profile=PROFILE
113 option, which just provides a simple mapping between profile names
114 like net_3_5 to the versions used in that profile.
116 2009-09-19 Jonathan Pryor <jpryor@novell.com>
118 * Mono.Documentation/monodocs2html.cs: By request of Edd Dumbill, add
119 --with-version=VERSION option. This will generate HTML
120 documentation for ONLY those types/members which exist within
121 VERSION. This makes it easy to generate HTML that will show e.g.
122 only MonoTouch docs (and not the full class library docs).
123 * Makefile: Add test for 'mdoc export-html --with-version=VERSION'.
124 Somewhat brain-dead, as it only checks for added types (and not
125 added members), but better than nothing...
127 2009-09-09 Jonathan Pryor <jpryor@novell.com>
129 * Mono.Documentation/monodocs2html.cs: Fix behavior when multiple
130 source directories are provided, e.g. 'mdoc export-html -o o a b c'
131 with docs located in directories a, b, and c. Previously this would
132 be equivalent to running aginst a, b, and c separately, resulting in
133 o/index.html being continually overwritten (and thus not showing ALL
135 * Resources/stylesheet.xsl: Make $Index a parameter (as monodocs2html
136 will create an in-memory index containing all types from all
137 specified directories), and various changes to cope with $Index no
138 longer being a file. Better support files in the global namespace.
139 * Test/html.expected/NoNamespace.html: Fix assembly link.
141 2009-08-12 Jonathan Pryor <jpryor@novell.com>
143 * Test/DocTest-v1.cs: Add a comment which uses <format/>, to test html
145 * Resources/monodoc-ecma.xsd: Permit <format/> in various elements.
146 * Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
147 Test/html.expected/Mono.DocTest/DocAttribute.html,
148 Test/msxdoc-expected.importslashdoc.xml: Flush.
150 2009-08-12 Jonathan Pryor <jpryor@novell.com>
152 * Makefile: Add ../monodoc/Resources/mdoc-html-format.xsl as a resource.
154 2009-08-06 Jonathan Pryor <jpryor@novell.com>
156 * mdoc.exe.sources: Add ../../build/common/Consts.cs to the build.
157 * Mono.Documentation/mdoc.cs: mdoc version is Consts.MonoVersion, not
158 some hard-coded, perpetually out-of-date version.
160 2009-08-02 Jonathan Pryor <jpryor@novell.com>
162 * Mono.Documentation/monodocer.cs: Sometimes <AssemblyVersion/> is
163 found twice when it's actually present only once (!). Attempt to
164 work around this by usinq LINQ instead of a foreach (which oddly
167 2009-07-31 Jonathan Pryor <jpryor@novell.com>
169 * Mono.Documentation/monodocer.cs: Record attributes that are placed
170 on property get/set and event add/remove accessors.
171 * Test/DocTest-v1.cs: Add attributes to some accessors.
172 * Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
173 Test/en.expected.since/Mono.DocTest/Widget.xml,
174 Test/en.expected/Mono.DocTest/Widget.xml,
175 Test/html.expected/Mono.DocTest/Widget.html,
176 Test/msxdoc-expected.importslashdoc.xml: Flush.
178 2009-06-23 Jonathan Pryor <jpryor@novell.com>
180 * Mono.Documentation/monodocer.cs: Don't generate an exception when an
181 enumeration contains multiple names with the same value.
183 * Test/DocTest-v1.cs: Add test for #515030.
184 * Test/en.expected/Mono.DocTest/Color.xml,
185 Test/en.expected.since/Mono.DocTest/Color.xml,
186 Test/html.expected/Mono.DocTest/Color.html,
187 Test/msxdoc-expected.importslashdoc.xml,
188 Test/en.expected.importslashdoc/Mono.DocTest/Color.xml: Flush.
190 2009-04-18 Jonathan Pryor <jpryor@novell.com>
192 * Mono.Documentation/webdoc.cs: Change -o semantics to be a directory
193 prefix, e.g. `mdoc export-html-webdoc -o cache.new foo.tree` will
194 output files into `cache.new/foo` instead of directly into
195 `cache.new`. This makes it easier to specify more than one
196 .tree/.zip file on the command line.
198 2009-04-16 Jonathan Pryor <jpryor@novell.com>
200 * Mono.Documentation/monodocs2slashdoc.cs: Code refactor; use
201 EcmaDoc.GetCref() to generate //member/@name values.
202 * Mono.Documentation/dump.cs: Add -f=FORMAT support, so that we can
203 load an appropriate HelpSource (if supplied) so that an appropriate
204 Node.PublicUrl can be displayed in the output.
206 2009-04-15 Jonathan Pryor <jpryor@novell.com>
208 * Mono.Documentation/webdoc.cs: Remove console debug spew. If you run
209 with `mdoc -v`, each URL will be printed as it's processed.
211 2009-04-15 Jonathan Pryor <jpryor@novell.com>
213 * Mono.Documentation/webdoc.cs: When extracting files from the .zip
214 file, ensure that the output file is closed. Properly pre-render
215 ecma namespace documentation.
217 2009-04-15 Jonathan Pryor <jpryor@novell.com>
219 * Makefile: Add reference to ICSharpCode.SharpZipLib.dll.
220 * mdoc.exe.sources: Add Mono.Rocks/ObjectRocks.cs,
221 Mono.Rocks/StreamRocks.cs.
222 * Mono.Documentation/webdoc.cs: Refactor into smaller methods. Extract
223 ZIP file contents in addition to generating HTML output. Use
224 monodoc helper methods to determine cache directory.
225 * Mono.Documentation/ObjectRocks.cs: Rename to
226 Mono.Rocks/ObjectRocks.cs.
227 * Mono.Rocks/ObjectRocks.cs: Add Check.Destination().
228 * Mono.Rocks/StreamRocks.cs: Added; extension methods for Streams.
230 2009-04-15 Jonathan Pryor <jpryor@novell.com>
232 * Mono.Documentation/webdoc.cs: The timestamp logic was wrong it the
233 output directory didn't exist. Fix.
235 2009-04-15 Jonathan Pryor <jpryor@novell.com>
237 * Mono.Documentation/webdoc.cs: Do as make(1) does: if the
238 target directory already exists and is newer than the source files,
239 don't regenerate output. (Greatly speeds things up if nothing has
240 changed.) Add a --force-update option to disable this behavior.
242 2009-04-15 Jonathan Pryor <jpryor@novell.com>
244 * Mono.Documentation/webdoc.cs: Change the default -o value to
245 include a "cache" intermediate directory. This makes it easier to
246 kill the entire cache at once.
248 2009-04-15 Jonathan Pryor <jpryor@novell.com>
250 * Mono.Documentation/webdoc.cs: Provide nice default -o value.
252 2009-04-15 Jonathan Pryor <jpryor@novell.com>
254 * Mono.Documentation/webdoc.cs: Load documentation through a
255 HelpSource, not through the RootTree, as URLs of the form
256 "ecma:0#AvoidExtensionMethodOnSystemObjectRule/" use the number (0
257 in this case) as a HelpSource-relative identifier. Result: you get
258 the wrong documentation if you go through RootTree.
260 2009-04-15 Jonathan Pryor <jpryor@novell.com>
262 * Makefile: Add reference to System.Web.dll, for HttpUtility.
263 * mdoc.exe.sources: Add ObjectRocks.cs, webdoc.cs to the build.
264 * Mono.Documentation/mdoc.cs: Add export-html-webdoc command, which
265 "pre-renders" HTML for use by the webdoc ASP.NET renderer.
266 * Mono.Documentation/webdoc.cs: Added; MDocExportWebdocHtml
267 implementation; attempts to pre-render HTML based on .tree/.zip
269 * Mono.Documentation/ObjectRocks.cs: Added; extension methods for tree
270 traversal (from Mono.Rocks). For use in webdoc.cs.
272 2009-04-09 Jonathan Pryor <jpryor@novell.com>
274 * Mono.Documentation/monodocer.cs: Using a single IAssemblyResolver is
275 an improvement, but doesn't fix all problems. In particular, some
276 assemblies will depend upon other assemblies to load (e.g. 3rd party
277 assemblies) but these dependent assemblies shouldn't be documented.
278 Add support for -r:ASSEMBLY and -L:DIRECTORY arguments to allow the
279 user to manually add to the assembly search path so that assemblies
280 can be found. Assemblies added via -r will NOT be documented.
282 2009-04-08 Jonathan Pryor <jpryor@novell.com>
284 * Mono.Documentation/monodocer.cs: Use a single IAssemblyResolver
285 shared amongst all AssemblyDefinitions to resolve assembly/type
286 references with Cecil. Otherwise, if we have deeply nested
287 directories with cross-directory assembly dependencies, then Cecil
288 won't find the necessary assemblies (e.g. b/bin/Debug/b.dll has a
289 type which inherits from a/bin/Debug/a.dll -- here, we'll have two
290 separate AssemblyDefinitions, and when b.dll's AssemblyDefinition
291 tries to resolve types from a.dll, it fails).
292 See: http://lists.ximian.com/pipermail/mono-devel-list/2009-April/031646.html
294 2009-03-29 Jonathan Pryor <jpryor@novell.com>
296 * Mono.Documentation/exceptions.cs: Add
297 ExceptionLocations.AddedMember, used for --exceptions=added support.
298 * Mono.Documentation/monodocer.cs: Add --exceptions=added, which will
299 only add <exception/> elements for newly added elements. This is
300 useful for updating documentation for established projects which
301 already have <exception/> corrections (e.g. *removal* of
302 <exception/> elements because the exceptions weren't actually
303 possible), so only new members should have <exception/> created.
305 2009-03-20 Jonathan Pryor <jpryor@novell.com>
307 * Mono.Documentation/monodocs2html.cs: Perform the timestamp check for
308 the top-level and namespace-level index files.
310 2009-03-21 Jonathan Pryor <jpryor@novell.com>
312 * Mono.Documentation/monodocer.cs: Be nice to make,
313 mdoc-export-html, and other apps that use file timetamps: if the
314 file contents haven't changed after the update, don't replace the
315 "original" file. This preserves file timestamps, thus allowing
316 other apps to behave nicely (e.g. mdoc-export-html won't update all
317 documentation after running mdoc-update, as the files won't change
318 unless something has *actually* changed).
320 2009-03-20 Jonathan Pryor <jpryor@novell.com>
322 * Mono.Documentation/monodocs2html.cs: Do as make(1) does: if the
323 target file already exists and is newer than the source file, don't
324 regenerate it. (Greatly speeds things up if only a few .xml files
325 changed.) Add a --force-update option to disable this behavior.
327 2009-02-26 Jonathan Pryor <jpryor@novell.com>
329 * Mono.Documentation/assembler.cs: When processing an empty directory,
330 it's possible for HelpSource.Tree to be null; avoid an NRE.
332 2009-02-17 Jonathan Pryor <jpryor@novell.com>
334 * Test/DocTest-v1.cs: Add test for #475814.
335 * Mono.Documentation/exceptions.cs, Mono.Documentation/monodocer.cs:
336 Use the new Mono.Cecil .Resolve() methods instead of (erroneously)
337 duplicating their functionality with the .GetDefinition() methods.
338 ExceptionLookup.this[IMemberReference] checks for multi-dimensional
339 arrays, as MD arrays are "special" (Cecil can't resolve them, as
340 they're internal to the runtime with no specific associated IL).
343 2009-02-17 Jonathan Pryor <jpryor@novell.com>
345 * Mono.Documentation/monodocer.cs: Check that the cref attribute is
346 non-null before trying to use it when importing slashdoc sources.
348 * Test/DocTest-v1.cs: Add an <exception/> doc comment with an invalid
349 attribute value for testing.
351 2009-02-17 Jonathan Pryor <jpryor@novell.com>
353 * Mono.Documentation/mdoc.cs: Set Environment.ExitCode=1 if an
354 exception occurs, so that calling code can determine that an error
355 occurred w/o resorting to parsing stderr. Fixes #475746.
357 2009-02-16 Jonathan Pryor <jpryor@novell.com>
359 * Mono.Documentation/monodocer.cs: Support C#4 variant generics, e.g.
360 `delegate TRet Func<in TArg, out TRet>(TArg a)'. Alas, this
361 required making MemberFormatter explicitly stateful, so any thoughts
362 of using instances w/o locking are now out the window... (Not that
363 threads are currently used, but they're planned to be used...)
364 TODO: Add a test to Test/DocTest-v1.cs. This wasn't done as the
365 current gmcs support doesn't like intermixing variance with generic
366 parameter attributes, and I don't want to introduce a new delegate
367 type (and the ~6 new files that would imply) just for this feature.
369 2009-02-10 Jonathan Pryor <jpryor@novell.com>
371 * Mono.Documentation/monodocer.cs: Cleanup: turn static data into
372 instance data (for future Threading changes, as only static data
373 will be tracked for thread-safety); use MDocCommand.Message() and
374 MDocCommand.Error() for message reporting; remove warnings.
376 2009-01-05 Jonathan Pryor <jpryor@novell.com>
378 * Makefile: Fix $(PROGRAM) dependencies so that mdoc.exe is rebuilt
379 when one of the dependent ../monodoc/Resources/* files is changed.
381 2009-01-05 Jonathan Pryor <jpryor@novell.com>
383 * Mono.Documentation/mdoc.cs: `mdoc' (no arguments) shouldn't print an
384 index out of range error. Fix.
385 * Mono.Documentation/monodocer.cs: Rename -fno-member-assembly-info to
386 -fno-assembly-versions, which prevents generation of //AssemblyVersion
387 elements. This suffers the same warning as -fno-member-assembly-info,
388 so don't use unless you can guarantee that no members will
389 ever be removed from your public API. :-)
390 Clean up -f handling so that -f:no-assembly-versions will work as
393 2009-01-05 Jonathan Pryor <jpryor@novell.com>
395 * Mono.Documentation/monodocer.cs: Add -fno-member-assembly-info,
396 which remove /Type/Members/Member/AssemblyInfo elements.
397 Requested by Mike Kestner.
398 Warning: this option will break automatic version tracking, so if a
399 member is present in e.g. v1.0 and is removed in e.g. v2.0,
400 the //Member element will be removed entirely when updating the
401 documentation against the 2.0 assembly. Use with care.
403 2008-12-06 Jonathan Pryor <jpryor@novell.com>
405 * Mono.Documentation/monodocer.cs: Remove "exception" from DocsNodeOrder
406 so that <exception/> elements aren't grouped together. This causes
407 `make doc-update` to result in ~0 changes in ../../class/corlib.
408 Change the sorting of --exceptions-generated <exception/> nodes so
409 that namespaces are taken into consideration, thus "properly"
410 grouping types by namespaces, as I'd usually expect...
412 2008-12-05 Jonathan Pryor <jpryor@novell.com>
414 * Mono.Documentation/monodocer.cs, Mono.Documentation/monodocs2html.cs:
415 Reorder parameters to be in sorted order, so `mdoc help COMMAND`
416 parameters are sorted.
417 * Mono.Documentation/monodocer.cs: Remove try/catch in
418 MDocUpdater.Run(MDocUpdaterOptions), so that any generated exceptions
419 will be handled within mdoc itself (thus allowing the normal
420 "See `mdoc help' for more information." message). Improve some
421 error messages so they're more useful.
423 2008-12-04 Jonathan Pryor <jpryor@novell.com>
425 * Makefile: Specify --exceptions=all in mdoc-update invocations.
426 * exceptions.cs: Add support for documenting a *subset* of all
427 possible exceptions. Subsets include: the member itself, the member
428 and methods it calls that are in the same assembly, and all possible
429 methods across all assemblies.
430 * monodocer.cs: Allow --exceptions to take a SOURCES argument, to
431 control which location sources will be searched for exceptions.
433 2008-12-02 Jonathan Pryor <jpryor@novell.com>
435 * Makefile: Add --exceptions to `mdoc update` invocations to test
436 <exception/> generation.
437 * mdoc.exe.sources: Add Mono.Documentation/exceptions.cs to the build.
438 * Mono.Documentation/exceptions.cs: Added; searches through the
439 callgraph of an IMemberReference, recording which exception types
440 are created (and where they're created from).
441 * Mono.Documentation/monodocer.cs: Generate <exception/> elements.
442 * Test/DocTest-v1.cs: Modify some methods so that exceptions are
443 emitted (thus testing <exception/> generation).
444 * Test/DocTest-v2.patch: Update (so patch(1) doesn't complain).
445 * Test/en.expected.importecmadoc/System/Array.xml,
446 Test/en.expected.importecmadoc/System/Environment.xml,
447 Test/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
448 Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
449 Test/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
450 Test/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
451 Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
452 Test/en.expected.importslashdoc/System/Array.xml,
453 Test/en.expected.importslashdoc/System/Environment.xml,
454 Test/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
455 Test/en.expected.since/Mono.DocTest/DocAttribute.xml,
456 Test/en.expected.since/Mono.DocTest/DocValueType.xml,
457 Test/en.expected.since/Mono.DocTest/UseLists.xml,
458 Test/en.expected.since/Mono.DocTest/Widget.xml,
459 Test/en.expected.since/System/Array.xml,
460 Test/en.expected.since/System/Environment.xml,
461 Test/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
462 Test/en.expected/Mono.DocTest/DocAttribute.xml,
463 Test/en.expected/Mono.DocTest/DocValueType.xml,
464 Test/en.expected/Mono.DocTest/UseLists.xml,
465 Test/en.expected/Mono.DocTest/Widget.xml,
466 Test/en.expected/System/Array.xml,
467 Test/en.expected/System/Environment.xml,
468 Test/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
469 Test/html.expected/Mono.DocTest/DocAttribute.html,
470 Test/html.expected/Mono.DocTest/DocValueType.html,
471 Test/html.expected/Mono.DocTest/UseLists.html,
472 Test/html.expected/Mono.DocTest/Widget.html,
473 Test/html.expected/System/Array.html,
474 Test/html.expected/System/Environment.html,
475 Test/msxdoc-expected.importslashdoc.xml: Flush; adds <exception/>
476 elements (and/or HTML-rendered output of <exception/> elements).
478 2008-11-19 Jonathan Pryor <jpryor@novell.com>
480 * Mono.Documentation/monodocer.cs: Add the assembly's directory to
481 Cecil's BaseAssemblyResolver search list so that assemblies in the
482 same directory as the assembly we're processing can be found.
483 Allows mono-tools/gendarme to be built with a Cecil-using mdoc.
485 2008-11-15 Jonathan Pryor <jpryor@novell.com>
487 * Mono.Documentation/monodocer.cs: Properties on interfaces shouldn't
488 have `abstract' on them.
489 * Test/DocTest-v1.cs: Add a property to an interface to check above.
490 * Test/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
491 Test/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
492 Test/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
493 Test/html.expected/Mono.DocTest/Widget+IMenuItem.html,
494 Test/msxdoc-expected.importslashdoc.xml: Flush.
496 2008-11-15 Jonathan Pryor <jpryor@novell.com>
498 * Mono.Documentation/monodocer.cs: Fix regressions found from
499 `make doc-update` in corlib:
500 - Ensure that custom attributes are sorted (they weren't before,
501 resulting in spurious differences between Reflection & Cecil
503 - CecilExtensions.GetMethod() should return null if the method can't
505 - DocUtils.IsDelegate() should ensure that the delegate type isn't
506 abstract (otherwise it dies on System.MulticastDelegate, which is
507 an abstract type lacking an "Invoke" method).
508 - Properly count generic argument counts for nested types (fixes IOE
509 from S.C.G.Dictionary`2.KeyCollection.Enumerator).
510 * Test/DocTest-v1.cs: Add doubly-nested class under a generic class to
511 simulate S.C.G.Dictionary`2.KeyCollection.Enumerator behavior.
512 * Test/en.expected.importslashdoc/index.xml,
513 Test/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.xml,
514 Test/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+NestedCollection.xml,
515 Test/en.expected.since/index.xml,
516 Test/en.expected.since/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.xml,
517 Test/en.expected.since/Mono.DocTest.Generic/GenericBase`1+NestedCollection.xml,
518 Test/en.expected/index.xml,
519 Test/en.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.xml,
520 Test/en.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection.xml,
521 Test/html.expected/index.html,
522 Test/html.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection+Enumerator.html,
523 Test/html.expected/Mono.DocTest.Generic/GenericBase`1+NestedCollection.html,
524 Test/html.expected/Mono.DocTest.Generic/index.html,
525 Test/msxdoc-expected.importslashdoc.xml: Flush (new types/changes
526 from DocTest-v1.cs changes).
529 2008-11-14 Jb Evain <jbevain@novell.com>
531 * Makefile: Use Mono.Cecil from class/lib/net_1_1, not net_2_0.
533 2008-11-14 Jonathan Pryor <jpryor@novell.com>
535 * Makefile: Don't build monodocer1.exe, and add Mono.Cecil.dll to the
536 list of assembly references for mdoc.exe.
537 * Mono.Documentation/monodocer.cs: Migrate from System.Reflection to
538 Mono.Cecil. This was done for two reasons:
539 1. mscorlib.dll: Reflection can load only one mscorlib.dll into an
540 AppDomain, which must be the same mscorlib.dll as the runtime
541 version. Thus, in order to run monodocer on mscorlib.dll v1.1,
542 monodocer must be a .NET 1.1 application, and to document
543 mscorlib.dll v2.0, monodocer must be a .net 2.0 app.
544 1.a I don't think it's feasable to drop support for
546 1.b This has been previously handled (so far) with conditional
547 compilation, but the conditional compilation is painful to
548 maintain, and prevents use of LINQ in ongoing development.
549 1.c .NET 4.0 will be coming out "soon" (within 2 years?), and it's
550 possible that mono will maintain the same limitation, thus
551 necessitating having *three* different monodocer programs to
552 document mscorlib.dll for v1.1, v2.0, and v4.0. Yech.
553 2. Future directions: It would be nice to parse method/property IL
554 bodies to determine which exceptions can be generated, thus
555 generating <exception cref="..."/> stubs. Even with empty stubs,
556 I belive this would be useful within e.g. MonoDevelop to know
557 which exceptions a method is able to generate.
558 This cannot be done (at present) with System.Reflection, and
559 would require Mono.Cecil.
560 Downsides: mdoc now depends upon Mono.Cecil, which is API-unstable.
561 This will likely also complicate execution under .NET, as Mono.Cecil
562 would need to be XCOPY deployed into mdoc.exe's directory.
563 * Test/DocTest-v1.cs: Add additional tests for Custom Attribute
565 * Test/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
566 Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
567 Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
568 Test/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml,
569 Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
570 Test/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
571 Test/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
572 Test/en.expected.since/Mono.DocTest/DocAttribute.xml,
573 Test/en.expected.since/Mono.DocTest/Widget+Direction.xml,
574 Test/en.expected.since/Mono.DocTest/Widget.xml,
575 Test/en.expected/Mono.DocTest.Generic/Func`2.xml,
576 Test/en.expected/Mono.DocTest.Generic/MyList`2.xml,
577 Test/en.expected/Mono.DocTest/DocAttribute.xml,
578 Test/en.expected/Mono.DocTest/Widget+Direction.xml,
579 Test/en.expected/Mono.DocTest/Widget.xml,
580 Test/html.expected/Mono.DocTest.Generic/Func`2.html,
581 Test/html.expected/Mono.DocTest.Generic/MyList`2.html,
582 Test/html.expected/Mono.DocTest/DocAttribute.html,
583 Test/html.expected/Mono.DocTest/Widget+Direction.html,
584 Test/html.expected/Mono.DocTest/Widget.html,
585 Test/msxdoc-expected.importslashdoc.xml: Flush -- updated output due
586 to new custom attributes, better implemented interface detection --
587 care of the Mono.Cecil migration -- etc.
589 2008-11-13 Jonathan Pryor <jpryor@novell.com>
591 * Test/html.expected/**: Update
592 //meta[@http-equiv='Content-Type']/@content attribute value (changed
593 due to yesterday's defaulttemplate.xsl fix).
595 2008-11-12 Jonathan Pryor <jpryor@novell.com>
597 * Resources/defaulttemplate.xsl: Update /html/head/meta/@content value
598 so that IE7 properly recognizes the file as UTF-8 encoded.
601 2008-10-27 Jonathan Pryor <jpryor@novell.com>
603 * Makefile: Fix build error caused by filenames containing '`'.
605 2008-10-27 Jonathan Pryor <jpryor@novell.com>
607 * Mono.Documentation/mdoc.cs: TraceLevel.Error messages should go to
608 Console.Error, as per Unix convention.
609 * Makefile: cehck-mdoc-validate* needs to also capture standard error.
611 2008-10-27 Jonathan Pryor <jpryor@novell.com>
613 * Mono.Documentation/validate.cs: Remove warnings
614 * Test/validate.check.monodocer, Test/validate.check.monodocer.since:
615 Don't generate output if no errors are found.
616 * Test/validate.check.monodocer.importslashdoc: Prefix error messages
617 with "mdoc:", as per Unix convention.
619 2008-10-24 Jonathan Pryor <jpryor@novell.com>
621 * Makefile: Fixup mdoc.exe dependencies so that it's rebuilt if the
622 resources or monodoc.dll change. Add tests for mdoc-validate.
623 * Mono.Documentation/assembler.cs, Mono.Documentation/mdoc.cs,
624 Mono.Documentation/monodocer.cs, Mono.Documentation/monodocs2html.cs,
625 Mono.Documentation/monodocs2slashdoc.cs,
626 Mono.Documentation/validate.cs:
627 - Major rearchitecture; instead of having the option parsing
628 centralized within mdoc.cs, keep option parsing within the relevant
630 - Introduce the MDocCommand abstract class to serve as the base class
631 -- primarily done to introduce the new Message() and Error()
632 methods, in which Message() will only show the message if the
633 current message level is >= the message's level (thus minimizing
634 console spew); see ../monodoc for more details.
635 - Add `-v' ("verbose") top-level argument to allow setting/adding
636 levels, so that `mdoc -v -v assemble ...` will show *all*
637 assemble-associated messages (which can be quite voluminous).
638 - Remove compiler warnings, when able.
639 * Mono.Documentation/XhtmlWriter.cs: Remove warning about unused
641 * Resources/monodoc-ecma.xsd: Extend the XSD to support more
642 elements/attributes on various elements -- e.g. mdoc-update looks
643 for a //code/@src attribute, which wasn't defined in the XSD. Oops.
644 * Test/validate.check.monodocer.importslashdoc: Flush (due to above
647 2008-10-22 Jonathan Pryor <jpryor@novell.com>
649 * Makefile: Correct path names.
650 * Mono.Documentation/monodocer.cs: Better support nested types.
651 * Test/DocTest-v1.cs: Add 4 levels of nested types.
652 * Test/en.expected.importslashdoc/index.xml,
653 Test/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
654 Test/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.xml,
655 Test/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass+Double+Triple.xml,
656 Test/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass+Double.xml,
657 Test/en.expected.since/index.xml,
658 Test/en.expected.since/Mono.DocTest/Widget.xml,
659 Test/en.expected.since/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.xml,
660 Test/en.expected.since/Mono.DocTest/Widget+NestedClass+Double+Triple.xml,
661 Test/en.expected.since/Mono.DocTest/Widget+NestedClass+Double.xml,
662 Test/en.expected/index.xml,
663 Test/en.expected/Mono.DocTest/Widget.xml,
664 Test/en.expected/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.xml,
665 Test/en.expected/Mono.DocTest/Widget+NestedClass+Double+Triple.xml,
666 Test/en.expected/Mono.DocTest/Widget+NestedClass+Double.xml,
667 Test/html.expected/index.html,
668 Test/html.expected/Mono.DocTest/index.html,
669 Test/html.expected/Mono.DocTest/Widget.html,
670 Test/html.expected/Mono.DocTest/Widget+NestedClass+Double+Triple+Quadruple.html,
671 Test/html.expected/Mono.DocTest/Widget+NestedClass+Double+Triple.html,
672 Test/html.expected/Mono.DocTest/Widget+NestedClass+Double.html,
673 Test/msxdoc-expected.importslashdoc.xml: Flush.
675 2008-10-17 Jonathan Pryor <jpryor@novell.com>
677 * Makefile: Reference the monodoc.dll from the net_1_1 profile, as
678 that's the only one that will get built.
680 2008-10-17 Jonathan Pryor <jpryor@novell.com>
682 * Makefile: Fix $(EXTRA_DISTFILES) so that `make distcheck` doesn't
683 fail on mdoc anymore...
685 2008-10-18 Raja R Harinath <harinath@hurrynot.org>
687 * Makefile (MCS1): Use 'class/lib/net_1_1', not 'class/lib/1.0'.
689 2008-10-17 Jonathan Pryor <jpryor@novell.com>
691 * Mono.Documentation/monodocer.cs: -overrides & -pretty should default
692 to true. (Not a major change, as mdoc.exe already did this, so it
693 really only impacts monodocer1.exe, which is internal...)
695 2008-10-17 Jonathan Pryor <jpryor@novell.com>
697 * Mono.Documentation/monodocer.cs: Only provide a Main() method and
698 use Mono.GetOptions when targeting .NET 1.0 (i.e. monodocer1.exe).
700 2008-10-16 Jonathan Pryor <jpryor@novell.com>
702 Migration from monodoc/tools to mcs/tools/mdoc...
704 * . (svn:ignore), Test (svn:ignore): Ignore generated files.
705 * assembler.cs, mdoc.cs, monodocer.cs, monodocs2html.cs,
706 monodocs2slashdoc.cs, normalize.cs, validate.cs, XhtmlWriter.cs:
707 Move to Mono.Documentation.
708 * defaulttemplate.xsl, overview.xsl, stylesheet.xsl: Moved to
710 * DocTest: Moved to Test.
711 * DocTest-v1.cs, DocTest-v2.patch, TestEcmaDocs.xml: Moved to Test.
712 * mdoc.exe.sources: Added; mcs include file to build mdoc.exe.
713 * Makefile: Added; build mdoc.exe, monodocer1.exe, and unit tests for
715 * Mono.Documentation/assembler.cs, Mono.Documentation/normalize.cs,
716 Mono.Documentation/mdoc.cs, Mono.Documentation/monodocs2slashdoc.cs,
717 Mono.Documentation/monodocs2html.cs, Mono.Documentation/validate.cs:
718 Modify command line handling to remove Mono.GetOptions dependency.
719 * Test/DocTest-v1.cs: Update //code/@src attribute due to changed paths.
720 * Test/msxdoc-expected.importslashdoc.xml,
721 * Test/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml: Flush
722 due to above DocTest-v1.cs change.
724 2008-10-16 Jonathan Pryor <jpryor@novell.com>
726 * monodocer.cs: Fixup sorting of explicitly-implement generic members.
727 This keeps members from "bouncing around" in random orders when
728 updating documentation...
729 * DocTest-v1.cs: Explicitly implement some generic interface members on
730 MyList<A,B> to provoke the bug fixed above.
731 Dictionary<K,V>.ValueCollection in mscorlib was the original
733 * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
734 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
735 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
736 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
737 DocTest/msxdoc-expected.importslashdoc.xml: Flush.
739 2008-10-15 Jonathan Pryor <jpryor@novell.com>
741 * monodocer.cs: Ignore some attributes, because they're ~meaningless
742 for documentation purposes (e.g. who cares if we need attributes to
743 represent decimal constants, or that a method shouldn't be stepped
744 into with the debugger, or...).
745 * DocTest/en.expected/index.xml,
746 * DocTest/en.expected/Mono.DocTest/Widget.xml,
747 * DocTest/en.expected/Mono.DocTest.Generic/Extensions.xml,
748 * DocTest/en.expected.since/index.xml,
749 * DocTest/en.expected.since/Mono.DocTest/Widget.xml,
750 * DocTest/en.expected.since/Mono.DocTest.Generic/Extensions.xml,
751 * DocTest/html.expected/Mono.DocTest/Widget.html,
752 * DocTest/html.expected/Mono.DocTest.Generic/Extensions.html,
753 * DocTest/en.expected.importslashdoc/index.xml,
754 * DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
755 * DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Extensions.xml:
758 2008-10-05 Jonathan Pryor <jpryor@novell.com>
760 * monodocer.cs: When sorting <Member/> elements elements, take generic
761 type parameters into account, so that methods with the same number
762 of type parameters are sorted together, instead of strewn across the
763 file according to the full //Member/@MemberName comparison.
764 * DocTest/**: Flush (and wtf is with the [DebuggerHidden] appearance?).
766 2008-09-19 Jonathan Pryor <jpryor@novell.com>
768 * DocTest-v1.cs: Add a member with a "deeply nested" generic parameter
769 list, so test the mdoc-html-utils.xsl fix.
770 * DocTest/msxdoc-expected.importslashdoc.xml,
771 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
772 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
773 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
774 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush.
776 2008-09-16 Jonathan Pryor <jpryor@novell.com>
778 * monodocer.cs: FieldInfo.GetValue() may throw, particularly if getting
779 the value of a public+static+readonly field, and the constructor for
780 the type of said field throws an exception (though DocTest-v1.cs has
781 a similar scenario). This is bad, as it prevents monodocer from
782 completing its work. Found by Dan Morgan.
783 * DocTest-v1.cs: Create a `public static readonly` field that will
784 generate an exception from the class constructor.
785 * DocTest/en.expected/Mono.DocTest/Widget.xml,
786 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
787 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
788 DocTest/html.expected/Mono.DocTest/Widget.html,
789 DocTest/msxdoc-expected.importslashdoc.xml: Flush.
791 2008-09-16 Jonathan Pryor <jpryor@novell.com>
793 * monodocer.cs: Allow #region/#endregion parsing to cope with blank lines.
795 2008-09-15 Jonathan Pryor <jpryor@novell.com>
797 * monodocer.cs: Strip off leading whitespace up to the indent level that
798 #region was found. This allows controlling how much leading whitespace is
799 preserved within the documentation (as too much whitespace will cause the
800 code to be indented significantly when rendered to e.g. html).
801 * DocTest-v1.cs: Indent the #region, to test the above.
802 * DocTest/msxdoc-expected.importslashdoc.xml,
803 DocTest/html.expected/Mono.DocTest/DocAttribute.html,
804 DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml:
807 2008-09-15 Jonathan Pryor <jpryor@novell.com>
809 * monodocer.cs: Allow //code/@src to include an anchor, in which the
810 anchor specifies a #region to include, instead of including the
811 entire document. This is currently limited to C# code. For example,
812 `<code lang="C#" src="foo.cs#Text"/>` would look insert all text
813 between `#region Text` and `#endregion` within foo.cs.
814 * DocTest-v1.cs: Add a #region, <code/> block to test the above.
815 * DocTest/msxdoc-expected.importslashdoc.xml,
816 DocTest/html.expected/Mono.DocTest/DocAttribute.html,
817 DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml:
820 2008-09-11 Jonathan Pryor <jpryor@novell.com>
822 * stylesheet.xsl: Post-process $cref so that we can use "nice"
823 //see/@cref strings that can actually refer to the right member.
824 For example, `<see cref="P:Foo.Bar{T}.Baz"/>` is needed to get a
825 nicely rendered "Foo.Bar<T>.Baz" link text, but previously it
826 wouldn't link to anything -- you'd need
827 `<see cref="P:Foo.Bar`1.Baz"/>` to get a functioning link for HTML
828 output. This now works.
830 2008-09-04 Jonathan Pryor <jpryor@novell.com>
832 * monodocer.cs: You can't use FieldInfo.GetValue() on generic types.
833 * DocTestv1.cs: Add checks for static fields on generic types.
836 2008-09-04 Jonathan Pryor <jpryor@novell.com>
838 * monodocer.cs: Clear out existing <value/> elements when import XML
839 documentation which also contains a <value/> element. (This keeps us from
840 getting multiple duplicate <value/> elements every time we update while
843 2008-08-31 Jonathan Pryor <jpryor@novell.com>
845 * DocTest-v1.cs: Update XML doc comment to mention correct cref.
846 * monodocer.cs: Further fixup XML documentation import and import the actual
847 *contents* of the <exception/> element (oops). Add support for importing
848 XML documentation for explicitly implemented interface members (CSC-style,
851 2008-08-27 Jonathan Pryor <jpryor@novell.com>
853 * monodocer.cs: Fixup XML documentation import to be more consistent with
854 ECMA XML import. In particular, this fixes <exception/> import so that
855 the same element isn't imported multiple times, leading to duplicate
856 <exception/> elements the more often monodocer is run.
857 * DocTest/msxdoc-expected.importslashdoc.xml,
858 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
859 Changes order of imported XML to reflect the original element order.
861 2008-08-11 Jonathan Pryor <jpryor@novell.com>
863 * monodocer.cs: Build fix (gmcs doesn't like using-alias-directives to
864 private nested types anymore).
866 2008-05-06 Wade Berrier <wberrier@novell.com>
868 * Makefile.am: Add Options.cs to EXTRA_DIST
870 2008-04-22 Jonathan Pryor <jpryor@novell.com>
872 * DocTest/en.expected/Mono.DocTest.Generic/Func`2.xml,
873 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
874 DocTest/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
875 DocTest/html.expected/Mono.DocTest.Generic/Func`2.html: Flush: n377596
876 got fixed, so we can now retrieve custom attributes on all generic type
879 2008-04-15 Jonathan Pryor <jpryor@novell.com>
881 * . (svn:ignore): ignore generated files.
882 * Makefile.am: Add XmlDocUtils.cs to the build. Add unit tests for
883 monodocs2slashdoc; other monodocs2slashdoc changes.
884 * mdoc.cs: Update the arguments accepted by monodocs2slashdoc.
885 * monodocs2slashdoc.cs: Move DocUtils class into ../engine/XmlDocUtils.cs.
886 Add support for a -o parameter which contains all output (if specified).
888 - Add special support for extension methods -- index.xml now contains an
889 /Overview/ExtensionMethods element which contains ExtensionMethod
890 elements for all extension methods within all assemblies processed.
891 - The <ExtensionMethod/> element contains a subset of the <Member/> of the
892 actual extension method (and thus will contain a useful subset of the
893 documentation the source <Member/> contains), along with a <Targets/>
894 element describing all types the extension method applies to.
895 - Consequently, if you edit the documentation of your extension method,
896 you need to re-run monodocer to get the newly written documentation
897 inserted into index.xml.
898 - //Parameter/@RefType is "overloaded" to contain the "this" modifier of
899 extension methods (as this was easiest within mdoc-html-utils.xsl).
900 - Within CSharpMemberFormatter, insert generic type constraints for
901 methods. (Previously constraints were only done on types due to an
903 * monodocs2html.cs: Before rendering documentation via the XSLT, insert any
904 extension methods applicable to the type so that the extension methods
906 * DocTest-v1.cs: Add a class providing extension methods.
907 * stylesheet.xsl: Extension methods shouldn't be documented within the type,
908 just declared (and linked to the actual type's documentation).
909 * DocTest/msxdoc-expected.importslashdoc.xml: Added; expected output for
910 monodocs2slashdoc unit test.
911 * DocTest/en.expected/index.xml,
912 DocTest/en.expected/Mono.DocTest/UseLists.xml,
913 DocTest/en.expected/Mono.DocTest.Generic/Extensions.xml,
914 DocTest/en.expected/Mono.DocTest.Generic/Func`2.xml,
915 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
916 DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
917 DocTest/en.expected.since/index.xml,
918 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
919 DocTest/en.expected.since/Mono.DocTest.Generic/Extensions.xml,
920 DocTest/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
921 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
922 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
923 DocTest/en.expected.importslashdoc/index.xml,
924 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
925 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Extensions.xml,
926 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
927 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
928 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
929 DocTest/html.expected/index.html,
930 DocTest/html.expected/NoNamespace.html,
931 DocTest/html.expected/Mono.DocTest/DocAttribute.html,
932 DocTest/html.expected/Mono.DocTest/DocValueType.html,
933 DocTest/html.expected/Mono.DocTest/IProcess.html,
934 DocTest/html.expected/Mono.DocTest/UseLists.html,
935 DocTest/html.expected/Mono.DocTest/Widget.html,
936 DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
937 DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
938 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
939 DocTest/html.expected/Mono.DocTest.Generic/index.html,
940 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
941 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.html,
942 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
943 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
944 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
945 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
946 DocTest/html.expected/System/Array.html: Flush; also contains additional
947 <Attributes/> elements on generic type parameters due to a mono fix.
949 2008-04-09 Jonathan Pryor <jpryor@novell.com>
951 * DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html: Fix the
952 System.EventHandler link.
954 2008-04-08 Jonathan Pryor <jpryor@novell.com>
956 * DocTest-v1.cs: Add more attributes, generic constraints to further test
958 * Makefile.am: Add check-md-html-dir target to help with testing
959 monodocs2html w/o re-generating the DocTest/en.actual directory.
960 * monodocer.cs: Lots of changes:
961 - Format change: /Type/TypeParameters/TypeParameter doesn't store the type
962 parameter name as it's value (e.g. <TypeParameter>A</TypeParameter>),
963 but instead stores the name as an attribute (e.g.
964 <TypeParameter Name="A" />). This was done as Generic Arguments can
965 contain both constraints and attributes which were previously
967 - Record constraints under a //TypeParameter/Constraints element, and
968 attributes under a //TypeParameter/Attributes element.
969 - Generic arguments for methods are now recorded in a
970 /Type/Members/Member/TypeParameters element, with the same schema as
971 type-level arguments.
972 - Properly insert the [return:...] attributes on delegates.
973 - Modify CSharpFullMemberFormatter to generate generic argument
974 constraints on type and member signatures.
975 - Note: attributes are currently not inserted due to n#322399.
976 * stylesheet.xsl: Properly escape generic type names so that all anchors
977 are modeled after ECMA-334 CREFs, e.g. T:Foo.Bar`1, not T:Foo.Bar<T>.
978 * DocTest/en.expected/index.xml,
979 DocTest/en.expected/Mono.DocTest/UseLists.xml,
980 DocTest/en.expected/Mono.DocTest/Widget.xml,
981 DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
982 DocTest/en.expected/Mono.DocTest.Generic/Func`2.xml,
983 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
984 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
985 DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
986 DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
987 DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
988 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
989 DocTest/en.expected/System/Action`1.xml,
990 DocTest/en.expected/System/Array.xml,
991 DocTest/en.expected.since/index.xml,
992 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
993 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
994 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
995 DocTest/en.expected.since/Mono.DocTest.Generic/Func`2.xml,
996 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
997 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
998 DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
999 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
1000 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1001 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1002 DocTest/en.expected.since/System/Action`1.xml,
1003 DocTest/en.expected.since/System/Array.xml,
1004 DocTest/en.expected.importecmadoc/System/Action`1.xml,
1005 DocTest/en.expected.importecmadoc/System/Array.xml,
1006 DocTest/en.expected.importslashdoc/System/Array.xml,
1007 DocTest/en.expected.importslashdoc/System/Action`1.xml,
1008 DocTest/en.expected.importslashdoc/index.xml,
1009 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
1010 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1011 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
1012 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
1013 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
1014 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/Func`2.xml,
1015 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1016 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
1017 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
1018 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
1019 DocTest/html.expected/index.html,
1020 DocTest/html.expected/Mono.DocTest/Widget.html,
1021 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
1022 DocTest/html.expected/Mono.DocTest/UseLists.html,
1023 DocTest/html.expected/Mono.DocTest.Generic/index.html,
1024 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
1025 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.html,
1026 DocTest/html.expected/Mono.DocTest.Generic/Func`2.html,
1027 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
1028 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
1029 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
1030 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1031 DocTest/html.expected/System/Action`1.html,
1032 DocTest/html.expected/System/Array.html: Flush.
1034 2008-04-04 Jonathan Pryor <jpryor@novell.com>
1036 * DocTest-v1.cs: Add nested generic type for testing.
1037 * DocTest/en.expected/index.xml,
1038 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
1039 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
1040 DocTest/en.expected.importslashdoc/index.xml,
1041 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
1042 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
1043 DocTest/en.expected.since/index.xml,
1044 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.xml,
1045 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
1046 DocTest/html.expected/index.html,
1047 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1+FooEventArgs.html,
1048 DocTest/html.expected/Mono.DocTest.Generic/index.html,
1049 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html: Flush.
1051 2008-03-31 Jonathan Pryor <jpryor@novell.com>
1053 * DocTest-v1.cs: Add a member returning an IEnumerator<int[]> to test n375291.
1054 * DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
1055 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
1056 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
1057 DocTest/html.expected/Mono.DocTest/Widget.html,
1058 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html: Flush.
1060 2008-03-26 Jonathan Pryor <jpryor@novell.com>
1062 * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush due to
1063 ../engine/mdoc-html-utils.xsl changes with migration of explicitly
1064 implemented interface members to a separate section.
1066 2008-03-26 Jonathan Pryor <jpryor@novell.com>
1068 * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1069 DocTest/html.expected/Mono.DocTest/UseLists.html: Flush due to
1070 ../engine/mdoc-html-utils.xsl changes with s/System.Collections.Generic//.
1073 2008-03-26 Jonathan Pryor <jpryor@novell.com>
1075 * Makefile.am: Import docs for System.Action<T>.
1076 * DocTest-v1.cs: Add System.Action<T> to test generic type importing.
1077 * monodocer.cs: Misc. fixes:
1078 - Properly lookup generic types when importing ECMA docs, so that e.g.
1079 System.Collections.Generic.List<T> docs can be imported.
1080 - Fix member duplicate checking so that we don't get an exception due to
1081 seenmembers.Add(sig, "") for duplicate sigs.
1082 - Fix UpdateParameters() to handle updating <param/> nodes on delegates.
1083 * TestEcmaDocs.xml: Add docs for System.Action<T>.
1084 * DocTest/en.expected/index.xml, DocTest/en.expected/System/Action`1.xml,
1085 DocTest/en.expected.importecmadoc/System/Action`1.xml,
1086 DocTest/en.expected.importslashdoc/index.xml,
1087 DocTest/en.expected.importslashdoc/System/Action`1.xml,
1088 DocTest/en.expected.since/index.xml,
1089 DocTest/en.expected.since/System/Action`1.xml,
1090 DocTest/html.expected/index.html, DocTest/html.expected/System/index.html,
1091 DocTest/html.expected/System/Action`1.html: Flush.
1093 2008-03-25 Jonathan Pryor <jpryor@novell.com>
1095 * stylesheet.xsl: Implement CreateEditLink() for mdoc-html-utils.xsl.
1097 2008-03-24 Jonathan Pryor <jpryor@novell.com>
1099 * stylesheet.xsl: Implement CreateExpandedToggle() for
1100 mdoc-sections-css.xsl.
1102 2008-03-24 Jonathan Pryor <jpryor@novell.com>
1104 * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush due to
1105 changes in ID string generation in ../engine/mdoc-html-utils.xsl.
1107 2008-03-17 Jonathan Pryor <jpryor@novell.com>
1109 * monodocer.cs: Modify index.xml so that there's a //Type/@Kind attribute.
1110 This allows mkestner's doc engine to display the tree view (e.g. "Foo
1111 Class") w/o loading the underlying Foo.xml file, improving start time.
1112 * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
1113 DocTest/en.expected.importslashdoc/index.xml: Flush.
1115 2008-03-15 Jonathan Pryor <jpryor@novell.com>
1117 * monodocs2html.cs: Fix DumpTemplate() -- sending the output through an
1118 intermediate XmlDocument seems to "corrupt" the file, such that any user
1119 of the dumped file will get errors such as "Could not resolve named
1120 template create-default-style."
1122 2008-03-15 Jonathan Pryor <jpryor@novell.com>
1124 * defaulttemplate.xsl: Cleanup (add/remove CSS properties, etc.).
1125 * Makefile.am: monodocs2html needs to pull in resources from ../engine.
1126 * monodocs2html.cs: Use ManifestResourceResolver so that .xsl files embedded
1127 within the monodocs2html.exe assembly can refer to each other; use
1128 XhtmlWriter so that certain XHTML elements are "closed", e.g. <br/>
1129 instead of <br></br>.
1130 * XhtmlWriter.cs: Added; XmlWriter subclass which generates nicer XHTML.
1131 * stylesheet.xsl: *Major* refactor to share XSLT code with ../engine.
1132 * DocTest/html.expected/index.html, DocTest/html.expected/NoNamespace.html,
1133 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
1134 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
1135 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
1136 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1137 DocTest/html.expected/Mono.DocTest.Generic/index.html,
1138 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
1139 DocTest/html.expected/Mono.DocTest/Color.html,
1140 DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
1141 DocTest/html.expected/Mono.DocTest/Widget.html,
1142 DocTest/html.expected/Mono.DocTest/Widget+Del.html,
1143 DocTest/html.expected/Mono.DocTest/DocValueType.html,
1144 DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
1145 DocTest/html.expected/Mono.DocTest/IProcess.html,
1146 DocTest/html.expected/Mono.DocTest/index.html,
1147 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
1148 DocTest/html.expected/Mono.DocTest/DocAttribute.html,
1149 DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
1150 DocTest/html.expected/Mono.DocTest/UseLists.html,
1151 DocTest/html.expected/System/Environment+SpecialFolder.html,
1152 DocTest/html.expected/System/Array.html,
1153 DocTest/html.expected/System/Environment.html,
1154 DocTest/html.expected/System/index.html,
1155 DocTest/html.expected/System/AsyncCallback.html: Flush.
1157 2008-03-07 Jonathan Pryor <jpryor@novell.com>
1159 * mdoc.cs: Rename export-slashdoc command to export-msxdoc. Add a space
1160 between the `usage:' and command description to ease reading.
1162 2008-03-07 Jonathan Pryor <jpryor@novell.com>
1164 * monodocs2slashdoc.cs: Update to cope with .NET 2.0 generics.
1165 * DocTest-v1.cs: Fix CREF comments.
1166 * DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
1167 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1168 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
1169 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html: Flush
1170 due to above CREF changes.
1172 2008-03-06 Joshua Tauberer <jit@occams.info>
1174 * monodocer.cs: Use Path.Combine in a few places.
1176 2008-03-03 Jonathan Pryor <jpryor@novell.com>
1178 * Makefile.am: Test the new -import: monodocer option.
1179 * mdoc.cs: Make --import take only one parameter, the file to import.
1180 * monodocer.cs: Add a new -import option which auto-detects the XML format
1181 so that mdoc (and the user) doesn't need to care about file formats.
1182 * Options.cs: Flush (fixes "<>" error when parsing 2-value "i|import").
1184 2008-02-29 Jonathan Pryor <jpryor@novell.com>
1186 * Makefile.am: Use mcs1 to build monodocer1.exe (as mcs now targets the 2.0
1187 profile by default).
1189 2008-02-29 Jonathan Pryor <jpryor@novell.com>
1191 * Makefile.am: Corrections to pass distcheck.
1193 2008-02-27 Jonathan Pryor <jpryor@novell.com>
1195 * mdoc.cs: `mdoc assemble` should default to the "ecma" format, as that's
1196 what most of the other mdoc tools produce & consume.
1198 2008-02-26 Jonathan Pryor <jpryor@novell.com>
1200 * mdoc.cs: Allow multiple formats to be specified on the `mdoc assemble`
1201 command line; directories use the last specified format. This allows more
1202 than one format to be specified at once, e.g.
1203 `mdoc assemble -o foo --format=ecma A B --format=error C D`.
1204 * Options.cs: Update to permit the above "argument run" parsing behavior.
1206 2008-02-24 Jonathan Pryor <jpryor@novell.com>
1208 * mdoc.cs: Remove array index out of bound exception in ExportHtml; remove
1210 * defaulttemplate.xsl: s/<tab>/ /; add create-default-collection-title,
1211 create-default-title, create-default-summary, create-default-signature,
1212 create-default-remarks, create-default-members named templates (for use by
1213 importing XSLT files).
1214 * DocTest/html.expected/**/*.html: Flush (whitespace changes).
1216 2008-02-21 Jonathan Pryor <jpryor@novell.com>
1218 * Makefile.am: Add mdoc.exe to the build.
1219 * monodocer.cs: Place into the Mono.Documentation namespace;
1220 rename Stub to Updater.
1221 * monodocs2slashdoc.cs: Place into the Mono.Documentation namespace; allow
1222 it to convert multiple directories.
1223 * mdoc.cs: Added; a unifying front-end to the various monodoc-related
1224 utilities such as monodocer, monodocs2html, mdassembler, etc.
1225 * Options.cs: An option parser; DO NOT EDIT; instead, see NDesk.Options at
1226 http://www.ndesk.org/Options.
1228 2008-02-19 Jonathan Pryor <jpryor@novell.com>
1230 * defaulttemplate.xsl: Insert id attributes so that an "index" can be added;
1231 Add a small "index" to the top of the page to simplify navigation --
1232 useful when there are lots of docs that make the "Members" section
1233 difficult to otherwise find. Add a http-equiv Content-Type, so that the
1234 charset is set to UTF-8.
1235 * stylesheet.xsl: Don't use generate-id(), as the result includes the full
1236 path of the input file, which breaks unit tests if run on a different
1237 machine (and everyone runs the unit tests, right?). Add id attributes so
1238 that defaulttemplate.xsl can create an index.
1239 * DocTest/html.expected/System/Environment+SpecialFolder.html,
1240 DocTest/html.expected/System/Array.html,
1241 DocTest/html.expected/System/Environment.html,
1242 DocTest/html.expected/System/index.html,
1243 DocTest/html.expected/System/AsyncCallback.html,
1244 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
1245 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
1246 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
1247 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1248 DocTest/html.expected/Mono.DocTest.Generic/index.html,
1249 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
1250 DocTest/html.expected/index.html,
1251 DocTest/html.expected/Mono.DocTest/Color.html,
1252 DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
1253 DocTest/html.expected/Mono.DocTest/Widget.html,
1254 DocTest/html.expected/Mono.DocTest/Widget+Del.html,
1255 DocTest/html.expected/Mono.DocTest/DocValueType.html,
1256 DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
1257 DocTest/html.expected/Mono.DocTest/IProcess.html,
1258 DocTest/html.expected/Mono.DocTest/index.html,
1259 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
1260 DocTest/html.expected/Mono.DocTest/DocAttribute.html,
1261 DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
1262 DocTest/html.expected/Mono.DocTest/UseLists.html,
1263 DocTest/html.expected/NoNamespace.html: Flush.
1265 2008-02-15 Jonathan Pryor <jpryor@novell.com>
1267 * defaulttemplate.xsl: Move the <style/> and (new) <script/> into named
1268 templates so that this file can be <xsl:import/>d and the named templates
1269 invoked without clobbering the importing document; add toggle_display()
1270 JavaScript function for some bling. Modify CSS so things look nicer.
1271 * stylesheet.xsl: Make monodocs2html output not suck (as badly):
1272 - Allow *all* headers to also act as show/hide toggles, so that e.g.
1273 Remarks, Examples, Parameters, etc. can be hidden.
1274 - Move the summary information above the member prototype (consistent
1275 with MSDN, and I think it looks nicer).
1276 - Provide an `id' attribute for enumeration members, so that
1277 <see cref="F:..." /> will work reasonably.
1278 - Allow the <pre/> blocks to use the `prettyprint.js' file (used by
1279 monologue for syntax coloring) -- requires setting the <pre/> class to
1280 e.g. code-csharp for C# coloring.
1281 * DocTest/html.expected/System/Environment+SpecialFolder.html,
1282 DocTest/html.expected/System/Array.html,
1283 DocTest/html.expected/System/Environment.html,
1284 DocTest/html.expected/System/index.html,
1285 DocTest/html.expected/System/AsyncCallback.html,
1286 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
1287 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
1288 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
1289 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1290 DocTest/html.expected/Mono.DocTest.Generic/index.html,
1291 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
1292 DocTest/html.expected/index.html,
1293 DocTest/html.expected/Mono.DocTest/Color.html,
1294 DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
1295 DocTest/html.expected/Mono.DocTest/Widget.html,
1296 DocTest/html.expected/Mono.DocTest/Widget+Del.html,
1297 DocTest/html.expected/Mono.DocTest/DocValueType.html,
1298 DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
1299 DocTest/html.expected/Mono.DocTest/IProcess.html,
1300 DocTest/html.expected/Mono.DocTest/index.html,
1301 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
1302 DocTest/html.expected/Mono.DocTest/DocAttribute.html,
1303 DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
1304 DocTest/html.expected/Mono.DocTest/UseLists.html,
1305 DocTest/html.expected/NoNamespace.html: Flush (lots of HTML changes due to
1306 defaulttemplate.xsl and stylesheet.xsl changes).
1308 2008-02-14 Jonathan Pryor <jpryor@novell.com>
1310 * stylesheet.xsl: Support <typeparamref/>.
1312 2008-02-13 Jonathan Pryor <jpryor@novell.com>
1314 * DocTest-v1.cs: Add/fix doc comments; add a
1315 Widget(Converter<string,string>) constructor for testing.
1316 * stylesheet.xsl: Fix display issues:
1317 - Generic types should have GetTypeDisplayName() on their constituent
1318 parts, so System.Converter<System.String,System.String>
1319 gets converted into the nicer Converter<string, string>.
1320 - Generic types within method argument lists should be supported.
1321 - Permit constructor references to contain arguments, so that
1322 "C:My.Full.Type(Type1,Type2)" actually works.
1323 - Fix remote type references so
1324 <see cref="M:System.Collections.Generic.List{System.Int32}.Remove(`0)"/>
1325 properly reference the remote uri
1326 System.Collections.Generic.List`1.Remove(`0).
1327 * DocTest/en.expected/Mono.DocTest/Widget.xml,
1328 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
1329 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
1330 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
1331 DocTest/html.expected/System/Array.html,
1332 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
1333 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1334 DocTest/html.expected/Mono.DocTest/Widget.html,
1335 DocTest/html.expected/Mono.DocTest/UseLists.html: Flush.
1337 2008-02-08 Jonathan Pryor <jpryor@novell.com>
1339 * stylesheet.xsl: Allow use of both <see cref="GenericType{A}" /> and
1340 <see cref="GenericType<A>" /> to be consistent wrt each other.
1341 - Canonicalize generic types within link targets so that {} is used, as
1342 1. this is what the */@id code generates, so such links will actually
1343 work (as opposed to <>-using links, which will fail), and
1344 2. the {} links are shorter and easier to read due to less markup.
1345 - Canonicalize generic types within link text to use <>, so e.g.
1346 <see cref="System.Action{`0}" /> is displayed as System.Action<`0>.
1347 This also allows output to be consistent, no matter what the see/@cref
1349 - When creating links to go-mono.com, ensure that generic type names are
1350 of the form Type`N, not Type{...}, as go-mono.com doesn't generate
1351 useful output for the latter form of URL.
1352 * DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Flush.
1354 2008-01-06 Jonathan Pryor <jpryor@novell.com>
1356 * monodocer.cs: Yet another "if you remove a node while traversing its
1357 containing list, you skip elements" bug (in this case, if you had extra
1358 <param/> elements for non-existant parameters, only the first extra
1359 <param/> was removed, and the others were skipped). Modify the messge
1360 displayed for undeletable <param/> nodes to provide more contextual
1363 2008-01-05 Jonathan Pryor <jpryor@novell.com>
1366 - Fix duplicate and removed member checking/handling, so that duplicate
1367 and removed members are properly warned about/removed (depending
1368 on MemberDocsHaveUserContent()).
1369 - Member sorting should take the return type into consideration, as I've
1370 seen some ../class/** members which change the return type between
1371 v1.0 and v2.0, causing the order of these members to "float" (as they
1372 previously had the same sort order).
1374 2008-01-03 Jonathan Pryor <jpryor@novell.com>
1376 * monodocer.cs: XmlNodeList doesn't appear to support removing nodes while
1377 you're traversing the list. (It doesn't complain, but it doesn't iterate
1378 over all the nodes either if you do so.) Don't do that.
1380 2008-01-02 Jonathan Pryor <jpryor@novell.com>
1382 * monodocer.cs: Don't generate files that contain characters that are
1383 invalid on Win32 platforms. These are frequently compiler-generated
1384 types, e.g. '<>c__CompilerGenerated2+<>c__CompilerGenerated13', but are
1385 occasionally public when they shouldn't be. Fix the
1386 UpdateAssemblyVersions() logic to return true IFF there are > 0
1387 <AssemblyVersion/> elements.
1389 2008-01-02 Jonathan Pryor <jpryor@novell.com>
1391 * DocTest-v1.cs: Add a type to the root namespace.
1392 * monodocer.cs: Permit types to exist in the root namespace. This is needed
1393 to properly document ../class/Npgsql, though I have no idea how `monodoc'
1394 will actually display these types...
1395 * overview.xsl: Support types within the root namespace.
1396 * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
1397 DocTest/en.expected.importslashdoc/index.xml,
1398 DocTest/html.expected/System/index.html,
1399 DocTest/html.expected/Mono.DocTest.Generic/index.html,
1400 DocTest/html.expected/index.html,
1401 DocTest/html.expected/Mono.DocTest/index.html: Flush.
1402 * DocTest/en.expected/NoNamespace.xml,
1403 DocTest/en.expected/ns-.xml,
1404 DocTest/en.expected.importslashdoc/NoNamespace.xml,
1405 DocTest/en.expected.importslashdoc/ns-.xml,
1406 DocTest/en.expected.since/NoNamespace.xml,
1407 DocTest/en.expected.since/ns-.xml,
1408 DocTest/html.expected/NoNamespace.html: Added.
1410 2008-01-02 Jonathan Pryor <jpryor@novell.com>
1413 - Write namespace files as 'ns-<Namespace>.xml', not '<Namespace>.xml', as
1414 the previous behavior would break monodoc checkout on Win32 (due to dir
1415 class/System.Security/en/System.Security.Cryptography.Xml vs. file
1416 class/System.Security/en/System.Security.Cryptography.xml).
1417 - This will rename existing <Namespace>.xml to ns-<Namespace>.xml
1419 - gmcs/mcs changed Reflection names (again); cope.
1420 * DocTest/en.expected/System.xml,
1421 DocTest/en.expected/Mono.DocTest.Generic.xml,
1422 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
1423 DocTest/en.expected/Mono.DocTest.xml, DocTest/en.expected.since/System.xml,
1424 DocTest/en.expected.since/Mono.DocTest.Generic.xml,
1425 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1426 DocTest/en.expected.since/Mono.DocTest.xml,
1427 DocTest/en.expected.importslashdoc/System.xml,
1428 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic.xml,
1429 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1430 DocTest/en.expected.importslashdoc/Mono.DocTest.xml: Rename to have a
1432 * Makefile.am: Remove obsolete targets; add -show_exceptions to tests so we
1433 get more information on errors.
1434 * overview.xsl: Use the 'ns-' prefixed namespace documentation files.
1436 2007-12-19 Jonathan Pryor <jpryor@novell.com>
1438 * monodocer.cs: PropertyInfo.GetValue() may throw (in particular, within
1439 System.Data when trying to read ToolboxItemAttribute which references an
1440 assembly not present within the GAC). Workaround this.
1442 2007-12-19 Jonathan Pryor <jpryor@novell.com>
1444 * monodocer.cs: Add a -show_exceptions argument to provide full stack traces
1445 when an error occurs (helps with debugging). Allow VersionComparer to
1446 work on "slightly" malformed Version strings like 1.0.x.x, which some
1447 existing documentation uses.
1449 2007-12-18 Jonathan Pryor <jpryor@novell.com>
1451 * monodocer.cs: Don't append ';' to property declarations.
1452 * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
1453 DocTest/en.expected/Mono.DocTest/Widget.xml,
1454 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1455 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
1456 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1457 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
1459 2007-12-18 Jonathan Pryor <jpryor@novell.com>
1461 * monodocer.cs: Insert [return:] custom attributes within <ReturnValue/>.
1462 * DocTest-v1.cs: Add custom attributes to various members for testing.
1463 * DocTest/en.expected/Mono.DocTest/Widget.xml,
1464 DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
1465 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
1466 DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
1467 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
1468 DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
1469 DocTest/html.expected/Mono.DocTest/Widget.html,
1470 DocTest/html.expected/Mono.DocTest/DocAttribute.html: Flush.
1472 2007-12-17 Jonathan Pryor <jpryor@novell.com>
1474 * monodocer.cs: Document protected events.
1475 * DocTest-v1.cs: Change the visibility of various members so we can better
1476 test the monodocs2html output.
1477 * stylesheet.xsl: Fix the `protected' check so that public members aren't
1478 displayed under the Protected [MemberType] section.
1479 * DocTest/en.expected/Mono.DocTest/Widget.xml,
1480 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
1481 DocTest/html.expected/Mono.DocTest/Widget.html,
1482 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
1484 2007-12-13 Jonathan Pryor <jonpryor@vt.edu>
1486 * monodocer.cs: Er, *really* sort the <AssemblyVersion/> entries.
1488 2007-12-12 Jonathan Pryor <jonpryor@vt.edu>
1490 * monodocer.cs: Sort the <AssemblyVersion/> entries so that when rendering
1491 them within monodoc we show versions in increasing order.
1493 2007-12-11 Jonathan Pryor <jonpryor@vt.edu>
1495 * monodocer.cs: Don't use File.OpenWrite(), as that doesn't truncate the
1496 file (resulting in invalid XML errors if the new file is smaller than the
1497 previous file). Add a local OpenWrite() to ensure that UTF8 is used
1500 2007-12-11 Jonathan Pryor <jonpryor@vt.edu>
1502 * monodocer.cs: Generate a per-member <AssemblyInfo/> element, not an
1503 <AssemblyVersions/> element. This makes it easeier to write the XSLT
1504 used in the docbrowser to generate the Requirements section.
1505 * stylesheet.xsl: Use <AssemblyInfo/>, not <AssemblyVersions/>.
1506 * DocTest/en.expected/System/Environment.xml,
1507 DocTest/en.expected/System/AsyncCallback.xml,
1508 DocTest/en.expected/System/Environment+SpecialFolder.xml,
1509 DocTest/en.expected/System/Array.xml,
1510 DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
1511 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
1512 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
1513 DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
1514 DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1515 DocTest/en.expected/Mono.DocTest/Widget.xml,
1516 DocTest/en.expected/Mono.DocTest/Widget+Del.xml,
1517 DocTest/en.expected/Mono.DocTest/DocValueType.xml,
1518 DocTest/en.expected/Mono.DocTest/IProcess.xml,
1519 DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
1520 DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
1521 DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
1522 DocTest/en.expected/Mono.DocTest/UseLists.xml,
1523 DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
1524 DocTest/en.expected/Mono.DocTest/Color.xml,
1525 DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
1526 DocTest/en.expected.since/System/Environment.xml,
1527 DocTest/en.expected.since/System/AsyncCallback.xml,
1528 DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
1529 DocTest/en.expected.since/System/Array.xml,
1530 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
1531 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1532 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
1533 DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
1534 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1535 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
1536 DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
1537 DocTest/en.expected.since/Mono.DocTest/Widget+Del.xml,
1538 DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
1539 DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
1540 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
1541 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
1542 DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
1543 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
1544 DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
1545 DocTest/en.expected.since/Mono.DocTest/Color.xml,
1546 DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
1547 DocTest/en.expected.importecmadoc/System/Environment.xml,
1548 DocTest/en.expected.importecmadoc/System/AsyncCallback.xml,
1549 DocTest/en.expected.importecmadoc/System/Array.xml,
1550 DocTest/en.expected.importslashdoc/System/Environment.xml,
1551 DocTest/en.expected.importslashdoc/System/AsyncCallback.xml,
1552 DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
1553 DocTest/en.expected.importslashdoc/System/Array.xml,
1554 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
1555 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1556 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
1557 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
1558 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1559 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
1560 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
1561 DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
1562 DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
1563 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
1564 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
1565 DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
1566 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
1567 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
1568 DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
1569 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
1570 Flush; s/AssemblyVersion/AssemblyInfo/g.
1572 2007-12-10 Jonathan Pryor <jonpryor@vt.edu>
1574 * DocTest-v2.patch: Remove some members so that we can see some
1575 <AssemblyVersions/> differences in the XML output.
1576 * monodocer.cs: Add a <AssemblyVersions/> element under every type and member
1577 to better track versioning information. The XML documentation now becomes
1578 a "version database" of sorts, in which each member lists which assembly
1579 versions it exists in. This permits tracking which members were added or
1580 removed over time with greater fidelity than <since/>. This also removes
1581 the need for -ignore_extra_docs, which is maintained (for compatibility)
1583 * DocTest-v1.cs: Have differing visibility on a property to ensure it works
1585 * stylesheet.xsl: Print out the per-member <AssemblyVersions/> element.
1586 * DocTest/en.expected/System/Environment.xml,
1587 DocTest/en.expected/System/AsyncCallback.xml,
1588 DocTest/en.expected/System/Environment+SpecialFolder.xml,
1589 DocTest/en.expected/System/Array.xml,
1590 DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
1591 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
1592 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
1593 DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
1594 DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1595 DocTest/en.expected/Mono.DocTest/Widget.xml,
1596 DocTest/en.expected/Mono.DocTest/Widget+Del.xml,
1597 DocTest/en.expected/Mono.DocTest/DocValueType.xml,
1598 DocTest/en.expected/Mono.DocTest/IProcess.xml,
1599 DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
1600 DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
1601 DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
1602 DocTest/en.expected/Mono.DocTest/UseLists.xml,
1603 DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
1604 DocTest/en.expected/Mono.DocTest/Color.xml,
1605 DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
1606 DocTest/en.expected.since/System/Environment.xml,
1607 DocTest/en.expected.since/System/AsyncCallback.xml,
1608 DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
1609 DocTest/en.expected.since/System/Array.xml,
1610 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
1611 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1612 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
1613 DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
1614 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1615 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
1616 DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
1617 DocTest/en.expected.since/Mono.DocTest/Widget+Del.xml,
1618 DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
1619 DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
1620 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
1621 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
1622 DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
1623 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
1624 DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
1625 DocTest/en.expected.since/Mono.DocTest/Color.xml,
1626 DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
1627 DocTest/html.expected/System/Array.html,
1628 DocTest/html.expected/System/Environment.html,
1629 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
1630 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
1631 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
1632 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1633 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
1634 DocTest/html.expected/Mono.DocTest/Widget.html,
1635 DocTest/html.expected/Mono.DocTest/DocValueType.html,
1636 DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
1637 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
1638 DocTest/html.expected/Mono.DocTest/DocAttribute.html,
1639 DocTest/html.expected/Mono.DocTest/UseLists.html,
1640 DocTest/en.expected.importecmadoc/System/Environment.xml,
1641 DocTest/en.expected.importecmadoc/System/AsyncCallback.xml,
1642 DocTest/en.expected.importecmadoc/System/Array.xml,
1643 DocTest/en.expected.importslashdoc/System/Environment.xml,
1644 DocTest/en.expected.importslashdoc/System/AsyncCallback.xml,
1645 DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
1646 DocTest/en.expected.importslashdoc/System/Array.xml,
1647 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
1648 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1649 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
1650 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
1651 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1652 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
1653 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
1654 DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
1655 DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
1656 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
1657 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
1658 DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
1659 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
1660 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
1661 DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
1662 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
1663 Flush, inserting <AssemblyVersion/> elements as necessary.
1665 2007-10-28 Jonathan Pryor <jonpryor@vt.edu>
1667 * DocTest-v1.cs: Correct doc comment.
1668 * DocTest/html.expected/System/Environment.html,
1669 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html,
1670 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
1671 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1672 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
1673 DocTest/html.expected/Mono.DocTest/UseLists.html,
1674 DocTest/en.expected.importslashdoc/System/Environment.xml,
1675 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
1676 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1677 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
1678 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
1679 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml: mcs and gmcs
1680 got many bug fixes with /doc support, changing many things that depend on
1683 2007-09-27 Raja R Harinath <rharinath@novell.com>
1685 * Makefile.am (DocTest.dll-v1, DocTest.dll-v2): Pick source from $srcdir.
1687 2007-07-19 Jonathan Pryor <jonpryor@vt.edu>
1689 * monodocer.cs: Always fully consume <Docs/> children. If we have e.g.
1690 <Docs><param name="foo"><see cref="T:Bar"/></param></Docs>, but there is
1691 no existing parameter "foo", we would previously process the nested
1692 <see/> node and append it to the <Docs/> child nodes.
1694 2007-07-18 Jonathan Pryor <jonpryor@vt.edu>
1696 * monodocer.cs: Change OrderDocsNodes() so that it uses
1697 XmlNode.InsertAfter() instead of XmlNode.InsertBefore(). The result is
1698 mostly the same (i.e. no regression test changes), but if you have a
1699 non-ordered node between other nodes this will force the non-ordered node
1700 to the *end* of the <Docs/> children, not the start. For example, given
1701 the input <Docs><summary/><exception/><remarks/></Docs/>, we used to get
1702 <Docs><exception/><summary/><remarks/></Docs>, while we now get
1703 <Docs><summary/><remarks/><exception/></Docs>.
1705 2007-07-17 Jonathan Pryor <jonpryor@vt.edu>
1707 * monodocer.cs: Insert the type's <Docs/> node before <Members/>. This is
1708 consistent with ECMA documentation ordering, and makes more sense (when
1709 editing the file you can edit the Type documentation before member
1710 documentation, instead of after all members as was the case before).
1711 * DocTest/en.expected/System/Environment.xml,
1712 DocTest/en.expected/System/Environment+SpecialFolder.xml,
1713 DocTest/en.expected/System/Array.xml,
1714 DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
1715 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
1716 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
1717 DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
1718 DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1719 DocTest/en.expected/Mono.DocTest/Widget.xml,
1720 DocTest/en.expected/Mono.DocTest/DocValueType.xml,
1721 DocTest/en.expected/Mono.DocTest/IProcess.xml,
1722 DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
1723 DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
1724 DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
1725 DocTest/en.expected/Mono.DocTest/UseLists.xml,
1726 DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
1727 DocTest/en.expected/Mono.DocTest/Color.xml,
1728 DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
1729 DocTest/en.expected.since/System/Environment.xml,
1730 DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
1731 DocTest/en.expected.since/System/Array.xml,
1732 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
1733 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1734 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
1735 DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
1736 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1737 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
1738 DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
1739 DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
1740 DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
1741 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
1742 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
1743 DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
1744 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
1745 DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
1746 DocTest/en.expected.since/Mono.DocTest/Color.xml,
1747 DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
1748 DocTest/en.expected.importecmadoc/System/Environment.xml,
1749 DocTest/en.expected.importecmadoc/System/Array.xml,
1750 DocTest/en.expected.importslashdoc/System/Environment.xml,
1751 DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
1752 DocTest/en.expected.importslashdoc/System/Array.xml,
1753 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
1754 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1755 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
1756 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
1757 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
1758 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
1759 DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
1760 DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
1761 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
1762 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
1763 DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
1764 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
1765 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
1766 DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
1767 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
1768 Update so that <Docs/> comes before <Members/>, not after.
1770 2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
1772 * monodocer.cs: If a <Type/> had an empty <Members/> element, we'd start
1773 reading the <Member/> elements from the *next* <Type/>; oops.
1774 * DocTest-v1.cs: Add System.AsyncCallback, which is a delegate and thus had
1775 an empty <Members/> element.
1776 * Makefile.am: Also import docs for System.AsyncCallback.
1777 * overview.xsl: Update $max-types so that adding System.AsyncCallback
1778 doesn't trigger the alternate behavior, creating a larger diff than
1780 * TestEcmaDocs.xml: Add docs for System.AsyncCallback.
1781 * DocTest/en.expected/System/AsyncCallback.xml,
1782 DocTest/en.expected/index.xml,
1783 DocTest/en.expected.since/System/AsyncCallback.xml
1784 DocTest/en.expected.since/index.xml,
1785 DocTest/html.expected/System/AsyncCallback.html
1786 DocTest/html.expected/System/index.html, DocTest/html.expected/index.html,
1787 DocTest/en.expected.importecmadoc/System/AsyncCallback.xml,
1788 DocTest/en.expected.importslashdoc/System/AsyncCallback.xml,
1789 DocTest/en.expected.importslashdoc/index.xml: Added; expected imported
1790 documentation for System.AsyncCallback.
1792 2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
1794 * monodocer.cs: Remove the "While Importing ECMA <Docs/> chidren, found
1795 node..." error by ensuring that we're at the start of an actual
1796 non-whitespace element before hitting the switch statement.
1798 2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
1800 * monodocer.cs: Don't call DoUpdateType() with non-public types. This
1801 allows `monodocer -importecmadoc` to fully run and import mscorlib.dll.
1803 2007-07-14 Jonathan Pryor <jonpryor@vt.edu>
1805 * monodocer.cs: Ensure that getting a MemberInfo based on the documentation
1806 that the MemberInfo was actually found... (Allows a full mscorlib.dll
1807 import to run for > 15s before dying.)
1809 2007-07-04 Jonathan Pryor <jonpryor@vt.edu>
1811 * monodocer.cs: Use XmlReader instead of XPathDocument to process the ECMA
1812 documentation import. This cuts down a -type:System.Array import from
1813 ~10-12s to ~7-8s (not great, but better). "Fix" the ordering of <Docs/>
1814 child elements so that importing ECMA/slashdoc documentation doesn't
1815 change the normal ordering.
1816 * DocTest/en.expected.importecmadoc/System/Array.xml,
1817 DocTest/en.expected.importecmadoc/System/Environment.xml: Alter order of
1818 <Docs/> elements to match the normally generated order.
1820 2007-06-20 Jonathan Pryor <jonpryor@vt.edu>
1822 * monodocer.cs: Sort /Type/Members/Member elements so that the order is not
1823 dependent upon Reflection order.
1824 * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
1825 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1826 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
1827 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1828 DocTest/en.expected.importecmadoc/System/Array.xml,
1829 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml:
1830 Flush (sort <Member/> elements).
1832 2007-06-19 Jonathan Pryor <jonpryor@vt.edu>
1834 * monodocer.cs: Sort <Namespace/> and <Type/> elements by their Name
1835 attribute. This helps keep diff's smaller, as the generated order won't
1836 be dependent upon Reflection order.
1837 * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
1838 DocTest/en.expected.importslashdoc/index.xml: Flush (sort namespaces and
1839 types alphabetically).
1841 2007-06-19 Jonathan Pryor <jonpryor@vt.edu>
1843 * monodocer.cs: Cleanup Console output.
1844 - Use Console.Error for error messages, not status messages.
1845 - Error should be prefixed by "monodocer" (follows Unix conventions).
1846 - Don't print "Updating..." followed by "New Type..." for the same type.
1847 - Use __monodocer-seen__ sentinal for imported nodes so that we don't try
1848 to lookup the corresponding member later in GetDocumentationMembers().
1850 2007-06-19 Jonathan Pryor <jonpryor@vt.edu>
1852 * monodocer.cs: Lots 'o fixes/improvements.
1853 - Allow multiple -type parameters to be specified.
1854 - Remove type member enumeration from UpdateTypes() -- use DoUpdateType2().
1855 - Iterate over assembly types in Ecma Documentation order (so that we read
1856 the Ecma docs sequentially, not randomly).
1857 - Allow -type to *create* new documentation files.
1858 - Remove unused methods.
1859 * Makefile.am: Add check-monodocer-importecmadoc,
1860 check-monodocer-importecmadoc-update targets (unit tests for
1862 * TestEcmaDocs.xml: Added; ECMA Documentation input file for use with
1863 -importecmadoc tests.
1864 * DocTest-v1.cs: Add System.Array to help test -importecmadoc behavior.
1865 * DocTest/en.expected/index.xml, DocTest/en.expected.since/index.xml,
1866 DocTest/html.expected/System/index.html, DocTest/html.expected/index.html,
1867 DocTest/en.expected.importslashdoc/index.xml: Flush (add System.Array to
1869 * DocTest/en.expected/System/Array.xml,
1870 DocTest/en.expected.since/System/Array.xml,
1871 DocTest/html.expected/System/Array.html,
1872 DocTest/en.expected.importecmadoc/System/Environment.xml,
1873 DocTest/en.expected.importecmadoc/System/Array.xml,
1874 DocTest/en.expected.importslashdoc/System/Array.xml: Added; expected
1875 output for System.Array type for various tests.
1877 2007-06-18 Wade Berrier <wberrier@novell.com>
1879 * monodocer.cs: Move assembly information up top because having it at the bottom
1880 fails to compile with mcs from trunk.
1882 2007-06-14 Jonathan Pryor <jonpryor@vt.edu>
1884 * monodocer.cs: Use XPathDocument instead of XmlDocument to process the ECMA
1885 documentation import. This cuts down a -type:System.Array import from
1886 ~15-20s to ~10-12s (not great, bug better). Fix importing of <exception/>
1887 elements -- previously we would skip them if the mono docs lacked them.
1889 2007-06-12 Jonathan Pryor <jonpryor@vt.edu>
1891 * monodocer.cs: The previous fix was buggy -- if the type parameters were
1892 renamed (ConvertAll<T,U> in ECMA, ConvertAll<TInput,TOutput> in Mono),
1893 then the existing element wouldn't be found, but the MemberInfo would.
1894 Result: duplicate XML elements (BOTH ConvertAll<T,U> AND
1895 ConvertAll<TInput,TOutput>), one of which is wrong, which clearly isn't
1896 desirable. If the Mono XML element can't be found, try looking it up
1897 based on the MemberInfo found from the ECMA docs to avoid duplication.
1899 2007-06-11 Jonathan Pryor <jonpryor@vt.edu>
1901 * monodocer.cs: Add support for renaming of template parameters (useful
1902 because ECMA 335 refers to Array.ConvertAll<T,U> while Mono/.NET have
1903 Array.ConvertAll<TInput,TOutput>). Not terribly intelligent, but smart
1904 enough that all but two System.Array members can now be imported (a
1905 private constructor, and a member with an incorrectly documented parameter
1906 type, neither of which I plan on supporting). Cleanup some of the
1907 `#if NET_1_0` blocks by using `using' aliases -- alas, requires moving the
1908 [assembly:...] attributes; see bugzilla #81855.
1910 2007-06-11 Jonathan Pryor <jonpryor@vt.edu>
1912 * monodocer.cs: Add support for explicity-implemented interface members.
1913 Minor cleanup. Replace catch(NotSupportedException){} blocks.
1914 * Makefile.am (clean): Cleanup monodocer.exe* files.
1915 * DocTest-v1.cs: Add IFoo<T>, explicitly implement some interfaces on
1916 MyList<A,B> to test explicitly-implemented member support.
1917 * DocTest/en.expected/index.xml,
1918 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
1919 DocTest/en.expected.since/index.xml,
1920 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
1921 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
1922 DocTest/html.expected/Mono.DocTest.Generic/index.html,
1923 DocTest/html.expected/index.html,
1924 DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
1925 DocTest/en.expected.importslashdoc/index.xml,
1926 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
1927 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml:
1929 * DocTest/en.expected/Mono.DocTest.Generic/IFoo`1.xml,
1930 DocTest/en.expected.since/Mono.DocTest.Generic/IFoo`1.xml,
1931 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/IFoo`1.xml,
1932 DocTest/html.expected/Mono.DocTest.Generic/IFoo`1.html: Added.
1934 2007-05-29 Jonathan Pryor <jonpryor@vt.edu>
1936 * monodocer.cs: Invert ECMA documentation importing -- instead of iterating
1937 over the monodoc XML and importing ECMA docs as encountered (randomly),
1938 iterate over the ECMA docs in-order and access the monodoc types randomly.
1939 This significantly improves access as the ECMA docs are ~7.2MB in size,
1940 while the monodoc XML types 10's-100's of KB (randomly accessing a 7.2 MB
1941 XML document == BAD; randomly accessing a several hundred KB document is
1942 better). This cuts down a -type:System.Array import from ~4 minutes to
1943 < ~20s. Alas, it appears to miss a few members as well, so it's not done.
1945 2007-05-19 Jonathan Pryor <jonpryor@vt.edu>
1947 * monodocer.cs: Create diff(1)-friendly output for -importecmadocs.
1948 Previously, we'd remove <summary/>, <remarks/>, etc., and re-add them at
1949 the end of the <Docs/> node, which results in major changes for diff(1),
1950 so instead we replace the contents of existing elements when appropriate.
1951 Remove '\r' from the imported document (also to remove diff(1)-reported
1952 changes as the line endings would change).
1954 2007-05-17 Jonathan Pryor <jonpryor@vt.edu>
1956 * monodocer.cs: Add -importecmadoc flag, which will import
1957 documentation found within an ECMA documetation file (e.g. the
1958 CLILibraryTypes.xml from the ECMA-335 standard).
1959 WARNING: import is currently SLOW.
1961 2007-05-17 Jonathan Pryor <jonpryor@vt.edu>
1963 * monodocer.cs: Refactor MakeDocNode() so that there's only one
1964 version, not three overloads, and use a (new) DocsNodeInfo type to
1965 pass information to the new MakeDocNode() method. This doesn't
1966 change anything per-se, but it'll make it easier to pass new
1967 parameters to MakeDocNode() without making the rediculously long
1968 parameter list even longer...
1970 2007-05-12 Joshua Tauberer <jit@occams.info>
1972 * overview.xsl: Always sort type names, since when updating
1973 docs monodocer can make the list in index.xml out of order.
1974 * monodocer.cs: When deleting duplicate member entries, delay
1975 deletion until after loop is finished.
1976 * Makefile.am, DocTest-v1.cs, DocTest/en.expected.importslashdoc,
1977 DocTest/html.expected: Revise monodocs2html tests to use
1978 the /doc file so we can test those tags too. And changed two
1979 <c> tags to <see cref=/>.
1980 * stylesheet.xsl, DocTest/html.expected: Fix see-links to methods,
1981 which didn't recognize '(' as delimiting type from args, and
1982 display nice type names for arguments.
1984 2007-03-15 Lluis Sanchez Gual <lluis@novell.com>
1986 * monodocer.cs: When deleting a member, don't remove it from the
1987 parent xml element until all members are checked, since doing
1989 Properly import internal protected members.
1991 2006-12-29 Jonathan Pryor <jonpryor@vt.edu>
1993 * Makefile.am: Add check-monodocer-ignore_extra_docs-update,
1994 check-doc-tools-update, and check-update targets.
1995 * monodocer.cs: Fix generation of attribute parameters, as e.g.
1996 `AttributeUsage.Class|Struct' doesn't look right; it should
1997 instead be `AttributeUsage.Class | AttributeUsage.Struct'.
1998 * DocTest-v1.cs: Add new public Attribute with an AttributeUsage for tests.
1999 * DocTest/en.expected/index.xml,
2000 DocTest/en.expected/Mono.DocTest/DocAttribute.xml,
2001 DocTest/en.expected.importslashdoc/index.xml,
2002 DocTest/en.expected.importslashdoc/Mono.DocTest/DocAttribute.xml,
2003 DocTest/en.expected.since/index.xml,
2004 DocTest/en.expected.since/Mono.DocTest/DocAttribute.xml,
2005 DocTest/html.expected/index.html,
2006 DocTest/html.expected/Mono.DocTest/index.html,
2007 DocTest/html.expected/Mono.DocTest/DocAttribute.html: Added; update
2008 expected output for new tests.
2010 2006-12-29 Jonathan Pryor <jonpryor@vt.edu>
2012 * monodocer.cs: Fix C# type name generation for nested types in the System
2013 namespace. Remove TypeCastException when dealing with custom attributes.
2014 * DocTest-v1.cs: Add System.Environment type for testing System handling.
2015 * DocTest/en.expected/index.xml, DocTest/en.expected/System.xml,
2016 DocTest/en.expected/System/Environment.xml,
2017 DocTest/en.expected/System/Environment+SpecialFolder.xml,
2018 DocTest/en.expected.since/index.xml, DocTest/en.expected.since/System.xml,
2019 DocTest/en.expected.since/System/Environment+SpecialFolder.xml,
2020 DocTest/en.expected.since/System/Environment.xml,
2021 DocTest/en.expected.importslashdoc/index.xml,
2022 DocTest/en.expected.importslashdoc/System.xml,
2023 DocTest/en.expected.importslashdoc/System/Environment.xml,
2024 DocTest/en.expected.importslashdoc/System/Environment+SpecialFolder.xml,
2025 DocTest/html.expected/index.html, DocTest/html.expected/System/index.html,
2026 DocTest/html.expected/System/Environment.html,
2027 DocTest/html.expected/System/Environment+SpecialFolder.html:
2028 Added; update expected output for new tests.
2030 2006-12-29 Jonathan Pryor <jonpryor@vt.edu>
2032 * monodocer.cs: `abstract sealed' classes are actually `static' classes.
2034 2006-12-27 Jonathan Pryor <jonpryor@vt.edu>
2036 * monodocer.cs: Re-order the attributes in <Type/> elements so that the
2037 ordering is (somewhat) well defined. This helps with `diff' output in
2038 ../class, as it prevents "false positives" when the attributes are
2039 re-ordered. Fix CSharpFullMemberFormatter.GetTypeDeclaration() so that
2040 when handling C# builtin types (e.g. System.Byte) it uses the real name in
2041 the declaration instead of the C# keyword (`class byte' is wrong).
2043 2006-12-26 Jonathan Pryor <jonpryor@vt.edu>
2045 * Makefile.am: Add check-monodocer-ignore_extra_docs test.
2046 * monodocer.cs: Fix -ignore_extra_docs. Previously, it would just ignore
2047 "missing" types, but it would still remove "missing" members.
2049 2006-12-26 Jonathan Pryor <jonpryor@vt.edu>
2051 * monodocer.cs: Don't insert internal attributes into the documentation.
2052 * DocTest-v1.cs: Add test for use of an internal attribute.
2054 2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
2056 * monodocer.cs: Don't include full namespace for System.* types. *Do*
2057 include the full namespace for nested System types, e.g.
2058 System.Collections.IEnumerable. This is what is currently in
2059 ../class/corlib/en, and making this change results in a smaller diff.
2060 * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
2061 DocTest/en.expected/Mono.DocTest/UseLists.xml,
2062 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
2063 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
2064 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
2065 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml:
2066 Update unit tests for above monodocer.cs change.
2068 2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
2070 * monodocer.cs: Don't include full namespace for System.* types. This is
2071 what ECMA-335 CLILibraryTypes.xml does for C# declarations -- no
2072 namespaces within e.g. inheritance lists or parameter lists for the System
2073 namespace and namespaces nested within System.
2074 Remove unnecessary console output.
2075 * DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
2076 DocTest/en.expected/Mono.DocTest/UseLists.xml,
2077 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
2078 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
2079 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
2080 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml:
2081 Update unit tests for above monodocer.cs change.
2083 2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
2085 * monodocer.cs: Make sure that the types we document are *really* public.
2086 For some reason public nested types of internal types are returned by
2087 Assembly.GetTypes(), e.g. ``internal class A { public class B {} }''
2088 These types shouldn't be documented.
2089 * DocTest-v1.cs: Add test case for above.
2091 2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
2093 * monodocer.cs: Add -ignore_extra_docs flag; when set, it will not rename
2094 .xml files for types not found to .xml.remove. This is useful in ../class
2095 when we're processing assemblies multiple times for the 1.0 & 2.0
2096 profiles, as when processing the 1.0 profile we'll be "missing" the 2.0
2097 types, and we don't want those to be renamed.
2099 2006-12-21 Jonathan Pryor <jonpryor@vt.edu>
2101 * Makefile.am: Add a monodocer1.exe target, which is a version of monodocer
2102 which runs under the 1.0 runtime. This is necessary so that we can still
2103 generate/update docs for mscorlib.dll 1.0 (as only one mscorlib.dll can
2104 ever be loaded into a process).
2105 * monodocer.cs: Split out the .NET 2.0 functionality so that it can be built
2106 for both 1.0 and 2.0 runtimes. 1.0 support is controlled by the
2109 2006-12-20 Jonathan Pryor <jonpryor@vt.edu>
2111 * monodocer.cs: Don't try too hard in UpdateParameters(). Previously, if a
2112 the number of parameters a method accepted changed from > 1 to 1, the
2113 "easy" <param/> handling would (inadvertently?) change all <param/>s to have
2114 the @name of the method's single parameter -- so if you _had_ parameters
2115 A, B, and C but the method now only has D, then A, B, and C would all have
2116 their @name attribute changed to D. Odd, but possibly acceptable...
2117 ...until we try to make sure that the <param/>s are in the right order, in
2118 which case we'll record the index of D as 0 (it's the 1st parameter), but
2119 find a parameter with a different index (the old B & C), causing us to
2120 reinsert the parameter to make sure it's in the proper order. This
2121 results in an infinite loop within System.Xml -- see Bugzilla #80331.
2122 It's safer to just ignore the extra parameters.
2124 2006-12-07 Jonathan Pryor <jonpryor@vt.edu>
2126 * DocTest-v1.patch: Add an operator returning a generic parameter (triggers
2127 error fixed in monodocer.cs).
2128 * DocTest-v2.patch: Update (due to changes in DocTest-v1.cs).
2129 * monodocer.cs: CSharpFullMemberFormatter.AppendVisibility() needs to accept null
2130 MethodBases (when called from GetEventDeclaration() and e.GetAddMethod()
2131 returns null); fix SlashDocMemberFormatter.GetMethodDeclaration() so that
2132 generic types can be the return value of methods. These changes allow
2133 generation of documentation on Mono's 2.0 mscorlib.dll.
2134 * stylesheet.xsl: Use GetParameterType() to emit the return type of
2135 explicit/implicit operators, as they can be/use generic arguments.
2136 * DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
2137 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
2138 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
2139 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
2140 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html:
2141 Flush to match current output.
2143 2006-11-22 Jonathan Pryor <jonpryor@vt.edu>
2145 * monodocer.cs: Don't generate documentation/prototypes for non-public
2146 property get/set accessors. Patch from Ivan N. Zlatev.
2148 2006-11-01 Jonathan Pryor <jonpryor@vt.edu>
2150 * monodocer.cs: When importing -importslashdoc documentation, convert
2151 <seealso/> elements into <altmember/> elements (as the former is the
2152 recommended element within ECMA-334, while the latter is the actual
2153 element used for our ECMA documentation).
2154 * DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml: Flush.
2156 2006-10-27 Jonathan Pryor <jonpryor@vt.edu>
2158 * stylesheet.xsl: Generate more correct string id's for "id" attribute
2159 values, so that string ids match the output of CSC.EXE 2.0. Changes:
2160 append ``N instead of `N for generic methods, and use the correct 0-based
2161 type parameter index, not a 1-based index.
2162 * DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
2163 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
2164 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
2165 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
2166 DocTest/html.expected/Mono.DocTest/UseLists.html: Flush.
2168 2006-10-24 Jonathan Pryor <jonpryor@vt.edu>
2170 * DocTest-v1.cs: Add /doc comments (for use with `make
2171 check-monodocer-importslashdoc`).
2172 * DocTest-v2.patch: Update (due to changes in DocTest-v1.cs).
2173 * Makefile.am: Add check-monodocer-importslashdoc,
2174 check-monodocer-importslashdoc-update targets.
2175 * monodocer.cs: Fix -importslashdoc. Massively refactor generation of
2176 strings from MemberInfos (Type, MethodInfo, etc.) so that commonalities
2177 between DocType, C#, and /doc string IDs can be shared and easily
2178 customized (as opposed to dealing with the > 100 line FillDocTypeName()
2179 method, which was already too complex).
2180 * DocTest/en.expected.importslashdoc/index.xml,
2181 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic.xml,
2182 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml,
2183 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml,
2184 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/GenericBase`1.xml,
2185 DocTest/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
2186 DocTest/en.expected.importslashdoc/Mono.DocTest.xml,
2187 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget.xml,
2188 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Del.xml,
2189 DocTest/en.expected.importslashdoc/Mono.DocTest/DocValueType.xml,
2190 DocTest/en.expected.importslashdoc/Mono.DocTest/IProcess.xml,
2191 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass.xml,
2192 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+NestedClass`1.xml,
2193 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+IMenuItem.xml,
2194 DocTest/en.expected.importslashdoc/Mono.DocTest/UseLists.xml,
2195 DocTest/en.expected.importslashdoc/Mono.DocTest/Color.xml,
2196 DocTest/en.expected.importslashdoc/Mono.DocTest/Widget+Direction.xml:
2197 Added; expected output for `make check-monodocer-importslashdoc'.
2199 2006-10-19 Jonathan Pryor <jonpryor@vt.edu>
2201 * Makefile.am: Change check-monodocer target to add a `monodocer -namespace'
2202 check, as `-namespace' would use a bad filename generation algorithm.
2203 * monodocer.cs: Don't use Type.Name (or equivalent) to generate filenames,
2204 but use GetTypeFileName(), so that Foo<T> only tries to open the file
2205 Foo`1, instead of the file Foo<T> which (1) is wrong, we never generate
2206 filenames like that, and (2) fails horribly on Win32 (as '<' and '>' are
2207 invalid path characters).
2209 2006-10-19 Jonathan Pryor <jonpryor@vt.edu>
2211 * monodocer.cs: Sort member ordering so that when the order of members
2212 returned by Type.GetMembers() changes (as it did between 1.1.17 and
2213 1.1.18) the order of the documentation members won't change (leading to
2214 "errors" in the regression tests).
2215 * DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
2216 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
2217 DocTest/en.expected/Mono.DocTest/Widget.xml,
2218 DocTest/en.expected/Mono.DocTest/DocValueType.xml,
2219 DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
2220 DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
2221 DocTest/en.expected/Mono.DocTest/UseLists.xml,
2222 DocTest/en.expected/Mono.DocTest/Color.xml,
2223 DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
2224 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
2225 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml,
2226 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
2227 DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
2228 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
2229 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
2230 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
2231 DocTest/en.expected.since/Mono.DocTest/Color.xml,
2232 DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
2233 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
2234 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
2235 DocTest/html.expected/Mono.DocTest/Color.html,
2236 DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
2237 DocTest/html.expected/Mono.DocTest/Widget.html,
2238 DocTest/html.expected/Mono.DocTest/DocValueType.html,
2239 DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
2240 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
2241 DocTest/html.expected/Mono.DocTest/UseLists.html: Flush. Since monodocer
2242 generates a different member ordering, *everything* gets a different
2245 2006-10-12 Jonathan Pryor <jonpryor@vt.edu>
2247 * monodocer.cs: Add support for inserting Docs/since element. This element
2248 is *only* inserted for NEW type/members, never updated, and is only
2249 inserted if the -since:SINCE command-line argument is provided.
2250 * DocTest.cs: Renamed to DocTest-v1.cs.
2251 * Makefile.am: Add DocTest.dll-v1, DocTest.dll-v2, check-monodocer-since,
2252 check-monodocer-since-update, check targets.
2253 * DocTest-v2.patch: Patch file applied to DocTest-v1.cs to get DocTest.dll
2255 * DocTest/en.expected.since/index.xml,
2256 DocTest/en.expected.since/Mono.DocTest.xml,
2257 DocTest/en.expected.since/Mono.DocTest/AddedType.xml,
2258 DocTest/en.expected.since/Mono.DocTest/Color.xml,
2259 DocTest/en.expected.since/Mono.DocTest/DocValueType.xml,
2260 DocTest/en.expected.since/Mono.DocTest/IProcess.xml,
2261 DocTest/en.expected.since/Mono.DocTest/UseLists.xml,
2262 DocTest/en.expected.since/Mono.DocTest/Widget.xml,
2263 DocTest/en.expected.since/Mono.DocTest/Widget+Del.xml,
2264 DocTest/en.expected.since/Mono.DocTest/Widget+Direction.xml,
2265 DocTest/en.expected.since/Mono.DocTest/Widget+IMenuItem.xml,
2266 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass.xml,
2267 DocTest/en.expected.since/Mono.DocTest/Widget+NestedClass`1.xml,
2268 DocTest/en.expected.since/Mono.DocTest.Generic.xml,
2269 DocTest/en.expected.since/Mono.DocTest.Generic/GenericBase`1.xml,
2270 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1.xml,
2271 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
2272 DocTest/en.expected.since/Mono.DocTest.Generic/MyList`2.xml: Added;
2273 expected output for DocTest.dll v2.0.0.0.
2275 2006-10-11 Jonathan Pryor <jonpryor@vt.edu>
2277 * stylesheet.xsl: Add /Members/Docs node in GetInheritedMembers() so that
2278 GetLinkId() sees typeparam elements for type replacement in parameters for
2279 members of base types. Make sure that "simple" type arguments are
2280 replaced, e.g. T --> `1.
2281 TODO: figure out type replacements for nested types.
2282 * DocTest/html.expected/Mono.DocTest/UseLists.html,
2283 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
2284 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
2285 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
2286 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html: Change link id's
2287 and targets for proper type replacements within parameters.
2289 2006-10-10 Joshua Tauberer <jit@occams.info>
2291 * monodocer.cs: Fixed a bug in WriteElement that would put
2292 nodes in the wrong place if some node in the path already
2294 - To prevent TypeParameters from always being put at the
2295 end on an update, don't delete that node in an update, just
2297 - Update the DisplayName attribute in index.xml on doc updates.
2298 * DocTest/*: Updated for the DisplayName fix, and also put
2299 into a pristine state (I had committed them as an update,
2300 which put the TypeParameters block at the end of the files.)
2302 2006-10-09 Joshua Tauberer <jit@occams.info>
2304 * monodocer.cs: Update a type's name attributes during an update
2305 because generic argument names may change even if filename
2307 - Added a Type/TypeParameters section which includes type
2308 parameters that come from the declaring type, for nested types.
2309 - When inheriting from a generic type, added a BaseTypeArguments
2310 section which maps type parameters on the base type's type
2311 definition to types instantiating those parameters. i.e.:
2313 class Y<U> : X<U> { }
2314 Y gets a mapping in its BaseType node from T to U.
2315 * stylesheet.xsl: Don't attempt to link to a generic type
2316 parameter, just display it in italics. And when displaying
2317 inherited members, try to replace generic type parameters
2318 in the base type with the types that have instantiated them
2320 * The DocTests are updated to show off these things.
2322 2006-10-08 Joshua Tauberer <jit@occams.info>
2324 * monodocer.cs: Track which members have been seen in the XML file
2325 not by putting MemberInfos into a hashtable, which seems to
2326 not always work right, but instead by their (string) signature.
2327 - Get custom attribute data with the new 2.0 CustomAttributeData
2328 classes, so that we can reconstruct what the constructor actually
2330 - Hide System.Runtime.InteropServices.Out attributes since it is
2331 fake and already in the RefType XML attribute.
2332 - Structs weren't getting their interfaces listed in their C# type
2334 * monodocs2html.cs: Don't override the default XSLT URI resolver anymore.
2335 * stylesheet.xsl: Get the index.xml document at the start while we're
2336 sure we have the right base path (the XML document being transformed).
2337 - Display inherited members in a type's member list when the base type
2338 is documented in the same monodocer document set.
2339 - Make sure there's a space between a method's parameters and return
2340 value type in the member list.
2341 * DocTest: Updated to test these things.
2343 2006-10-06 Jonathan Pryor <jonpryor@vt.edu>
2345 * overview.xsl: When generating a Namespace/index.html file, we should
2346 insert the namespace remarks as well. (This *should* have been done, but
2347 the remarks selection was relative to '.', not to the provided $ns. :-(
2348 * DocTest/html.expected/Mono.DocTest.Generic/index.html,
2349 DocTest/html.expected/Mono.DocTest/index.html: Flush.
2351 2006-10-06 Jonathan Pryor <jonpryor@vt.edu>
2353 * Makefile.am: Fix -update targets so they don't delete .svn/*.
2354 * monodocer.cs: Don't key off of DisplayName to insert new <Type> elements,
2355 as this will result in updating all existing documentation (rather silly).
2356 Key off of Name instead, and only create a DisplayName attribute if it
2358 * DocTest/en.expected/index.xml: Update to latest monodocer output.
2359 * monodocs2html.cs: If DisplayName doesn't exist, fall back to
2360 Name ("legacy" behavior, now made current due to change in monodocer.cs).
2361 * stylesheet.xsl: For "Name [Generic ] [MemberType]" descriptions, make the
2362 2nd space part of "Generic". Otherwise we get double spaces for
2363 non-generic members, e.g. "Name [MemberType]".
2364 * overview.xsl: Fallback to @Name if @DisplayName doesn't exist.
2365 * DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
2366 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
2367 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
2368 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
2369 DocTest/html.expected/Mono.DocTest/Widget.html,
2370 DocTest/html.expected/Mono.DocTest/DocValueType.html,
2371 DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
2372 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
2373 DocTest/html.expected/Mono.DocTest/UseLists.html: Update to latest
2374 monodocs2html output.
2376 2006-10-06 Jonathan Pryor <jonpryor@vt.edu>
2378 * Makefile.am: Build with gmcs; add `-debug' to compile lines; add
2379 DocTest.dll, check-monodocer, check-monodocer-update, check-monodocs2html/
2380 check-monodocs2html-update targets for unit tests.
2381 * monodocer.cs: Major overhaul for Generics support. Documentation
2382 generated follows the pattern used in CLILibraryTypes.xml from ECMA-335.
2383 - Remove some warnings about unused variables.
2384 - Don't assume that Type.FullName is always what we want, but instead
2385 build a C# typename from the Type information. This is needed to nicely
2386 deal with generics, as the FullName for Foo<int> would be
2387 Foo[[System.Int32, mscorlib]], while we really want Foo<int>.
2388 - For index.xml files, insert a File attribute, as the Type name won't
2389 match the filename for generic types (Foo<T> is the file Foo`1.xml).
2390 - For GetMember(), remove generic parameters before using Type.GetMember()
2391 with the member name.
2392 - Code refactoring so that <param/> and <typeparam/> generation & updating
2394 - Properly use `this' for method name on indexers.
2395 * monodocs2html.cs: Add Generics support -- use the @File attribute instead
2396 of assuming that @Name contains the proper filename.
2397 * defaulttemplate.xsl: Use <h1> instead of <div>; add CSS for
2398 `.InnerSignatureTable tr' and `.TypePermissionTable tr'.
2399 * overview.xsl: If there are fewer than $max-types (20) types in the
2400 assembly, show them all in the top-level index.html, no matter how many
2401 namespaces are present. Otherwise, provide links to the
2402 Namespace/index.html files, so that things don't suddenly look different
2403 as soon as you go from 1 namespace to > 1 namespaces in an assembly.
2404 Use <h2/> instead of <div/>.
2405 * stylesheet.xsl: Major overhaul for Generics support, some re-indentation.
2406 - Use <h2/>...<h4/> instead of <div/>
2407 - Allow output to validate against XHTML.
2408 - Don't use generate-id(), but instead generate member ID's manually so
2409 that we can properly refer to them from outside the current page.
2410 - Add support for <see cref=""/> translation to non-types --
2411 constructors, methods, properties, fields, events. These can refer to
2412 members from a different file, since generate-id() is no longer used.
2413 - Update the mono-docs site so links to System.* types work.
2414 - Add support for additional Mono.* namespaces on the mono-docs site.
2415 - Properly display C# indexers ("type this [params]", not
2416 "type Item [params]").
2417 - Generate documentation for <typeparam/> elements.
2418 * DocTest.cs: Added; Source for DocTest.dll, used by unit tests.
2419 * DocTest/html.expected/Mono.DocTest/Widget+NestedClass.html,
2420 DocTest/html.expected/Mono.DocTest/Widget+NestedClass`1.html,
2421 DocTest/html.expected/Mono.DocTest/Widget+IMenuItem.html,
2422 DocTest/html.expected/Mono.DocTest/DocValueType.html,
2423 DocTest/html.expected/Mono.DocTest/IProcess.html,
2424 DocTest/html.expected/Mono.DocTest/index.html,
2425 DocTest/html.expected/Mono.DocTest/Widget+Direction.html,
2426 DocTest/html.expected/Mono.DocTest/Color.html,
2427 DocTest/html.expected/Mono.DocTest/Widget+Del.html,
2428 DocTest/html.expected/Mono.DocTest/UseLists.html,
2429 DocTest/html.expected/Mono.DocTest/Widget.html,
2430 DocTest/html.expected/Mono.DocTest.Generic/MyList`1+Helper`2.html,
2431 DocTest/html.expected/Mono.DocTest.Generic/index.html,
2432 DocTest/html.expected/Mono.DocTest.Generic/MyList`1.html,
2433 DocTest/html.expected/Mono.DocTest.Generic/MyList`2.html,
2434 DocTest/html.expected/Mono.DocTest.Generic/GenericBase`1.html,
2435 DocTest/html.expected/index.html,
2436 DocTest/en.expected/Mono.DocTest.Generic.xml,
2437 DocTest/en.expected/Mono.DocTest/Widget+IMenuItem.xml,
2438 DocTest/en.expected/Mono.DocTest/IProcess.xml,
2439 DocTest/en.expected/Mono.DocTest/Widget.xml,
2440 DocTest/en.expected/Mono.DocTest/Widget+NestedClass`1.xml,
2441 DocTest/en.expected/Mono.DocTest/DocValueType.xml,
2442 DocTest/en.expected/Mono.DocTest/Widget+Direction.xml,
2443 DocTest/en.expected/Mono.DocTest/Widget+NestedClass.xml,
2444 DocTest/en.expected/Mono.DocTest/Widget+Del.xml,
2445 DocTest/en.expected/Mono.DocTest/UseLists.xml,
2446 DocTest/en.expected/Mono.DocTest/Color.xml,
2447 DocTest/en.expected/Mono.DocTest.Generic/GenericBase`1.xml,
2448 DocTest/en.expected/Mono.DocTest.Generic/MyList`1.xml,
2449 DocTest/en.expected/Mono.DocTest.Generic/MyList`2.xml,
2450 DocTest/en.expected/Mono.DocTest.Generic/MyList`1+Helper`2.xml,
2451 DocTest/en.expected/index.xml, DocTest/en.expected/Mono.DocTest.xml:
2452 Added. Expected output for monodocer (en.expected) and
2453 monodocs2html (html.expected).
2455 2006-04-01 Joshua Tauberer <tauberer@for.net>
2457 * monodocs2html.cs: Skip files that are missing.
2459 2006-03-09 Joshua Tauberer <tauberer@for.net>
2461 * monodocer.cs: Reverted all of the Cecil changes. Ah well.
2463 2006-03-04 Joshua Tauberer <tauberer@for.net>
2465 * monodocer.cs: Using Cecil now! (Some Cecil fixes
2466 need to be committed.)
2468 2006-03-03 Joshua Tauberer <tauberer@for.net>
2470 * monodocer.cs: Don't change up whitespace unless user says so.
2471 That makes it hard to see differences against svn.
2473 2006-01-12 Jonathan Pryor <jonpryor@vt.edu>
2475 * bsd-man-to-ecma.pl, bsd-man-to-exception.pl: Added; scripts to help
2476 convert BSD man pages into ECMA XML formats. Run `perldoc PROGRAM` for
2477 program documentation.
2478 * Makefile.am: Add bsd-man-to-ecma.pl and bsd-man-to-exception.pl to
2481 2005-08-11 Dan Winship <danw@novell.com>
2483 * monodocer.cs: Don't preserve whitespace when reading the old
2484 doc, and don't add any whitespace when creating the new doc. Just
2485 let the XmlTextWriter handle indentation and it will all just
2488 2005-08-03 Atsushi Enomoto <atsushi@ximian.com>
2490 * monodocer.cs : update name attribute in paramref elements in sync
2491 with that of param element.
2493 2005-07-09 Joshua Tauberer <tauberer@for.net>
2495 From Rodolfo Campero <rodolfo.campero@gmail.com>
2497 * monodocs2slashdoc.cs: Updated for changes in
2498 index.xml for documenting multiple assemblies.
2499 This app now writes out XML files for each assembly
2500 as well as NamespaceSummaries.xml to the working
2503 2005-06-12 Joshua Tauberer <tauberer@for.net>
2505 * monodocer.cs: Added --importslashdoc option to
2506 import the contents of /doc-generated xml docs
2507 into the generated files.
2509 2005-06-09 Joshua Tauberer <tauberer@for.net>
2511 * monodocer.cs : When documenting a single assembly,
2512 default the Title in index.xml to the name of the
2515 2005-06-04 Eric Butler <eric@extremeboredom.net>
2517 (copied from ChangeLog in parent directory)
2519 - Now exits with an exit code of 1 in the event of an error
2520 - Added '-name' command line argument
2521 - Use above argument for <Title> element
2523 2005-06-01 Joshua Tauberer <tauberer@for.net>
2525 * monodocer.cs : Old index.xml files need to have new nodes
2526 created for multiple assemblies, and the old Assembly and
2527 Attributes nodes removed. Added a Title element for 2html.
2529 * overview.xsl : Revised monodocs2html to use the Title
2530 element in index.xml for page titles, rather than the
2531 assembly name, which isn't available anymore since there
2532 may be more than one assembly.
2534 2005-05-23 Mike Kestner <mkestner@novell.com>
2536 * monodocer.cs : add multiple assembly updating.
2538 2005-05-09 Joshua Tauberer <tauberer@for.net>
2540 * Thanks for pushing me to use a ChangeLog.
2541 * Disallow documenting types in the root namespace (type.Namespace ==
2543 * When a <code> tag has a 'src' attribute, monodocer will replace
2544 the contents of the element with the text in the indicated file.
2545 the path is relative to the path given as the --path option.
2546 * Properties that have different access modifiers on their accessors
2547 are now given signatures that reflect that. (But Monodoc doesn't
2548 recognize this properly. A format change is needed.)
2549 * monodocs2html: Create the destination directory if it doesn't exist.
2551 2005-01-29 Jonathan Pryor <jonpryor@vt.edu>
2554 * monodocer.cs (GetTypeFileName): Add check for type.Namespace == null.
2555 Fixes NullReferenceException when trying to update Mono.Posix.dll.