FS#44007 - [mono-tools] (monodoc) Main Documentation Missing/Incomplete

Attached to Project: Arch Linux
Opened by Hauke T. (htho) - Monday, 02 March 2015, 08:17 GMT
Last edited by freswa (frederik) - Tuesday, 24 March 2020, 18:59 GMT
Task Type Bug Report
Category Packages: Extra
Status Closed
Assigned To Jan de Groot (JGC)
Levente Polyak (anthraxx)
Architecture x86_64
Severity Low
Priority Normal
Reported Version
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 2
Private No

Details

Description:
After installing mono-tools in order to use monodoc, the list of Documentation Items (in monodoc) is quite short. There is only the documentation for some specific libraries, but not for the standard libraries belonging to mono.

I guess this is a Packaging issue because I could not find any other reports on the net. I guess this would be known if it was an upstream problem.

I have posted my Problem on the Forums some time ago but did not get any replys. (https://bbs.archlinux.org/viewtopic.php?id=193225)

Additional info:
* package version: 3.10-2
* monodoc version: 3.10.0.0
* bbs: https://bbs.archlinux.org/viewtopic.php?id=193225
* screenshot: https://dl.dropboxusercontent.com/u/5138254/monodoc.png

Command Line Output:
$ monodoc
Error: did not find one of the files in sources//usr/lib/monodoc/sources/gd2i
node `classlib-webkit' is not defined on the documentation map
using WebKit
using WebKit

(browser:2045): GLib-CRITICAL **: Source ID 15 was not found when attempting to remove it

Steps to reproduce:
Install mono-tools and start it.
This task depends upon

Closed by  freswa (frederik)
Tuesday, 24 March 2020, 18:59 GMT
Reason for closing:  None
Additional comments about closing:  This seems pretty stalled to me. If it's still an issue, please fill a re-open request. Thank you :)
Comment by Isenmann Daniel (ise) - Tuesday, 07 July 2015, 07:21 GMT
Just for information: At the moment I have too little time for Arch, I will do my best to find a solution in the next upcoming weeks.
Comment by Isenmann Daniel (ise) - Tuesday, 21 July 2015, 19:05 GMT
Are you sure that there should be more than the displayed documentation? Have you verified this with other distributions or upstream?
Comment by Hauke T. (htho) - Wednesday, 22 July 2015, 19:30 GMT
According to the Website http://www.mono-project.com/docs/tools+libraries/tools/monodoc/ there should be:
* Core Framework
* Mono libraries
* Novell libraries
* C# Language Specification
* Compiler error reference
Comment by Trinh Anh Ngoc (trinhanhngoc) - Wednesday, 25 May 2016, 02:19 GMT
PKGBUILD: rebuilding with --with-mcs-docs=yes will include docs.
Comment by Hauke T. (htho) - Thursday, 26 May 2016, 15:12 GMT
@trinhanhngoc Thank you, that did it.

To include the documentation, mono as well as the mono-tools need to be repackaged/rebuilded. Since there will be two "/usr/lib/monodoc/monodoc.xml" in the system.

mono
PKGBUILD
change line 35 from "--with-mcs-docs=no" to "--with-mcs-docs=yes"

mono-tools
PKGBUILD
remove line 48 ("install -D -m644 "${srcdir}"/monodoc.xml "${pkgdir}"/usr/lib/monodoc/monodoc.xml")

BUT... Is it a bug, or a feature? @ise Do you know why it is solved that way?

Loading...