Review Request 124328: Man pages for kapidox

Scott Kitterman kde at kitterman.com
Tue Jul 14 13:30:12 UTC 2015



> 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.
> 
> David Faure wrote:
>     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.
> 
> Allen Winter wrote:
>     then I drop my objection. I can read troff well enough :)

OK.  Does that mean I can go back to Alex Merry's shipit and push the change?


- Scott


-----------------------------------------------------------
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/20150714/796cbdc6/attachment.html>


More information about the Kde-frameworks-devel mailing list