FPGA: Add examples about where the include files are used (oneapi-src#1020)

* libraries use case initial commit

Signed-off-by: Yohann Uguen <yohann.uguen@intel.com>

* use br

Signed-off-by: Yohann Uguen <yohann.uguen@intel.com>

* fix onchip entry

Signed-off-by: Yohann Uguen <yohann.uguen@intel.com>

* limiting to 3 entries

Signed-off-by: Yohann Uguen <yohann.uguen@intel.com>

* update to master

Signed-off-by: Yohann Uguen <yohann.uguen@intel.com>

Author: yuguen

DirectProgramming/DPC++FPGA/include/README.md

@@ -5,25 +5,25 @@ This directory contains utility header libraries optimized for SYCL*-compliant F
 
 ### Utilities
 
-| Filename                     | Description
----                            |---
-| `constexpr_math.hpp`           | Defines utilities for statically computing math functions (for example, Log2 and Pow2).
-| `memory_utils.hpp`             | Generic functions for streaming data from memory to a SYCL pipe and vise versa.
-| `metaprogramming_utils.hpp`    | Defines various metaprogramming utilities (for example, generating a power of 2 sequence and checking if a type has a subscript operator).
-| `onchip_memory_with_cache.hpp` | Class that contains an on-chip memory array with a register backed cache to achieve high performance read-modify-write loops.
-| `pipe_utils.hpp`               | Utility classes for working with pipes, such as PipeArray.
-| `rom_base.hpp`                 | A generic base class to create ROMs in the FPGA using and initializer lambda or functor.
-| `tuple.hpp`                    | Defines a template to implement tuples.
-| `unrolled_loop.hpp`            | Defines a templated implementation of unrolled loops.
+| Filename                      | Description                                                                                                                               | Use case examples
+---                             |---                                                                                                                                        |---
+| `constexpr_math.hpp`          | Defines utilities for statically computing math functions (for example, Log2 and Pow2).                                                   | `ReferenceDesigns/merge_sort/`<br> `ReferenceDesigns/qrd`<br> `ReferenceDesigns/qri`
+| `memory_utils.hpp`            | Generic functions for streaming data from memory to a SYCL pipe and vise versa.                                                           | `ReferenceDesigns/decompress/`
+| `metaprogramming_utils.hpp`   | Defines various metaprogramming utilities (for example, generating a power of 2 sequence and checking if a type has a subscript operator).| `ReferenceDesigns/decompress/`<br> `include/unrolled_loop.hpp`
+| `onchip_memory_with_cache.hpp`| Class that contains an on-chip memory array with a register backed cache to achieve high performance read-modify-write loops.             | `Tutorials/DesignPatterns/onchip_memory_cache/`<br> `ReferenceDesigns/decompress/`<br> `ReferenceDesigns/db/`
+| `pipe_utils.hpp`              | Utility classes for working with pipes, such as PipeArray.                                                                                | `Tutorials/DesignPatterns/pipe_array/`<br> `ReferenceDesigns/merge_sort/`<br> `ReferenceDesigns/gzip/`
+| `rom_base.hpp`                | A generic base class to create ROMs in the FPGA using and initializer lambda or functor.                                                  | `ReferenceDesigns/anr/`
+| `tuple.hpp`                   | Defines a template to implement tuples.                                                                                                   | `ReferenceDesigns/cholesky_inversion/`<br> `ReferenceDesigns/qri/`<br> `ReferenceDesigns/cholesky/`
+| `unrolled_loop.hpp`           | Defines a templated implementation of unrolled loops.                                                                                     | `Tutorials/DesignPatterns/pipe_array/`<br> `ReferenceDesigns/cholesky/`<br> `ReferenceDesigns/anr/`
 
 ### Linear Algebra
 
-| Filename               | Description
----                      |---
-| `streaming_qrd.hpp`      | QR decomposition of matrices with pipe interfaces.
-| `streaming_qri.hpp`      | QR-based inversion of matrices with pipe interfaces.
-| `streaming_cholesky.hpp` | Cholesky decomposition of matrices with pipe interfaces.
-| `streaming_cholesky_inversion.hpp` | Cholesky-based inversion of matrices with pipe interfaces.
+| Filename                           | Description                                                | Use case examples
+---                                  |---                                                         |---
+| `streaming_qrd.hpp`                | QR decomposition of matrices with pipe interfaces.         | `ReferenceDesigns/qrd`
+| `streaming_qri.hpp`                | QR-based inversion of matrices with pipe interfaces.       | `ReferenceDesigns/qri`
+| `streaming_cholesky.hpp`           | Cholesky decomposition of matrices with pipe interfaces.   | `ReferenceDesigns/cholesky`
+| `streaming_cholesky_inversion.hpp` | Cholesky-based inversion of matrices with pipe interfaces. | `ReferenceDesigns/cholesky_inversion`
 
 ## License