| Summary: | systemd documentation references cause man to complain | ||
|---|---|---|---|
| Product: | [Fedora] Fedora | Reporter: | Michal Jaegermann <michal> |
| Component: | docbook-style-xsl | Assignee: | Ondrej Vasik <ovasik> |
| Status: | CLOSED RAWHIDE | QA Contact: | Fedora Extras Quality Assurance <extras-qa> |
| Severity: | unspecified | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | rawhide | CC: | harald, johannbg, kay, kdudka, lpoetter, metherid, mschmidt, notting, ovasik, plautrba, sgallagh, veillard |
| Target Milestone: | --- | Keywords: | Reopened |
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2011-09-06 17:59:39 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
|
Description
Michal Jaegermann
2011-08-01 16:42:15 UTC
Hmm, these are the docbook xslt stylesheets producing this output. We just If this is not correct, then this should be fixed there. We simply use <refname>....</refname> to create these alias files, and if the generated files are invalid, then the stylesheets should be fixed. Well... I don't think the issue is in docbook stylesheets ... I checked out your sources and tried to rebuild the manpage manually with properly set docbook... [Reset@dhcp-24-196 man]$ cat sd_is_socket.3 .so sd_is_fifo.3 [Reset@dhcp-24-196 man]$ xmlto man sd_is_fifo.xml Note: Writing sd_is_fifo.3 Note: Writing sd_is_socket.3 (soelim stub) Note: Writing sd_is_socket_inet.3 (soelim stub) Note: Writing sd_is_socket_unix.3 (soelim stub) Note: Writing sd_is_mq.3 (soelim stub) [Reset@dhcp-24-196 man]$ cat sd_is_socket.3 .so man3/sd_is_fifo.3 Lennart, what are you using for generating these manpage links? Probably just wrong tools use... Anyway - moving back - this is not the issue of docbook stylesheets. Hmm, I use xsltproc instead of xmlto. Tentatively reassigning to xsltproc then. Hard to tell without debugging the docbook stylesheets and how they interact with the various extensions to XSLT-1.0 specification. Ondrej if you have the setup could you look at the difference in behaviour. Note that xmlto used to call xsltproc too (depending what was asked), so it's really unclear what is going on just from the bug report. Daniel Ok, I checked that one more time and it works ok on RHEL-6 (docbook-style-xsl), but seems to be broken in docbook-style-xsl-1.76.1 in Fedora Rawhide... Moving back to stylesheets, sorry for the noise... RHEL-6 package NVR is docbook-style-xsl-1.75.2-6.el6 ... Hmmms, upstream change - http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/manpages/other.xsl?r1=8841&r2=8865 ... man.output.in.separate.dir in manpages/param.xsl has to be changed by default to 1 to restore previous default behaviour... Should be fixed by docbook-style-xsl-1.76.1-3.fc17 ... closing RAWHIDE. Ah okay, I was afraid of a possible brokeness in the EXSLT extensions, thanks for chasing the issue :-) Daniel Reopening this bug. This change is completely unacceptable. It breaks generation of manpages (it changes where the output goes). To use SSSD as an example (whose nightly builds just started breaking because of this change): With docbook-style-xsl-1.76.1-2.fc15: /usr/bin/xsltproc -o uk/sss_usermod.8 --catalogs --xinclude --nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl uk/sss_usermod.8.xml produces the file ./uk/sss_usermod.8 (as expected). With docbook-style-xsl-1.76.1-3.fc15 (trivially rebuilt from docbook-style-xsl.noarch 0:1.76.1-3.fc17 for local testing): /usr/bin/xsltproc -o uk/sss_usermod.8 --catalogs --xinclude --nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl uk/sss_usermod.8.xml produces the file ./uk/man/man8/sss_usermod.8 This is nowhere near where it belongs. If xsltproc is handed a -o option specifying where the output goes, that needs to remain the same. Damned ... you are right, Stephen... If the change of the default parameter is affecting other builds, I have to revert it... Any idea how to solve it better way? I think the longer "workaround" in the original upstream report ( http://sourceforge.net/tracker/?func=detail&aid=2831602&group_id=21935&atid=373747 ) and reverting the param change should work in both cases. (In reply to comment #13) > Damned ... you are right, Stephen... > If the change of the default parameter is affecting other builds, I have to > revert it... > Any idea how to solve it better way? I think the longer "workaround" in the > original upstream report ( > http://sourceforge.net/tracker/?func=detail&aid=2831602&group_id=21935&atid=373747 > ) and reverting the param change should work in both cases. Sorry, I don't actually have any insight into this problem. I only know this change broke my build :( Ok, I tried that on my machine and this should work for both cases correctly - please try docbook-style-xsl-1.76.1-4.fc17 from http://koji.fedoraproject.org/koji/taskinfo?taskID=3327584 (In reply to comment #15) > Ok, I tried that on my machine and this should work for both cases correctly - > please try docbook-style-xsl-1.76.1-4.fc17 from > http://koji.fedoraproject.org/koji/taskinfo?taskID=3327584 That's working for me. Ok, thanks, closing RAWHIDE again... |