Update tests, examples, documentation:

1. Add a dependency path example;
2. Update `new_dependency` test;
3. Update help manual.

Author: zoziha

example_packages/hello_fpm_path/app/main.f90

@@ -0,0 +1,10 @@
+program hello_fpm
+    use utils1_m, only: say_hello1
+    use utils1_1_m, only: say_hello1_1
+    use utils2_m, only: say_hello2
+
+    call say_hello1()
+    call say_hello1_1()
+    call say_hello2()
+
+end program hello_fpm

example_packages/hello_fpm_path/crate/utils1/fpm.toml

@@ -0,0 +1,4 @@
+name = "utils1"
+
+[dependencies]
+utils1_1 = { path = "../utils1_1" }

example_packages/hello_fpm_path/crate/utils1/src/say_hello.f90

@@ -0,0 +1,11 @@
+module utils1_m
+
+    implicit none
+    
+contains
+    
+    subroutine say_hello1()
+        print '(a)', "Hello, utils1."
+    end subroutine say_hello1
+
+end module utils1_m

example_packages/hello_fpm_path/crate/utils1_1/fpm.toml

@@ -0,0 +1 @@
+name = "utils1_1"

example_packages/hello_fpm_path/crate/utils1_1/src/say_hello.f90

@@ -0,0 +1,11 @@
+module utils1_1_m
+
+    implicit none
+    
+contains
+    
+    subroutine say_hello1_1()
+        print '(a)', "Hello, utils1_1."
+    end subroutine say_hello1_1
+
+end module utils1_1_m

example_packages/hello_fpm_path/crate/utils2/fpm.toml

@@ -0,0 +1 @@
+name = "utils2"

example_packages/hello_fpm_path/crate/utils2/src/say_hello.f90

@@ -0,0 +1,11 @@
+module utils2_m
+
+    implicit none
+    
+contains
+    
+    subroutine say_hello2()
+        print '(a)', "Hello, utils2."
+    end subroutine say_hello2
+
+end module utils2_m

example_packages/hello_fpm_path/fpm.toml

@@ -0,0 +1,5 @@
+name = "hello_fpm_path"
+
+[dependencies]
+utils1 = { path = "crate/utils1" }
+utils2 = { path = "crate/utils2" }

src/fpm/cmd/new.f90

@@ -369,8 +369,8 @@ subroutine cmd_new(settings)
         &'                                                                                ',&
         &'#M_strings = { path = "M_strings" }                                             ',&
         &'                                                                                ',&
-        &'  #  If you specify paths outside of your repository (ie. paths with a          ',&
-        &'  #  slash in them) things will not work for your users!                        ',&
+        &'  # This tells fpm that we depend on a crate called M_strings which is found    ',&
+        &'  # in the M_strings folder (relative to the fpm.toml it’s written in).         ',&
         &'  #                                                                             ',&
         &'  # For a more verbose layout use normal tables rather than inline tables       ',&
         &'  # to specify dependencies:                                                    ',&

test/fpm_test/test_package_dependencies.f90

@@ -186,6 +186,9 @@ subroutine test_add_dependencies(error)
         call new_dependencies(nodes, table, error=error)
         if (allocated(error)) return
 
+        call new_dependencies(nodes, table, root='.', error=error)
+        if (allocated(error)) return
+
         call new_dependency_tree(deps%dependency_tree_t)
         call deps%add(nodes, error)
         if (allocated(error)) return