[Bug 688032] New: libX11 documentation is in source form only

older
[Bug 510454] New: Icecream fails...

bugzilla_noreply＠novell.com

17 Apr 2011 17 Apr '11

16:55

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c0 Summary: libX11 documentation is in source form only Classification: openSUSE Product: openSUSE 11.4 Version: Final Platform: x86-64 OS/Version: openSUSE 11.4 Status: NEW Severity: Minor Priority: P5 - None Component: Documentation AssignedTo: ke@novell.com ReportedBy: giecrilj@stegny.2a.pl QAContact: ke@novell.com Found By: --- Blocker: --- User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:2.0.0) Gecko/20100101 Firefox/4.0 The documentation included in xorg-x11-libX11 is in source form only (DocBook). It is not directly readable and no instruction is provided on how to read it. Reproducible: Always Steps to Reproduce: 1. { rpm '-qd' 'xorg-x11-libX11' | grep '-F' 'libX11'; } 2. { xdg-open /usr/share/doc/libX11/specs/libX11/libX11.xml; } Actual Results: 1. XML (DocBook) and SVG files. 2. Results vary; at best, XML source; at worst, an unreadable interpretation in Konqueror (KDE Bug 239979). Expected Results: 1. Something directly readable, e.g. PDF. Useful documentation can be generated using xsltproc but you need the exact invocation and the URL of the style sheet. However, I suppose that upstream build process already tells you exactly how to do it. I suggest removing the DocBook sources from xorg-x11-libX11 and packaging the documentation into xorg-x11-libX11-PDF (or whatever name seems appropriate). -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

Show replies by date

bugzilla_noreply＠novell.com

18 Apr 18 Apr

05:25

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c Karl Eichwalder changed: What |Removed |Added ---------------------------------------------------------------------------- Component|Documentation |X.Org AssignedTo|ke@novell.com |bnc-team-xorg-bugs@forge.pr | |ovo.novell.com QAContact|ke@novell.com |xorg-maintainer-bugs@forge. | |provo.novell.com -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

09:30

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c1 Stefan Dirsch changed: What |Removed |Added ---------------------------------------------------------------------------- Status|NEW |RESOLVED CC| |coolo@novell.com Resolution| |WONTFIX --- Comment #1 from Stefan Dirsch 2011-04-18 09:30:15 UTC --- Well, I tried before. ------------------------------------------------------------------- Tue Jan 18 16:32:18 UTC 2011 - sndirsch@novell.com - reverted previous change due to creation of a pretty huge build cycle according to coolo ------------------------------------------------------------------- Mon Jan 17 14:22:28 UTC 2011 - sndirsch@novell.com - added xmlto to BuildRequires to generate HTML documentation from XML sources -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

09:31

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c2 --- Comment #2 from Stefan Dirsch 2011-04-18 09:31:00 UTC --- That's from xorg-x11-libX11 RPM changelog ... -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

19 Apr 19 Apr

05:46

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c3 --- Comment #3 from Christopher Yeleighton 2011-04-19 05:46:04 UTC --- How does typesetting libX11 documentation, a thing that every customer developer is expected to do by herself now, create a build cycle? Does xmlto depend on libX11? How about at least providing a script or some instruction on how to prepare the distributed source for reading? If typesetting HTML is a problem, how about DVI? PDF? -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

06:26

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c4 --- Comment #4 from Stefan Dirsch 2011-04-19 06:26:48 UTC ---

...

Does xmlto depend on libX11?

Yes, that's how I understood it. -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

11:13

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c5 --- Comment #5 from Christopher Yeleighton 2011-04-19 11:13:26 UTC --- (In reply to comment #4)

...

...
Does xmlto depend on libX11?

Yes, that's how I understood it.

In that case we should use xmlto-mini instead. -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

12:33

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c6 --- Comment #6 from Stefan Dirsch 2011-04-19 12:33:50 UTC --- (In reply to comment #5)

...

In that case we should use xmlto-mini instead.

I'm not aware of such a package. -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

14:50

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c7 --- Comment #7 from Christopher Yeleighton 2011-04-19 14:50:15 UTC --- In that case, three solutions come to my mind: * create xmlto-mini, or * bootstrap libX11 on a previous release, or * build libX11-doc as a separate package. Building libX11-doc would depend on xmlto that depends on libX11, but libX11 would not depend on libX11-doc, so the circular dependency would be gone. I would personally opt for having xmlto-mini if possible. -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

22 Apr 22 Apr

09:33

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c8 --- Comment #8 from Christopher Yeleighton 2011-04-22 09:33:00 UTC --- KHelpCenter can read DocBook, e.g. KMail is documented in DocBook. Finding a way to plug the documentation into KHelpCenter would solve the problem for KDE (OTOH, you probably do not need that doc on KDE, unless you use KDE to develop for barebones that is). -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

18 May 18 May

14:07

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c9 --- Comment #9 from Christopher Yeleighton 2011-05-18 14:07:16 UTC --- xmlto depends on texlive-xmltex to produce PDF; but the standard build produces XHTML, not PDF. textlive, of course, pulls back X11 with it, so it cannot be done. And it is huge. -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

16:29

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c Christopher Yeleighton changed: What |Removed |Added ---------------------------------------------------------------------------- URL| |https://build.opensuse.org/ | |request/show/70583 -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

19 May 19 May

15:00

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c10 --- Comment #10 from Bernhard Wiedemann 2011-05-19 17:00:27 CEST --- This is an autogenerated message for OBS integration: This bug (688032) was mentioned in https://build.opensuse.org/request/show/70708 Factory / xorg-x11-libX11 -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

bugzilla_noreply＠novell.com

5 Sep 5 Sep

14:00

New subject: [Bug 688032] libX11 documentation is in source form only

https://bugzilla.novell.com/show_bug.cgi?id=688032 https://bugzilla.novell.com/show_bug.cgi?id=688032#c11 --- Comment #11 from Bernhard Wiedemann 2011-09-05 16:00:12 CEST --- This is an autogenerated message for OBS integration: This bug (688032) was mentioned in https://build.opensuse.org/request/show/80955 Factory / xmlto -- Configure bugmail: https://bugzilla.novell.com/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are on the CC list for the bug.

4623

Age (days ago)

4764

Last active (days ago)

List overview

Download

13 comments

1 participants

participants (1)

bugzilla_noreply＠novell.com

[Bug 688032] New: libX11 documentation is in source form only

tags

participants (1)