Documentation:Windows Section 2.1 - Revision history

Jholsenback: generic version

2017-07-04T11:42:18Z

generic version

Clipka: /* Adding or Changing Allowed Directories */ version in file path

2017-07-01T08:37:53Z

Adding or Changing Allowed Directories: version in file path

Clipka: indexentry fix

2016-05-03T22:52:57Z

indexentry fix

Jholsenback: fix an image tag

2013-02-10T19:24:45Z

fix an image tag

Chrisc: /* High-Level Configuration */

2013-02-02T04:20:09Z

High-Level Configuration

Chrisc: /* High-Level Configuration */

2013-02-02T03:08:12Z

High-Level Configuration

Jholsenback: adjusting section break

2013-01-30T21:54:19Z

adjusting section break

Show changes

Chrisc: A few updates for I/O restrictions

2013-01-29T17:46:58Z

A few updates for I/O restrictions

Chrisc: /* Hints for Match Brace */

2013-01-29T17:26:23Z

Hints for Match Brace

Chrisc: /* The Language Setting */

2013-01-29T17:24:44Z

The Language Setting

@@ Line 216: / Line 216: @@
 </pre>
 <p>
-for example, to refer to (say) <code>C:\Users\Joe\Documents\POV-Ray\v3.8\scenes</code>.
+for example, to refer to (say) <code>C:\Users\Joe\Documents\POV-Ray\vX.y\scenes</code>.
 </p>

@@ Line 216: / Line 216: @@
 </pre>
 <p>
-for example, to refer to (say) <code>C:\Users\Joe\Documents\POV-Ray\3.7\Scenes</code>.
+for example, to refer to (say) <code>C:\Users\Joe\Documents\POV-Ray\v3.8\scenes</code>.
 </p>

@@ Line 8: / Line 8: @@
 <!--</wikitalk>--->
 ===I/O Restrictions===
