docs(list): moving the actual documentation on the header

- The documentation on the header allow u to see on the files where the
header is inclued

includes/list.h

@@ -6,7 +6,7 @@
 /*   By: rparodi <rparodi@student.42.fr>            +#+  +:+       +#+        */
 /*                                                +#+#+#+#+#+   +#+           */
 /*   Created: 2024/10/31 15:00:12 by rparodi           #+#    #+#             */
-/*   Updated: 2025/09/01 16:34:41 by rparodi          ###   ########.fr       */
+/*   Updated: 2025/09/05 16:24:23 by rparodi          ###   ########.fr       */
 /*                                                                            */
 /* ************************************************************************** */
 
@@ -19,14 +19,78 @@ typedef struct s_list
 	struct s_list	*next;
 }					t_list;
 
+/**
+ * @brief Give the size of the chained list
+ *
+ * @param lst the chained list
+ * @return the size of the list
+ */
 int		ft_lstsize(t_list *lst);
+
+/**
+ * @brief Found the last element of the chained list
+ *
+ * @param lst the chained list
+ * @return the last element of the chained list
+ */
 t_list	*ft_lstlast(t_list *lst);
+
+/**
+ * @brief Create an other list from an old one with a function on all element
+ *
+ * @param lst the chained list
+ * @param f the function to function to iterate
+ * @param del The function to delete the old list
+ * @return The list edited by the function given by f
+ */
 t_list	*ft_lstmap(t_list *lst, void *(*f)(void *), void (*del)(void *));
+
+/**
+ * @brief Allocate a new list with the first element
+ *
+ * @param content the element to give on first element
+ * @return the new list
+ */
 t_list	*ft_lstnew(void *content);
+
+/**
+ * @brief Add the list new to the back of chained list of lst
+ *
+ * @param lst first element of the list
+ * @param new The element to add at the end
+ */
 void	ft_lstadd_back(t_list **lst, t_list *new);
+
+/**
+ * @brief Add the list new to the front of chained list of lst
+ *
+ * @param lst first element of the list
+ * @param new The element to add at the start
+ */
 void	ft_lstadd_front(t_list **lst, t_list *new);
+
+/**
+ * @brief Clear the all list with the function
+ *
+ * @param lst the start of the chained list
+ * @param del the function to clear the list
+ */
 void	ft_lstclear(t_list **lst, void (*del)(void *));
+
+/**
+ * @brief Clear the element of the list with the function
+ *
+ * @param lst the element of the list to be clear
+ * @param del the function to clear the list
+ */
 void	ft_lstdelone(t_list *lst, void (*del)(void *));
+
+/**
+ * @brief Apply the fstunction given in arguments at all the element of the list
+ *
+ * @param lst the chained list
+ * @param f the pointer to function
+ */
 void	ft_lstiter(t_list *lst, void (*f)(void *));
 
 #endif