[Mono-bugs] [Bug 66857][Min] New - mcs -doc option

bugzilla-daemon@bugzilla.ximian.com bugzilla-daemon@bugzilla.ximian.com
Sun, 26 Sep 2004 14:58:56 -0400 (EDT)

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

Changed by mmorano@mikeandwan.us.


--- shadow/66857	2004-09-26 14:58:56.000000000 -0400
+++ shadow/66857.tmp.7085	2004-09-26 14:58:56.000000000 -0400
@@ -0,0 +1,54 @@
+Bug#: 66857
+Product: Mono: Compilers
+Version: unspecified
+OS Details: 
+Status: NEW   
+Priority: Minor
+Component: C#
+AssignedTo: mono-bugs@ximian.com                            
+ReportedBy: mmorano@mikeandwan.us               
+QAContact: mono-bugs@ximian.com
+TargetMilestone: ---
+Summary: mcs -doc option
+Please fill in this template when reporting a bug, unless you know what you
+are doing.
+Description of Problem:
+mcs does not generate documentation XML file.
+Steps to reproduce the problem:
+1. compile app/library with mcs, and specify that documentation should be
+generated off the doc comments in the source (mcs -doc:docs.xml ...).
+Actual Results:
+No documentation file is created
+Expected Results:
+Documentation file should be generated
+How often does this happen? 
+Additional Information:
+Mono C# compiler version
+The man pages do not seem to include information regarding the -doc option
+to mcs, however, if you do mcs --help, it is listed there.  I'd like to see
+this incorporated because its a useful way for simple documentation, and
+very useful when sharing code between ms.net and mono, as ms.net prefers
+this mechanism, and those users won't have easy access to tools like monodoc.