headers
Alan Freed | 24 Apr 2010 12:18
Picon

monodoc edit: GLib-WARNING

Hi,

I am attempting to write documentation for a DLL that I've written,
and which I use in a class that I teach.  My students are much
more likely to read on-line documentation than the pdf that I wrote.
So, I was excited to see that Monodoc has such a capability.  I
just can't seem to get it to work.  First of all, some system info:

I run Kubuntu, Linux version 2.6.31-20, with

mono --version
Mono JIT compiler version 2.4.2.3 (Debian 2.4.2.3+dfsg-2)
Copyright (C) 2002-2008 Novell, Inc and Contributors. www.mono-project.com
        TLS:           __thread
        GC:            Included Boehm (with typed GC)
        SIGSEGV:       altstack
        Notifications: epoll
        Architecture:  amd64
        Disabled:      none

Following the procedure outlined on page
http://www.mono-project.com/Generating_Documentation
I ran

monodocer -assembly:<my>.dll -path:en -pretty

which, as far as I can tell, ran correctly creating an "en"
directory with many xml files and subdirectories, etc.

The next step is to load this xml structure into monodoc
for editing, so I executed, and got the output stream

monodoc --edit en

(/usr/lib/monodoc/browser.exe:2998): GLib-WARNING **: g_set_prgname() called multiple times

Unhandled Exception: System.InvalidOperationException: Operation is not valid due to the current state of the object
  at Monodoc.EcmaHelpSource.MakeOperatorSignature (System.Xml.XmlNode n, System.String& nicename, System.String& sig) [0x00000]
  at Monodoc.EcmaUncompiledHelpSource..ctor (System.String base_file) [0x00000]
  at Monodoc.RootTree.LoadTree (System.String basedir) [0x00000]
  at Monodoc.RootTree.LoadTree () [0x00000]
  at Monodoc.Browser..ctor (System.String engine) [0x00000]
  at Monodoc.Driver.Main (System.String[] args) [0x00000]


I ran this on my computer at home and at work and got the same
output. Any thoughts or help would be most welcome.

Thanks,

Al
--
Alan D. Freed
Clifford H. Spicer Chair in Engineering
Saginaw Valley State University
University Center, Michigan, USA

Work:  adfreed <at> svsu.edu
Home:  alan.d.freed <at> gmail.com
_______________________________________________
Mono-docs-list maillist  -  Mono-docs-list <at> lists.ximian.com
http://lists.ximian.com/mailman/listinfo/mono-docs-list
Permalink | Reply |
headers
Jonathan Pryor | 25 Apr 2010 22:53
Picon
Favicon
Gravatar

Re: monodoc edit: GLib-WARNING

On Sat, 2010-04-24 at 06:18 -0400, Alan Freed wrote:
> Following the procedure outlined on page
> http://www.mono-project.com/Generating_Documentation
> I ran
> 
> monodocer -assembly:<my>.dll -path:en -pretty

Could you try using 'mdoc update' instead?

> monodoc --edit en
> 
> (/usr/lib/monodoc/browser.exe:2998): GLib-WARNING **: g_set_prgname()
> called multiple times
> 
> Unhandled Exception: System.InvalidOperationException: Operation is
> not valid due to the current state of the object

That's odd.  I don't ever recall seeing this before.

Your stack trace sadly doesn't contain line numbers, but
EcmaHelpSource.MakeOperatorSignature() only throws it from one place:
for overridden operators that weren't properly supported [0].

Perhaps you could provide the XML file that generates the error (or
otherwise let us know which operator we're not checking for)?

Thanks,

 - Jon

[0]
http://anonsvn.mono-project.com/source/branches/mono-2-4-3/mcs/tools/monodoc/Monodoc/ecma-provider.cs

_______________________________________________
Mono-docs-list maillist  -  Mono-docs-list <at> lists.ximian.com
http://lists.ximian.com/mailman/listinfo/mono-docs-list
Permalink | Reply |

Gmane