Fix a review comments on special methods [skip appveyor]

Signed-off-by: Mats Wichmann <[email protected]>

doc/user/builders-commands.xml

@@ -166,7 +166,10 @@ env.Command('${SOURCE.base}.out', File('foo.in'), build)
 
   </para>
 
-  <tip><para>
+  <tip>
+    <title>Sidebar: Node Special Attributes</title>
+
+  <para>
 
   The example uses a <firstterm>Node special attribute</firstterm>
   (<literal>.base</literal>, the file without its suffix),
@@ -184,7 +187,8 @@ env.Command('${SOURCE.base}.out', File('foo.in'), build)
   (see <xref linkend="sect-creating-nodes"/>),
   which is the approach used in the example.
 
-  </para></tip>
+  </para>
+  </tip>
 
   <para>
 

doc/user/environments.xml

@@ -1876,6 +1876,8 @@ env = Environment()
 env.Command('foo', [], '__ROOT__/usr/bin/printenv.py')
       </file>
       <file name="__ROOT__/usr/bin/printenv.py" chmod="0o755">
+#!/usr/bin/env python
+
 import os
 import sys
 
@@ -2133,7 +2135,7 @@ env.SomeTool(targets, sources)
       </para>
 
 <sconstruct>
-# For Windows based on the python version and install directory, this may be something like
+# For Windows based on the Python version and install directory, this may be something like
 C:\Python35\Lib\site-packages\someinstalledpackage\SomeTool.py
 C:\Python35\Lib\site-packages\someinstalledpackage\SomeTool\__init__.py
 
@@ -2172,10 +2174,10 @@ env.SomeTool(targets, sources)
       To avoid the use of a prefix within the name of the tool or filtering
       <varname>sys.path</varname> for directories,
       we can use &f-link-PyPackageDir; function to locate the directory of
-      the python package.
+      the &Python; package.
       &f-PyPackageDir; returns a Dir object which represents the path of the
       directory
-      for the python package / module specified as a parameter.
+      for the &Python; package / module specified as a parameter.
       </para>
 
       <sconstruct>