[Bf-docboard] security considerations about building the new blender manual ...

[Campbell Barton]

Why would make be less secure than sphinx-build?

On Thu, Sep 25, 2014 at 8:32 PM, Gaia <gaia.clary at machinimatrix.org> wrote:
> Troubled has pointed out in #blendercoders that running "make"
> on the new sphinx based document system is potentially
> dangerous and could even damage the documentor's computer.
> While the chance seems small that this really happens, it still
> seems to be one of the reasons why we do not yet get an
> automated documentation build system.
>
> I think that all documentors should be made aware
> of this problem here:
>
>      https://developer.blender.org/project/view/53/
>
> I believe that adding a remark about security and how to
> generate the documentation on a local computer more
> securely is important.
>
> Troubled mentioned the following alternative to make would
> be a safe way to build the docs:
>
>      sphinx-build -b html ./manual ./html
>
> The above mentioned document proposes to use the evil
> make instead ...
>
> cheers,
> Gaia
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard



-- 
- Campbell