Description of problem: dkms.8 is garbled. It's specifically missing the command synopses in the SYNOPSIS and ACTIONS sections. The rpm source ships only a version formatted like that, not the source (presumably a GPL violation). Version-Release number of selected component (if applicable): 2.2.0.3-8
Hello, I'm not sure I've understood the problem. In my opinion the manpage is correct, also Debian ships it without patches. What you were expecting? Different Fedora specific paths instead of /path/to/source-tree] [/path/to/tarball.tar] [/path/to/driver.rpm]? Thanks, --Simone
The start of the man page display is as follows, which doesn't actually tell me how to use it due to the missing synopses: NAME dkms - Dynamic Kernel Module Support SYNOPSIS DESCRIPTION dkms is a framework which allows kernel modules to be dynamically built for each kernel on your system in a simplified and orga- nized fashion. ACTIONS Adds a module/module-version combination to the tree for builds and installs. If module/module-version, -m mod- The Debian version (which comes as troff source) is: NAME dkms - Dynamic Kernel Module Support SYNOPSIS dkms [action] [options] [module/module-version] [/path/to/source-tree] [/path/to/tarball.tar] [/path/to/driver.rpm] DESCRIPTION dkms is a framework which allows kernel modules to be dynamically built for each kernel on your system in a simplified and organized fashion. ACTIONS add [module/module-version] [/path/to/source-tree] [/path/to/tarball.tar] Adds a module/module-version combination to the tree for builds and installs. If module/module-version, -m module/module-version, or
(In reply to Dave Love from comment #2) > The Debian version (which comes as troff source) is: > > NAME > dkms - Dynamic Kernel Module Support > > SYNOPSIS > dkms [action] [options] [module/module-version] [/path/to/source-tree] > [/path/to/tarball.tar] [/path/to/driver.rpm] ...which is what I see in dkms-2.2.0.3-8.fc19. Looking into it as only el6 seems to be affected.
I've checked all builds, all the manpages contain the SYNOPSIS section and everything else. But for some reason on el5 and el6 those sections are not displayed. Don't know where the bug resides, though; looking into it.
Ok, figured out, the man version bundled in el5 and el6 is too old to visualize groff tags in man pages with these extensions: .EX/.EE, .SY/.OP/.YS, .UR/.UE, and .MT/.ME. Looking if there's a way to convert a groff file to an older version.
FWIW, the macros are in an-ext.tmac in the groff 1.21 on my Debian system, which I assume is in Fedora too. Presumably the page could be patched to add that at the front with older groff. [Sorry, I don't know why it appeared the page was preformatted in the source I fetched.]
I'm no expert but it appears other older man pages have handled this by adding an explicit macro for '.OP'. Presumably one could do something similar with '.SY' but I don't see any examples of that. They've just converted to using the newer syntax. .de OP .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" .el .RB "[\ " "\\$1" "\ ]"
Created attachment 819925 [details] Define missing SY, YS, OP macros As suggested in a prior comment just define the missing macros at the start of the man page. These macros were obtained directly from /usr/share/groff/1.21/tmac/an-ext.tmac.
(In reply to Brian Behlendorf from comment #8) > Created attachment 819925 [details] > Define missing SY, YS, OP macros > > As suggested in a prior comment just define the missing macros at the start > of the man page. These macros were obtained directly from > /usr/share/groff/1.21/tmac/an-ext.tmac. Thank you very much, really appreciated! The patch works fine. Adding it to the changes along with the ZFS On Linux patches.
dkms-2.2.0.3-20.el5 has been submitted as an update for Fedora EPEL 5. https://admin.fedoraproject.org/updates/dkms-2.2.0.3-20.el5
dkms-2.2.0.3-20.el6 has been submitted as an update for Fedora EPEL 6. https://admin.fedoraproject.org/updates/dkms-2.2.0.3-20.el6
dkms-2.2.0.3-20.fc18 has been submitted as an update for Fedora 18. https://admin.fedoraproject.org/updates/dkms-2.2.0.3-20.fc18
dkms-2.2.0.3-20.fc19 has been submitted as an update for Fedora 19. https://admin.fedoraproject.org/updates/dkms-2.2.0.3-20.fc19
dkms-2.2.0.3-20.fc20 has been submitted as an update for Fedora 20. https://admin.fedoraproject.org/updates/dkms-2.2.0.3-20.fc20
Package dkms-2.2.0.3-20.el5: * should fix your issue, * was pushed to the Fedora EPEL 5 testing repository, * should be available at your local mirror within two days. Update it with: # su -c 'yum update --enablerepo=epel-testing dkms-2.2.0.3-20.el5' as soon as you are able to. Please go to the following url: https://admin.fedoraproject.org/updates/FEDORA-EPEL-2013-12084/dkms-2.2.0.3-20.el5 then log in and leave karma (feedback).
dkms-2.2.0.3-20.fc19 has been pushed to the Fedora 19 stable repository. If problems still persist, please make note of it in this bug report.
dkms-2.2.0.3-20.fc18 has been pushed to the Fedora 18 stable repository. If problems still persist, please make note of it in this bug report.
dkms-2.2.0.3-20.fc20 has been pushed to the Fedora 20 stable repository. If problems still persist, please make note of it in this bug report.
dkms-2.2.0.3-20.el5 has been pushed to the Fedora EPEL 5 stable repository. If problems still persist, please make note of it in this bug report.
dkms-2.2.0.3-20.el6 has been pushed to the Fedora EPEL 6 stable repository. If problems still persist, please make note of it in this bug report.