Review Request 124328: Man pages for kapidox

[David Faure]

> On July 12, 2015, 4:45 p.m., Kevin Krammer wrote:
> > I thought our man pages are written in docbook and then translated by the usual docbook workflow?
> 
> Albert Astals Cid wrote:
>     Correct.
> 
> Luigi Toscano wrote:
>     Yes, because they can be translated. But that means a dependency on kdoctools. On the other side, kapidox is a tier1 (I would say tier0) project, it's python, it's not really Qt based. I don't have a proper solution for this problem right now.
> 
> Scott Kitterman wrote:
>     It's really different than the other frameworks.  It's not a framework as much as a tool (Python application) for developing the frameworks.  I don't think it can/should be done exactly the same as everything else.
> 
> Albert Astals Cid wrote:
>     I'm not happy for not keeping our requeriment that our user visible stuff is translatable.
> 
> Scott Kitterman wrote:
>     The --help output (which is the only documentation that's currently provided) is already not translatable, so this is no different.

This is not user visible. It's not even visible to application developers, IIUC.
It's an internal tool, much like kde-dev-scripts (in fact this stuff could have been put in kde-dev-scripts...), where none of the scripts have translatable help.


- David


-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://git.reviewboard.kde.org/r/124328/#review82397
-----------------------------------------------------------


On July 12, 2015, 4 p.m., Scott Kitterman wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://git.reviewboard.kde.org/r/124328/
> -----------------------------------------------------------
> 
> (Updated July 12, 2015, 4 p.m.)
> 
> 
> Review request for KDE Frameworks, Alex Merry, Aurélien Gâteau, and Kevin Krammer.
> 
> 
> Repository: kapidox
> 
> 
> Description
> -------
> 
> Add man pages for kapidox scripts
> 
> 
> Diffs
> -----
> 
>   docs/depdiagram-generate-all.1 PRE-CREATION 
>   docs/depdiagram-generate.1 PRE-CREATION 
>   docs/depdiagram-prepare.1 PRE-CREATION 
>   docs/kgenapidox.1 PRE-CREATION 
>   docs/kgenframeworksapidox.1 PRE-CREATION 
>   setup.py 083543f 
> 
> Diff: https://git.reviewboard.kde.org/r/124328/diff/
> 
> 
> Testing
> -------
> 
> Built and installed updated version and verified man pages were correctly installed and readable in the KDE man page viewer.
> 
> 
> Thanks,
> 
> Scott Kitterman
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-frameworks-devel/attachments/20150713/b0774a40/attachment-0001.html>