[Mesa-dev] [RPF PATCH 8/8] docs: add todo.txt for various Mesa tasks

[Samuel Pitoiset]

My main concern with a todo like this is that it will probably be 
unmaintained at some point. :)

On 08/21/2017 04:46 AM, Timothy Arceri wrote:
> Generally I'm not a huge fan of todo.txt files as they tend to not
> get updated. However we have a faily active community looking for
> ways to contribute and wiki pages tend to be forgotten about even
> more easily as well as being more onerous to update.
> 
> features.txt although more specific has been successful IMO partly
> due to its simplicity, if others are open to the idea I'd like to
> give it a go for all those little tasks we never get around to.
> 
> If we can stick to a standard layout we might be able to get the
> guys from mesamatrix to ingest it for greater exposure/prettier
> formating.
> 
> Let me know what you think.
> ---
>   docs/helpwanted.html |  2 ++
>   docs/todo.txt        | 38 ++++++++++++++++++++++++++++++++++++++
>   2 files changed, 40 insertions(+)
>   create mode 100644 docs/todo.txt
> 
> diff --git a/docs/helpwanted.html b/docs/helpwanted.html
> index 9b7b5e0004..cd60b37844 100644
> --- a/docs/helpwanted.html
> +++ b/docs/helpwanted.html
> @@ -42,20 +42,22 @@ issues in the code.
>   <p>
>   You can find some further To-do lists here:
>   </p>
>   
>   <p>
>   <b>Common To-Do lists:</b>
>   </p>
>   <ul>
>     <li><a href="https://cgit.freedesktop.org/mesa/mesa/tree/docs/features.txt">
>       <b>features.txt</b></a> - Status of OpenGL 3.x / 4.x features in Mesa.</li>
> +  <li><a href="https://cgit.freedesktop.org/mesa/mesa/tree/docs/todo.txt">
> +    <b>todo.txt</b></a> - Various Mesa development tasks.</li>
>   </ul>
>   
>   <p>
>   <b>Legacy Driver specific To-Do lists:</b>
>   </p>
>   <ul>
>     <li><a href="https://dri.freedesktop.org/wiki/R600ToDo">
>       <b>r600g</b></a> - Driver for ATI/AMD R600 - Northern Island.</li>
>     <li><a href="https://dri.freedesktop.org/wiki/R300ToDo">
>       <b>r300g</b></a> - Driver for ATI R300 - R500.</li>
> diff --git a/docs/todo.txt b/docs/todo.txt
> new file mode 100644
> index 0000000000..95c6d29b02
> --- /dev/null
> +++ b/docs/todo.txt
> @@ -0,0 +1,38 @@
> +Mesa Develoment tasks:
> +----------------------
> +
> +------------------------------------------------------------------------------
> +Easy:
> +------------------------------------------------------------------------------
> +
> +Use union rather than struct for storing program atrributes in gl_program
> +------------------------------------------------------------------------------
> +
> +Drivers: i915, swrast (classic driver)
> +
> +Benefits: small memory reduction (all drivers)
> +
> +Requirements:
> +
> +C program experience, ideally i915 hardware for testing, but swrast might be
> +enough. i915 can be tested via Intels jenkins instance once patches completed.
> +
> +swrast can be built by adding swrast to --with-dri-drivers="" when building,
> +then tested using the LIBGL_ALWAYS_SOFTWARE=1 env var.
> +
> +Task:
> +
> +Use a union in the gl_program struct (see mtypes.h)
> +
> +We should be able to make this struct a union, since the program should be
> +either an asm program or a glsl shader. However some drivers
> +(i915/fragment_programs, swrast/prog_execute) mix the use of these fields.
> +
> +------------------------------------------------------------------------------
> +Medium:
> +------------------------------------------------------------------------------
> +
> +
> +------------------------------------------------------------------------------
> +Hard:
> +------------------------------------------------------------------------------
>