소스 검색

init: Update doc for non-interactive jobs (#1753)

- Remove GRASS_BATCH_JOB from the documentation (removed in aeff9f46465154bac239227dc3fc1f2247d24100).
- Non-interactive jobs section now part of the Description section, not environmental variables section.
- Flags section removed, moved to Description sec as Config flag sec (only flag described there).
Vaclav Petras 3 년 전
부모
커밋
5a76c704e9
2개의 변경된 파일12개의 추가작업 그리고 14개의 파일을 삭제
  1. 12 10
      lib/init/grass.html
  2. 0 4
      lib/init/variables.html

+ 12 - 10
lib/init/grass.html

@@ -110,7 +110,18 @@ specified exists and that you can access it successfully. If any of
 these checks fail then <em>grass</em> will automatically switch back
 to the text user interface mode.
 
-<h2>FLAGS</h2>
+<h3>Running non-interactive jobs</h3>
+
+The <b>--exec</b> flag can run an executable on path, GRASS module, or a script.
+All are executed as a subprocess and any additional arguments are passed to it.
+A script needs to be specified by full or relative path and on unix-likes systems,
+the script file must have its executable bit set. Calling the interpreter
+(e.g., <code>python</code>) and providing the script as a parameter is possible, too.
+When it is finished GRASS will automatically exit using the return code given
+by the subprocess. Although the execution itself is non-interactive (no GUI or shell),
+the subprocess itself can be interactive if that is what the user requires.
+
+<h3>Config flag</h3>
 
 The flag <b>--config option</b> prints GRASS GIS configuration and
 version parameters, with the options:
@@ -229,15 +240,6 @@ and <tt>%APPDATA%\Roaming\GRASS8\addons</tt> on MS Windows.
 The GRASS_HTML_BROWSER environment variable allows the user to set the
 HTML web browser to use for displaying help pages.
 
-<h3>Running non-interactive batch jobs</h3>
-
-If the GRASS_BATCH_JOB environment variable is set to the <i>full</i>
-path and filename of a shell script then GRASS will be launched in a
-non-interactive way and the script will be run. The script itself can
-be interactive if that is what the user requires. When it is finished
-GRASS will automatically exit using the exit-success code given by the
-script. The script file must have its executable bit set.
-
 <h2>EXAMPLES</h2>
 
 <p>The following are some examples of how you could start GRASS

+ 0 - 4
lib/init/variables.html

@@ -105,10 +105,6 @@ PERMANENT
   <dd>[libgis, g.findetc]<br>
     specify paths where support files (etc/) may be found external to
     standard distribution.</dd>
-  
-  <dt>GRASS_BATCH_JOB</dt>
-  <dd>defines the name (path) of a shell script to be processed as
-  batch job.</dd>
 
   <dt>GRASS_COMPRESSOR</dt>
   <dd>[libraster]<br>