FS#50562 - [iproute2] Consider building the documentation

Attached to Project: Arch Linux
Opened by Earnestly (Earnest) - Monday, 29 August 2016, 12:19 GMT
Last edited by Christian Hesse (eworm) - Monday, 10 October 2016, 06:47 GMT
Task Type Feature Request
Category Packages: Core
Status Closed
Assigned To Ronald van Haren (pressh)
Christian Hesse (eworm)
Architecture All
Severity Low
Priority Normal
Reported Version
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 0
Private No

Details

For some reason the Makefile under doc/ has an install target which dumps the straight .sgml and .tex into /usr/share/doc while the Makefile actually builds .html and .pdf documents.

It is using the legacy sgml* tools but that can be overriden quite easily with linuxdoc from linuxdoc-tools.

If you want to prefer including built documentation then I've found the easiest way is to call make as follows:

] cd doc
] make SGML2DVI='linuxdoc -B latex' SGML2HTML='linuxdoc -B html'

You'd then need to install the following files manually as make install is useless:

arpd.html
nstat.html
rtstat.html
ss-1.html
ss-2.html
ss-3.html
ss-4.html
ss-5.html
ss-6.html
ss.html
api-ip6-flowlabels.pdf
ip-cref.pdf
ip-tunnels.pdf
This task depends upon

Closed by  Christian Hesse (eworm)
Monday, 10 October 2016, 06:47 GMT
Reason for closing:  Implemented
Additional comments about closing:  iproute2 4.8.0-1

Loading...