Review Request 127747: Create a new script that generate the documentation for all projects following the syntax I proposed

[Olivier Churlaud]

> On April 26, 2016, 1:16 a.m., Albert Astals Cid wrote:
> > metainfo.yaml, line 13
> > <https://git.reviewboard.kde.org/r/127747/diff/2/?file=460336#file460336line13>
> >
> >     This is already in line 3, doesn't seem like a good idea to duplicate the information.
> 
> Olivier Churlaud wrote:
>     There is no "Tier" in Calligra. So if I don't propose something else than "tier: X", I cannot generate and group the doc of Calligra, or kdelibsgames. Else I have to do a special case for frameworks, which will be more difficult to maintain.

Just to be clearer: the key 'tier' is not used by my kapidox proposition. I left it because I don't know what runs over metainfo.yml and I don't want to break everything. So for me it's more a back-compatibility thing, that is expected to disappear. Again, if it is really a bad idea, then please help me to find a scheme that can be used by every one, without duplicate info and without modifying the current keys of metainfo.yml (!!). It seems hard :)


- Olivier


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


On April 25, 2016, 11:49 p.m., Olivier Churlaud wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://git.reviewboard.kde.org/r/127747/
> -----------------------------------------------------------
> 
> (Updated April 25, 2016, 11:49 p.m.)
> 
> 
> Review request for KDE Frameworks, Albert Astals Cid, Alex Merry, Aurélien Gâteau, and Allen Winter.
> 
> 
> Repository: kapidox
> 
> 
> Description
> -------
> 
> Keep in mind that it should not plainly replace kgenframeworks but be used by all KDE projects. So in this proposition, the Frameworks are just one project in others.
> 
> The code can be tested directly by checking the branch `olivier/generate_all_repos`.
> 
> This MUST NOT be merged in master, because it will break the currents scripts (see commit 3643dded7cf14a5634879e8e6e34be8840143d7e).
> 
> 
> Diffs
> -----
> 
>   konqi_frameworks.png PRE-CREATION 
>   metainfo.yaml 4ff17c8 
>   metainfo_syntax.md PRE-CREATION 
>   src/kapidox/data/htmlresource/default_product.png PRE-CREATION 
>   src/kapidox/data/htmlresource/kde.css b864ef5 
>   src/kapidox/data/templates/doxygen2.html PRE-CREATION 
>   src/kapidox/data/templates/frontpage.html PRE-CREATION 
>   src/kapidox/data/templates/libinfo.html PRE-CREATION 
>   src/kapidox/data/templates/maintainers.html PRE-CREATION 
>   src/kapidox/data/templates/subgroup.html PRE-CREATION 
>   src/kapidox/generator.py 5b8ae40 
>   src/newkapidox.py PRE-CREATION 
>   src/notes PRE-CREATION 
> 
> Diff: https://git.reviewboard.kde.org/r/127747/diff/
> 
> 
> Testing
> -------
> 
> Tested on various scenario cases.
> 
> 
> File Attachments
> ----------------
> 
> This is an example of what I generated. (Threadweaver is duplicated and modified to test different scenarios)
>   https://git.reviewboard.kde.org/media/uploaded/files/2016/04/25/2e4549e4-7c17-416c-9a72-b82d3bba18b3__doc.tar.gz
> 
> 
> Thanks,
> 
> Olivier Churlaud
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-frameworks-devel/attachments/20160426/6aefc5a7/attachment.html>