tools,v.doc: move vlib/v/doc/ to cmd/tools/vdoc/doc/ to reduce the runtime of the CI runs, when v doc is changed (#23483)

Author: spytheman

TESTS.md

@@ -188,7 +188,7 @@ tests in the main V repository, for example:
 
 > [!NOTE]
 The VDOC test vdoc_file_test.v now also supports VAUTOFIX, which is
-useful, if you change anything inside cmd/tools/vdoc or vlib/v/doc/,
+useful, if you change anything inside cmd/tools/vdoc,
 or inside the modules that it depends on (like markdown).
 After such changes, just run this command *2 times*, and commit the
 resulting changes in `cmd/tools/vdoc/testdata` as well:

vlib/v/doc/comment.v renamed to cmd/tools/vdoc/doc/comment.v

@@ -536,28 +536,28 @@ pub fn generate(input_path string, pub_only bool, with_comments bool, platform P
 	if platform == .js {
 		return error('vdoc: Platform `${platform}` is not supported.')
 	}
-	mut doc := new(input_path)
-	doc.pub_only = pub_only
-	doc.with_comments = with_comments
-	doc.filter_symbol_names = filter_symbol_names.filter(it.len != 0)
-	doc.prefs.os = if platform == .auto {
+	mut d := new(input_path)
+	d.pub_only = pub_only
+	d.with_comments = with_comments
+	d.filter_symbol_names = filter_symbol_names.filter(it.len != 0)
+	d.prefs.os = if platform == .auto {
 		pref.get_host_os()
 	} else {
 		unsafe { pref.OS(int(platform)) }
 	}
-	doc.generate()!
-	return doc
+	d.generate()!
+	return d
 }
 
 // generate_with_pos has the same function as the `generate` function but
 // accepts an offset-based position and enables the comments by default.
 pub fn generate_with_pos(input_path string, filename string, pos int) !Doc {
-	mut doc := new(input_path)
-	doc.pub_only = false
-	doc.with_comments = true
-	doc.with_pos = true
-	doc.filename = filename
-	doc.pos = pos
-	doc.generate()!
-	return doc
+	mut d := new(input_path)
+	d.pub_only = false
+	d.with_comments = true
+	d.with_pos = true
+	d.filename = filename
+	d.pos = pos
+	d.generate()!
+	return d
 }

vlib/v/doc/doc.v renamed to cmd/tools/vdoc/doc/doc.v

@@ -43,5 +43,5 @@ fn test_get_parent_mod_normal_cases() {
 	assert get_parent_mod(os.join_path(@VMODROOT, 'vlib', 'os', 'os.v'))? == 'os'
 	assert get_parent_mod(os.join_path(@VMODROOT, 'cmd'))? == ''
 	assert get_parent_mod(os.join_path(@VMODROOT, 'cmd', 'tools', 'modules', 'testing',
-		'common.v'))? == 'testing'
+		'common.v'))? == 'tools.modules.testing'
 }

vlib/v/doc/doc_private_fn_test.v renamed to cmd/tools/vdoc/doc/doc_private_fn_test.v

@@ -1,5 +1,5 @@
 // import v.ast
-import v.doc
+import doc
 
 // fn test_generate_with_pos() {}
 // fn test_generate() {}

vlib/v/doc/doc_test.v renamed to cmd/tools/vdoc/doc/doc_test.v

@@ -107,7 +107,7 @@ pub fn merge_doc_comments(comments []DocComment) string {
 			for key in highlight_keys {
 				if ll.starts_with(key) {
 					comment += '\n\n${key.title()}${l[key.len..]}'
-					// Workaround for compiling with `v -cstrict -cc gcc vlib/v/doc/doc_test.v`
+					// Workaround for compiling with `v -cstrict -cc gcc cmd/tools/vdoc/doc/doc_test.v`
 					// and using multiple continue `<label>`.
 					continue_line_loop = true
 					break

vlib/v/doc/module.v renamed to cmd/tools/vdoc/doc/module.v

@@ -8,7 +8,7 @@ import markdown
 import v.scanner
 import v.ast
 import v.token
-import v.doc
+import doc
 import v.pref
 import v.util { tabs }
 

vlib/v/doc/node.v renamed to cmd/tools/vdoc/doc/node.v

@@ -3,7 +3,7 @@ module main
 import os
 import os.cmdline
 import term
-import v.doc
+import doc
 import v.vmod
 
 const vexe = os.getenv_opt('VEXE') or { @VEXE }