docs: Include files are always searched at standard location, too.
authorHartmut Goebel <h.goebel@crazy-compilers.com>
Thu, 27 Oct 2016 13:33:48 +0200
changeset 44 4e5f42d51cc4
parent 43 fb35b9db9ca1
child 45 4ac3bb01f0bc
docs: Include files are always searched at standard location, too.

This removes the need to specify the location where yml2 was unpacked or
installed as YML_PATH. So this now works:

YML_PATH=/foo ./yml2proc --xml2yml

The standard system location <prefix>/share/yml2 is now always appended to
the include search path. If this path does not exist, the directory one
above the `backend.py` file is added, allowing the same behaviour for
uninstalled yml2.

In the Makefile enforce the .ysl2 files to be searched in the current
directory first.
features.en.yhtml2
toolchain.en.yhtml2
--- a/features.en.yhtml2	Tue Mar 17 10:26:38 2020 +0100
+++ b/features.en.yhtml2	Thu Oct 27 13:33:48 2016 +0200
@@ -975,6 +975,7 @@
         if the «YML_PATH» environment variable is set to a colon separated list of directories,
         these directories are being searched for the given filename. Otherwise, the local
         directory is searched.
+        The system location for «.yml2» and «.ysl2» files is always searched afterwards.
         >>
 
     p   >>
--- a/toolchain.en.yhtml2	Tue Mar 17 10:26:38 2020 +0100
+++ b/toolchain.en.yhtml2	Thu Oct 27 13:33:48 2016 +0200
@@ -87,6 +87,7 @@
         If «YML_PATH» is set to a colon separated ¬http://en.wikipedia.org/wiki/Path_(computing) path¬
         list, then the `a href="features#including" code "include";` statement searches these paths.
         If «YML_PATH» is not set, the local directory «.» is searched for files.
+        The system location for «.yml2» and «.ysl2» files is always searched afterwards.
         >>
 
     h2 id=processor > The YML/YSLT processor
@@ -218,8 +219,6 @@
 
     p > Convert XML to normalized YML. Equivalent to -xy xml2yml.ysl2
 
-    p > The file xml2yml.ysl2 has to be in YML_PATH.
-
     h3 > -V, --version
 
     p   >>
@@ -233,6 +232,7 @@
         If «YML_PATH» is set to a colon separated ¬http://en.wikipedia.org/wiki/Path_(computing) path¬
         list, then the `a href="features#including" code "include";` statement searches these paths.
         If «YML_PATH» is not set, the local directory «.» is searched for files.
+        The system location for «.yml2» and «.ysl2» files is always searched afterwards.
         >>
     
     h2 id=recommended > Recommended external tools