Re: [gentoo-dev] markdown docs like README.md

[Kent Fredric]

On 25 September 2013 12:33, Tom Wijsman <TomWij@g.o> wrote:

> The existence of a tool does not exclude that an ebuild cannot use it;
> so, I agree with your paragraph but that doesn't necessarily mean we can
> apply this in an ebuild context.
>

I guess I can agree I would be amenable to a scenario where you could do
either.

Gentoo is about choices, and if its viable that we provide the choice to
generate the alternative formats during build so that a user doesn't have
to invoke a command to generate the alternative format later, then why not?

Recipients who don't want the overhead of disk cruft can just omit the
relevant useflags and get only documentation in its source form ( with
maybe a hints file generated by the domd commands instead of performing the
full translation )

Just I should make a strong suggestion that such alternative formats should
be generated during src_build , *NOT* src_install, mostly due to the
differences in privilege separation under userpriv, a problem that has
caused at least one bug in the past (
https://bugs.gentoo.org/show_bug.cgi?id=454058 )


-- 
Kent