chore: rewrite docstrings with generics

src/dbms/dbms.v

@@ -80,7 +80,7 @@ pub fn init(db_path string) !VieterDb {
 	}
 }
 
-// row_into<T> converts an sqlite.Row into a given type T by parsing each field
+// row_into[T] converts an sqlite.Row into a given type T by parsing each field
 // from a string according to its type.
 pub fn row_into[T](row sqlite.Row) T {
 	mut i := 0

src/models/models.v

@@ -2,7 +2,7 @@ module models
 
 import time
 
-// from_params<T> creates a new instance of T from the given map by parsing all
+// from_params[T] creates a new instance of T from the given map by parsing all
 // of its fields from the map.
 pub fn from_params[T](params map[string]string) ?T {
 	mut o := T{}
@@ -12,7 +12,7 @@ pub fn from_params[T](params map[string]string) ?T {
 	return o
 }
 
-// patch_from_params<T> updates the given T object with the params defined in
+// patch_from_params[T] updates the given T object with the params defined in
 // the map.
 pub fn patch_from_params[T](mut o T, params map[string]string) ? {
 	$for field in T.fields {
@@ -36,7 +36,7 @@ pub fn patch_from_params[T](mut o T, params map[string]string) ? {
 	}
 }
 
-// params_from<T> converts a given T struct into a map of strings.
+// params_from[T] converts a given T struct into a map of strings.
 pub fn params_from[T](o &T) map[string]string {
 	mut out := map[string]string{}
 

src/util/stream.v

@@ -48,7 +48,7 @@ pub fn reader_to_file(mut reader io.BufferedReader, length int, path string) ! {
 	}
 }
 
-// match_array_in_array<T> returns how many elements of a2 overlap with a1. For
+// match_array_in_array[T] returns how many elements of a2 overlap with a1. For
 // example, if a1 = "abcd" & a2 = "cd", the result will be 2. If the match is
 // not at the end of a1, the result is 0.
 pub fn match_array_in_array[T](a1 []T, a2 []T) int {

src/web/response/response.v

@@ -15,7 +15,7 @@ pub fn new_response(message string) Response[string] {
 	}
 }
 
-// new_data_response<T> constructs a new Response<T> object with the given data
+// new_data_response[T] constructs a new Response<T> object with the given data
 // & an empty message field.
 pub fn new_data_response[T](data T) Response[T] {
 	return Response[T]{
@@ -24,7 +24,7 @@ pub fn new_data_response[T](data T) Response[T] {
 	}
 }
 
-// new_full_response<T> constructs a new Response<T> object with the given
+// new_full_response[T] constructs a new Response<T> object with the given
 // message & data.
 pub fn new_full_response[T](message string, data T) Response[T] {
 	return Response[T]{

src/web/web.v

@@ -157,7 +157,7 @@ pub fn (mut ctx Context) body(status http.Status, content_type string, body stri
 	return Result{}
 }
 
-// json<T> HTTP_OK with json_s as payload with content-type `application/json`
+// json[T] HTTP_OK with json_s as payload with content-type `application/json`
 pub fn (mut ctx Context) json[T](status http.Status, j T) Result {
 	ctx.status = status
 	ctx.content_type = 'application/json'