From 6b171b43acef2d92f39418d3d1eebf3cb8721840 Mon Sep 17 00:00:00 2001
From: Mats Wichmann <mats@linux.com>
Date: Sun, 3 May 2020 08:58:28 -0600
Subject: Tweaks to manpage special modifiers wording  [ci skip]

Signed-off-by: Mats Wichmann <mats@linux.com>
---
 doc/man/scons.xml | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/doc/man/scons.xml b/doc/man/scons.xml
index cd840b6..1e7964f 100644
--- a/doc/man/scons.xml
+++ b/doc/man/scons.xml
@@ -6168,6 +6168,18 @@ when a path references a file on other (POSIX) systems.</para>
   </varlistentry>
 
   <varlistentry>
+  <term><parameter>windows</parameter></term>
+  <listitem>
+<para>The path with directories separated by backslashes.
+(<emphasis role="bold"><literal>\\</literal></emphasis>).
+Sometimes necessary on POSIX-style systems
+when a path references a file on other (Windows) systems.
+<parameter>win32</parameter> is a (deprecated) synonym for
+<parameter>windows</parameter>.</para>
+  </listitem>
+  </varlistentry>
+
+  <varlistentry>
   <term><parameter>srcpath</parameter></term>
   <listitem>
 <para>The directory and file name to the source file linked to this file through
@@ -6233,6 +6245,13 @@ ${SOURCE.rsrcpath}   =&gt; /usr/repository/src/file.x
 ${SOURCE.rsrcdir}    =&gt; /usr/repository/src
 </literallayout>
 
+<para>
+Modifiers can be combined, like
+<literal>${TARGET.base.windows}</literal>,
+<literal>${TARGET.srcpath.base)</literal>,
+<literal>${TARGET.file.suffix}</literal>, etc.
+</para>
+
 <para>Note that curly braces braces may also be used
 to enclose arbitrary Python code to be evaluated.
 (In fact, this is how the above modifiers are substituted,
@@ -6483,7 +6502,9 @@ and an optional fourth:
     Use <function>str</function>(<parameter>node</parameter>)
     to fetch the name of the file, and
     <replaceable>node</replaceable>.<function>get_contents</function>()
-    to fetch the contents of the file.
+    to fetch the contents of the file as bytes or
+    <replaceable>node</replaceable>.<function>get_text_contents</function>()
+    to fetch the contents as text.
     Note that the file is
     <emphasis>not</emphasis>
     guaranteed to exist before the scanner is called,
-- 
cgit v0.12