# HG changeset patch
# User Hartmut Goebel <h.goebel@crazy-compilers.com>
# Date 1477568028 -7200
# Node ID 4e5f42d51cc473bbbc3f7b144f5d73b2de634152
# Parent  fb35b9db9ca11264965b28f1f84d0490108468e5
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.

diff -r fb35b9db9ca1 -r 4e5f42d51cc4 features.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   >>
diff -r fb35b9db9ca1 -r 4e5f42d51cc4 toolchain.en.yhtml2
--- 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