Improve docs usage links (#653)

src/modules/function/declaration.rs

@@ -286,8 +286,9 @@ impl DocumentationModule for FunctionDeclaration {
             for reference in references {
                 result.push(reference);
             }
-            result.push("\n".to_string());
+            result.push("".to_string());
         }
+        result.push("".to_string());
         result.join("\n")
     }
 }
@@ -317,13 +318,24 @@ impl FunctionDeclaration {
             result.push(String::from("```\n"));
             if test_path.exists() && test_path.is_dir() {
                 if let Ok(entries) = fs::read_dir(test_path) {
-                    let pattern = format!("{}*.ab", self.name);
-                    let pattern = glob::Pattern::new(&pattern).unwrap();
+                    let pattern1 = {
+                        let pattern = format!("{}*.ab", self.name);
+                        glob::Pattern::new(&pattern).unwrap()
+                    };
+                    let pattern2 = {
+                        let pattern = format!("{}_{}*.ab", lib_name, self.name);
+                        glob::Pattern::new(&pattern).unwrap()
+                    };
                     for entry in entries.flatten() {
                         let path = entry.path();
                         if let Some(file_name) = path.file_name().and_then(OsStr::to_str) {
-                            if pattern.matches(file_name) {
-                                references.push(format!("* [{}](https://github.com/amber-lang/amber/blob/{}/src/tests/stdlib/{})", file_name, env!("CARGO_PKG_VERSION"), file_name));
+                            if pattern1.matches(file_name) || pattern2.matches(file_name) {
+                                references.push(format!(
+                                    "* [{}](https://github.com/amber-lang/amber/blob/{}/src/tests/stdlib/{})",
+                                    file_name,
+                                    env!("CARGO_PKG_VERSION"),
+                                    file_name,
+                                ));
                             }
                         }
                     }

src/modules/statement/comment_doc.rs

@@ -70,6 +70,6 @@ impl TranslateModule for CommentDoc {
 
 impl DocumentationModule for CommentDoc {
     fn document(&self, _meta: &ParserMetadata) -> String {
-        self.value.clone() + "\n\n"
+        self.value.trim_end().to_string() + "\n"
     }
 }

src/std/fs.ab

@@ -54,9 +54,9 @@ pub fun dir_create(path: Text): Null {
     }
 }
 
-/// Sets a file as executable.
+/// Changes the permission bits of a file.
 ///
-/// If the file doesn't exist, it returns a boolean and prints a message.
+/// If the file doesn't exist, it returns `false` and prints a message.
 pub fun file_chmod(path: Text, mode: Text): Bool {
     if file_exists(path) {
         trust $ chmod "{mode}" "{path}" $
@@ -69,7 +69,7 @@ pub fun file_chmod(path: Text, mode: Text): Bool {
 
 /// Changes the owner of a file.
 ///
-/// If the file doesn't exist, it returns `false`
+/// If the file doesn't exist, it returns `false` and prints a message.
 pub fun file_chown(path: Text, user: Text): Bool {
     if file_exists(path) or dir_exists(path) {
         trust $ chown -R "{user}" "{path}" $

src/std/text.ab

@@ -45,7 +45,7 @@ pub fun split_words(text: Text): [Text] {
     return split(text, " ")
 }
 
-/// Merges text using the delimeter specified.
+/// Merges text using the delimiter specified.
 pub fun join(list: [Text], delimiter: Text): Text {
     return trust $ IFS="{delimiter}" ; echo "\$\{{nameof list}[*]}" $
 }