Generate man page for docbook/xml file. *fix install location for man page.

Authored by mreeves on Apr 29 2018, 9:06 PM.

Description

Generate man page for docbook/xml file. *fix install location for man page.

Details

Committed
mreevesApr 29 2018, 9:06 PM
Parents
R983:f2913ab269ab: add man page
Branches
Unknown
Tags
Unknown
Reverted By
R983:a81aeb5052cd: Revert "Generate man page for docbook/xml file."

I would suggest to ask for a review from the documentation team; also, committing the man page the day before the release prevent any translation and review.

/CMakeLists.txt
51

This is not needed; the existing macros can take care of it.

/doc/en/man-kdiff3.1.docbook
2

Please use the KDE DTD for manpages. Check any other program which ships a manpage, like kdoctools, kate, keditbookmarks, cervisia, etc

17

QT -> Qt

In general, I would rewrite that manpage from scratch, using the following template:
https://phabricator.kde.org/source/kdoctools/browse/master/src/man-template.docbook

I would not use the existing content, because the license of this manpage does not follow the KDE Licensing Policy:
https://community.kde.org/Policies/Licensing_Policy

tl;dr if you want to release now, please remove this manpage. If you want a proper manpage, remove it anyway and give it some time for the release.

I can remove the man page and delay release. I want to do this right. How
are is this normally handled?