[Mono-bugs] [Bug 55047][Wis] New - monodoc --merge-changes failing to find files

[bugzilla-daemon@bugzilla.ximian.com]

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 met@uberstats.com.

http://bugzilla.ximian.com/show_bug.cgi?id=55047

--- shadow/55047	2004-03-01 21:32:40.000000000 -0500
+++ shadow/55047.tmp.22407	2004-03-01 21:32:40.000000000 -0500
@@ -0,0 +1,66 @@
+Bug#: 55047
+Product: Mono/Doctools
+Version: unspecified
+OS: 
+OS Details: 
+Status: NEW   
+Resolution: 
+Severity: 
+Priority: Wishlist
+Component: Core
+AssignedTo: mono-bugs@ximian.com                            
+ReportedBy: met@uberstats.com               
+QAContact: mono-bugs@ximian.com
+TargetMilestone: ---
+URL: 
+Cc: 
+Summary: monodoc --merge-changes failing to find files 
+
+In the ~/.config/monodoc/changeset.xml file the DocSet attribute of
+DocSetChangeset contains a name generated by assembler.exe, but no path for
+that file.  From what Ican tell EditMerge searches for that file via the
+second parameter youpass into --merge-changes.  
+
+monodoc --merge-changes ~/.config/monodoc/changeset.xml doc/api
+
+So by using the path I supply (doc/api), it finds theDocSet, but then fails
+to find the file set in the RealFile attribute of FileChangeset because its
+path DOES NOT START where my second parameter (doc/api) to --merge-changes
+leaves off. So doc/api finds doc/api/$(DocSet), but doc/api/$(REALFILE)
+does not exist b/c it contains the doc/api already.  Here's the Xml
+generated by monodoc whenI edit one of my docs. 
+
+====
+<?xml version="1.0" encoding="utf-8"?>
+<GlobalChangeset>
+  <DocSetChangeset DocSet="Umbrella.PMS-doc">
+    <FileChangeset
+RealFile="doc/api/en/Umbrella.PMS.Broker/PersistenceBroker.xml">
+      <Change XPath="Type
+[@FullName='Umbrella.PMS.Broker.PersistenceBroker']/Docs/summary">
+        <NewNode>
+          <summary>User level interface to PMS.</summary>
+        </NewNode>
+        <Serial>0</Serial>
+      </Change>
+    </FileChangeset>
+  </DocSetChangeset>
+</GlobalChangeset>
+====
+
+The DocSet (Umbrella.PMS-doc) actually exists in 'doc/api' which is part
+of the RealFile path for the edited file.  So if I change either values
+(Docset or RealFile) so that they start from the same directory
+everything works OK.  So I'm generated the docs wrong, or monodoc is not
+holding all the values it necessarily should - and since monodoc seems
+to work fine for everyone else, I'm probably doing it wrong.  Here's how
+I generated the docs.
+
+====
+mono ../../class/lib/updater.exe ../../class/lib/Umbrella.PMS.dll -o
+doc/api/en -f
+                                                                          
+     
+mono ../../class/lib/assembler.exe --ecma doc/api/en -o
+doc/api/Umbrella.PMS-doc
+====