-{{#indexentry:I/O Restrictions|Restrictions, Input/Output|Security, File I/O|File I/O, restrictions}}
+{{#indexentry:I/O Restrictions}}
 <p>
 I/O Restrictions are a feature introduced in POV-Ray v3.5. The purpose of this feature

@@ Line 61: / Line 61: @@
 <tr>
    <td>
-     [[Image:win-iorestrictions.png|center|427px<!--right--->]]
+     [[Image:win-iorestrictions.png|center|427px<!--centered--->]]
    </td>
 </tr>

@@ Line 61: / Line 61: @@
 <tr>
    <td>
-     [[Image:win-iorestrictions.png|center|570px<!--right--->]]
+     [[Image:win-iorestrictions.png|center|427px<!--right--->]]
    </td>
 </tr>

@@ Line 55: / Line 55: @@
 ====High-Level Configuration====
 <table class="centered" width="700x" cellpadding="0" cellspacing="10">
 <tr>
    <td>
-    <p>Now to the details: how to configure the I/O Restrictions (or get them out of your hair if
+     [[Image:win-iorestrictions.png|center|570px<!--right--->]]
    </td>
 </tr>
 <tr>
    <td>
-     <p class="caption">Script I/O restrictions drop down</p>
+     <p class="caption">Script I/O Restrictions sub-menu</p>
    </td>
 </tr>
 </table>
 ====Overall Options====

@@ Line 449: / Line 449: @@
 <p>
 If this option is chosen. POV scripts can read anything, but file creation and file write
-is only allowed in the specified directories (see <!--<linkto "Low-Level Configuration">Low-Level Configuration</linkto>--->[[Documentation:Windows Section 2.1#Low-Level Configuration|Low-Level Configuration]]
+is only allowed in the implicit and user-specified directories (see <!--<linkto "Low-Level Configuration">Low-Level Configuration</linkto>--->[[Documentation:Windows Section 2.1#Low-Level Configuration|Low-Level Configuration]]
 for more information on how to specify which directories).
 </p>
@@ Line 460: / Line 460: @@
 ====Restrict Read/Write====
 <p>
-Both read and write by POV scripts is restricted to specified directories. Note that
+Both read and write by POV scripts is restricted to implicit and user-specified directories. Note that
 this is the default setting for a clean installation of POV-Ray for Windows.
 </p>
@@ Line 498: / Line 498: @@
 If this option is selected (the default), shell-outs will not be permitted. 'Shell Outs'
 are a facility where an INI file can specify that a particular program be run either before
-or after a frame is rendered. If you want these, you have to explicitly allow them by
+or after a frame is rendered as well as at other points in the parse/render process.
-unchecking this option.
+If you want these, you have to explicitly allow them by unchecking this option.
 </p>
@@ Line 513: / Line 513: @@
 The overall concept of the I/O Restrictions, when enabled, is that everything should be denied
 unless it is explicitly allowed (with one or two exceptions). So unless you add a directory
-to the 'allowed' list, unless it is the current directory and the 'Permit Read/Write in Current
+to the 'allowed' list, unless it is one of the implicitly allowed locations then the directory
-Directory' option is checked, then the directory in question is not permitted to be accessed.
+in question is not permitted to be accessed.
 </p>
 <p>
-The exceptions are as follows:
+The exceptions to the 'deny everything' rule (referred to above as 'implicit' locations) are as follows:
 </p>
 <ol>
-<li>The document installation directory of POV-Ray for Windows (as given by the registry) is permitted
+<li>
-to be used for read (but not write). This includes all subdirectories of the install directory
+The document installation directory of POV-Ray for Windows (as given by the registry or otherwise
-(except as below). Note that you can alter this setting if you like.
+determined at run-time) is permitted to be used for read (but not write). This includes all of its
+subdirectories (except as below). Note that you can alter this setting if you like.
-<li>The INI subdirectory contained within the POV-Ray for Windows document install directory, as given
+</li>
-by the registry, is permanently write-protected (unless the I/O Restriction system is turned
+<li>
-off). Even if you grant permission to write this dir from the below INI file, writes will not
+Write is permitted to the 'Insert Menu' sub-directory within the POV-Ray documents install directory.
-succeed. This is to prevent the INI file that contains the I/O Restriction configuration from
+This is to enable the 'Re-render Insert Menu Bitmaps' feature to function without needing to modify the restrictions.
-being modified by a script to grant itself more access next time POVWIN is run.
+</li>
 </ol>
 ====Adding or Changing Allowed Directories====
 <p>
 To add or change allowed directories, you'll need to modify the file <code>&lt;installdir&gt;\ini\pvengine.ini</code>,
@@ Line 554: / Line 565: @@
 <p>
-If they are not present, it means that POVWIN is using the defaults, in which case you may add them.
+If they are not present, it means that POVWIN is using the defaults, in which case you may add them. For
 </p>
 <p>

@@ Line 329: / Line 329: @@
 </table>
-=====European Users and Match Brace=====
+=====Hints for Match Brace=====
 <p>
 Several European users have commented that the default key assignment for 'Match Brace'
 (Ctrl-]) is not usable on their keyboards. Please note that you can change this to whatever
-you please (they assumed that it was not changeable when, in fact, it is).
+you please. Another thing to remember about the match brace command is that it only works if it is
 executed when the edit caret is on a brace character ('{', '}', '(', ')', '[', ']'). The caret
 will then jump to the matching character (e.g. if it's on a '(', it will jump to the matching ')').

@@ Line 360: / Line 360: @@
 <strong>This change affects only the current file and no other file !</strong> The change you have made
 will be remembered by POV-Ray. Any file that is still in the MRU list (or the 'Older File'
-list - see the <!--<linkto "File Menu">File Menu</linkto>--->[[Documentation:Windows Section 5#File Menu|File Menu]] section for more details) has its
+list - see the <!--<linkto "File Menu">File Menu</linkto>--->[[Documentation:Windows Section 5#File Menu|File Menu]] section for more details) has its language setting stored along with a number of other file-specific attributes.
 </p>