docs,ci: check more vlib modules in the report-missing-dots-in-doc-comments job (#24928)

Author: spytheman

.github/workflows/docs_ci.yml

@@ -65,4 +65,8 @@ jobs:
       - name: Build V
         run: make
       - name: Check doc comment dots for some key modules
-        run: ./v run cmd/tools/find_doc_comments_with_no_dots.v vlib/builtin/ vlib/arrays/ vlib/flag/ vlib/bitfield/
+        run: ./v run cmd/tools/find_doc_comments_with_no_dots.v \
+          vlib/builtin/ vlib/arrays/ vlib/flag/ \
+          vlib/bitfield/ vlib/term/ vlib/strings/ \
+          vlib/rand/ vlib/compress/ vlib/clipboard/ \
+          vlib/os

vlib/clipboard/clipboard_darwin.c.v

@@ -41,15 +41,13 @@ pub fn (mut cb Clipboard) clear() {
 	//#[cb->pb clearContents];
 }
 
-// free releases all memory associated with the clipboard
-// instance.
+// free releases all memory associated with the clipboard instance.
 pub fn (mut cb Clipboard) free() {
 	cb.foo = 0
 	// nothing to free
 }
 
-// has_ownership returns true if the contents of
-// the clipboard were created by this clipboard instance.
+// has_ownership returns true if the contents of the clipboard were created by this clipboard instance.
 pub fn (cb &Clipboard) has_ownership() bool {
 	if cb.last_cb_serial == 0 {
 		return false
@@ -66,8 +64,7 @@ pub fn (mut cb Clipboard) set_text(text string) bool {
 	return C.darwin_set_pasteboard_text(cb.pb, text)
 }
 
-// get_text retrieves the contents of the system clipboard
-// as a `string`.
+// get_text retrieves the contents of the system clipboard.
 // This is often associated with a *paste* action (`Cmd` + `V`).
 pub fn (mut cb Clipboard) get_text() string {
 	cb.foo = 0

vlib/clipboard/clipboard_windows.c.v

@@ -115,8 +115,7 @@ pub fn (cb &Clipboard) check_availability() bool {
 	return cb.hwnd != unsafe { nil }
 }
 
-// has_ownership returns true if the contents of
-// the clipboard were created by this clipboard instance.
+// has_ownership returns true if the contents of the clipboard were created by this clipboard instance.
 pub fn (cb &Clipboard) has_ownership() bool {
 	return voidptr(C.GetClipboardOwner()) == cb.hwnd
 }
@@ -131,8 +130,7 @@ pub fn (mut cb Clipboard) clear() {
 	cb.foo = 0
 }
 
-// free releases all memory associated with the clipboard
-// instance.
+// free releases all memory associated with the clipboard instance.
 pub fn (mut cb Clipboard) free() {
 	C.DestroyWindow(cb.hwnd)
 	cb.foo = 0
@@ -180,8 +178,7 @@ pub fn (mut cb Clipboard) set_text(text string) bool {
 	return true
 }
 
-// get_text retrieves the contents of the system clipboard
-// as a `string`.
+// get_text retrieves the contents of the system clipboard.
 // This is often associated with a *paste* action (`Ctrl` + `V`).
 pub fn (mut cb Clipboard) get_text() string {
 	cb.foo = 0

vlib/clipboard/dummy/dummy_clipboard.v

@@ -32,8 +32,7 @@ pub fn (mut cb Clipboard) set_text(text string) bool {
 	return true
 }
 
-// get_text retrieves the contents of the system clipboard
-// as a `string`.
+// get_text retrieves the contents of the system clipboard.
 // This is often associated with a *paste* action (`Ctrl` + `V`).
 pub fn (mut cb Clipboard) get_text() string {
 	return cb.text
@@ -45,13 +44,11 @@ pub fn (mut cb Clipboard) clear() {
 	cb.is_owner = false
 }
 
-// free releases all memory associated with the clipboard
-// instance.
+// free releases all memory associated with the clipboard instance.
 pub fn (mut cb Clipboard) free() {
 }
 
-// has_ownership returns true if the contents of
-// the clipboard were created by this clipboard instance.
+// has_ownership returns true if the contents of the clipboard were created by this clipboard instance.
 pub fn (cb &Clipboard) has_ownership() bool {
 	return cb.is_owner
 }

vlib/compress/compress.c.v

@@ -59,8 +59,7 @@ pub fn decompress(data []u8, flags int) ![]u8 {
 // to pass arbitrary data, without having to create a closure.
 pub type ChunkCallback = fn (chunk []u8, userdata voidptr) int
 
-// decompress_with_callback decompresses an array of bytes based on the provided flags,
-// and a V fn callback to receive decompressed chunks, of at most 32 kilobytes each.
+// decompress_with_callback decompresses an array of bytes, based on the provided flags, and a V fn callback to receive decompressed chunks, of at most 32 kilobytes each.
 // It returns the total decompressed length, or a decompression error.
 // NB: this is a low level api, a high level implementation like zlib/gzip should be preferred.
 pub fn decompress_with_callback(data []u8, cb ChunkCallback, userdata voidptr, flags int) !u64 {

vlib/compress/gzip/gzip.v

@@ -203,7 +203,7 @@ pub fn validate(data []u8, params DecompressParams) !GzipHeader {
 	return header
 }
 
-// decompress an array of bytes using zlib and returns the decompressed bytes in a new array
+// decompress an array of bytes using zlib and returns the decompressed bytes in a new array.
 // Example: decompressed := gzip.decompress(b)!
 pub fn decompress(data []u8, params DecompressParams) ![]u8 {
 	gzip_header := validate(data, params)!

vlib/compress/szip/szip.c.v

@@ -65,7 +65,7 @@ pub enum CompressionLevel {
 	default_compression = C.MZ_DEFAULT_COMPRESSION
 }
 
-// OpenMode lists the opening modes
+// OpenMode lists the opening modes.
 // .write: opens a file for reading/extracting (the file must exists).
 // .read_only: creates an empty file for writing.
 // .append: appends to an existing archive.
@@ -214,7 +214,7 @@ pub fn (mut zentry Zip) read_entry() !voidptr {
 	return buf
 }
 
-// read_entry_buf extracts the current zip entry into user specified buffer
+// read_entry_buf extracts the current zip entry into user specified buffer.
 pub fn (mut zentry Zip) read_entry_buf(buf voidptr, in_bsize int) !int {
 	bsize := usize(in_bsize)
 	res := C.zip_entry_noallocread(zentry, buf, bsize)
@@ -232,7 +232,7 @@ pub fn (mut zentry Zip) extract_entry(path string) ! {
 	}
 }
 
-// extract zip file to directory
+// extract zip file to directory.
 pub fn extract_zip_to_dir(file string, dir string) !bool {
 	if C.access(&char(dir.str), 0) == -1 {
 		return error('szip: cannot open directory for extracting, directory not exists')
@@ -241,7 +241,7 @@ pub fn extract_zip_to_dir(file string, dir string) !bool {
 	return res == 0
 }
 
-// zip files (full path) to zip file
+// zip files (full path) to zip file.
 pub fn zip_files(path_to_file []string, path_to_export_zip string) ! {
 	// open or create new zip
 	mut zip := open(path_to_export_zip, .no_compression, .write) or { panic(err) }

vlib/compress/zstd/zstd.c.v

@@ -458,7 +458,7 @@ mut:
 	ctx &C.ZSTD_CCtx
 }
 
-// new_cctx create a compression context
+// new_cctx create a compression context.
 // extra compression parameters can be set by `params`
 pub fn new_cctx(params CompressParams) !&CCtx {
 	mut ctx := C.ZSTD_createCCtx()
@@ -492,7 +492,7 @@ pub fn (mut c CCtx) compress_stream2(output &OutBuffer, input &InBuffer, mode En
 	return res
 }
 
-// free_cctx free a compression context
+// free_cctx free a compression context.
 pub fn (mut c CCtx) free_cctx() usize {
 	return C.ZSTD_freeCCtx(c.ctx)
 }
@@ -506,7 +506,7 @@ mut:
 	ctx &C.ZSTD_DCtx
 }
 
-// new_dctx creates a decompression context
+// new_dctx creates a decompression context.
 // extra decompression parameters can be set by `params`
 pub fn new_dctx(params DecompressParams) !&DCtx {
 	mut ctx := C.ZSTD_createDCtx()

vlib/os/debugger_darwin.c.v

@@ -5,7 +5,7 @@ module os
 
 fn C.ptrace(int, u32, voidptr, int) int
 
-// debugger_present returns a bool indicating if the process is being debugged
+// debugger_present returns a bool indicating if the process is being debugged.
 pub fn debugger_present() bool {
 	$if macos {
 		// check if a child process could trace its parent process,

vlib/os/debugger_freebsd.c.v

@@ -4,7 +4,7 @@ module os
 
 fn C.ptrace(int, u32, voidptr, int) int
 
-// debugger_present returns a bool indicating if the process is being debugged
+// debugger_present returns a bool indicating if the process is being debugged.
 pub fn debugger_present() bool {
 	$if freebsd {
 		// check if a child process could trace its parent process,