[latexrefman-commits] [SCM] latexrefman updated: r785 - trunk

[vincentb1 at gnu.org.ua]

Author: vincentb1
Date: 2020-04-05 16:26:26 +0300 (Sun, 05 Apr 2020)
New Revision: 785

Modified:
   trunk/latex2e-fr.texi
Log:
[fr] Apply Karl's r782.

* latex2e-fr.texi (\write): Align menu description on Karl's r782.
(\write18, Command line options): Recopy nodes from English ?\226?\128?\148 they still need translation.


Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2020-04-05 13:12:55 UTC (rev 784)
+++ trunk/latex2e-fr.texi	2020-04-05 13:26:26 UTC (rev 785)
@@ -4,7 +4,7 @@
 @setfilename latex2e-fr.info
 @documentlanguage fr
 @documentencoding UTF-8
- at set UPDATED Mars 2020
+ at set UPDATED Avril 2020
 @include common.texi
 @settitle Manuel de référence officieux de @LaTeX{}2e (@value{UPDATED})
 @comment % ** fin de tête (c'est pour courir Texinfo sur une région.)
@@ -14440,8 +14440,8 @@
 
 @c xxx que veut dire "part of a line"
 @menu
-* \message::          Écrit du texte vers le fichier et le terminal.
-* \wlog::             Écrit vers le journal.
+* \message::          Écrit du texte vers le fichier journal et le terminal.
+* \wlog::             Écrit du texte vers le fichier journal.
 * \write18::          Exécute une commande du système d'exploitation.
 @end menu
 
@@ -14539,7 +14539,7 @@
 @c xxx À traduire
 @findex \write18
 @cindex external commands
- at cindex commands, run from LaTeX
+ at cindex commands, run from @LaTeX{}
 @cindex system commands, run from @LaTeX{}
 @cindex shell access
 @c Derived from: Joseph Wright: https://tex.stackexchange.com/a/20446/121234
@@ -14601,6 +14601,7 @@
 Live or Mac at TeX{} or @code{latex --enable-write18 @var{nomfichier}} for
 MiK at TeX{} (@pxref{Command line options}).
 
+ at cindex restricted shell access
 In the place of full shell access, modern distributions by default use a
 restricted version that allows some commands to work, such as those that
 run Metafont to generate missing fonts, even if you do not use the
@@ -14611,12 +14612,16 @@
 
 Some packages need to run external system commands. For instance
 @file{sagetex} allows you to have the mathematics software system
- at i{Sage} do calculations or draw graphs and then incorporate that output
-in your document. For this you must compile with full @code{\write18}
-capability turned on.
+ at i{Sage} do calculations or draw graphs and then incorporate that
+output in your document. For this you must run @LaTeX{} with full
+ at code{\write18} capability turned on.
 
+ at PkgIndex{texosquery} If what you need is system information, such as
+the operating system name, locale information, or directory contents,
+take a look at the @file{texosquery} package, which provides a
+convenient and secure interface for this:
+ at url{https://ctan.org/pkg/texosquery}.
 
-
 @node Command line
 @chapter Ligne de commande
 @cindex ligne de commande
@@ -14734,6 +14739,7 @@
 @item -help
 Give a brief usage message that is useful as a prompt and exit.
 
+ at anchor{interaction modes}
 @findex --interaction @r{command-line option}
 @item -interaction=@var{mode}
 @TeX{} compiles a document in one of four interaction modes:
@@ -14770,7 +14776,7 @@
 @code{\input} instruction and the name of the input file will be the job
 name. This is used to name the log file the output file.  The
 @code{jobname} option overrides that process and directly specifies the
-name.  @xref{Command line input} for an example of its use.
+name.  @xref{Command line input}, for an example of its use.
 
 @anchor{output directory}
 @cindex output directory for all external files
@@ -14789,31 +14795,26 @@
 checked for input files.
 
 @cindex shell escape
+ at cindex @code{\write18}, enabling
+ at findex --enable-write18 @r{command-line option}
+ at findex --disable-write18 @r{command-line option}
 @findex --shell-escape @r{command-line option}
 @findex --no-shell-escape @r{command-line option}
- at findex --enable-write18 @r{command-line option}
- at findex --disable-write18 @r{command-line option}
- at item --shell-escape
+ at item --enable-write18
+ at itemx --disable-write18
+ at itemx --shell-escape
 @itemx --no-shell-escape
- at itemx --enable-write18
- at itemx --disable-write18
 Enable or disable @code{\write18@{@var{shell_command}@}}
-(@pxref{\write18}).  The first two options are for with @TeX{} Live or
-Mac at TeX{} while the second two are for MiK at TeX{}.
+(@pxref{\write18}).  The first two options are supported by both
+ at TeX{} Live and MiK at TeX{}, while the second two are synonyms supported
+by @TeX{} Live.
 
- at PkgIndex{sagetex}
-Sometimes you want to run external system commands from inside a
- at LaTeX{} file. For instance the package @file{sagetex} allows you to
-have the mathematics software system @i{Sage} do calculations or draw
-graphs and then incorporate that output in your document.  For this
- at TeX{} provides the @code{\write18} command.
+Enabling this functionality has major security implications, since it
+allows a @LaTeX{} file to run any command whatsoever.  Thus, by
+default, unrestricted @code{\write18} is not allowed.  (The default
+for @TeX{} Live, Mac at TeX{}, and MiK at TeX{} is to allow the execution of
+a limited number of @TeX{}-related programs, which they distribute.)
 
-But with this functionality enabled, security issues could happen if
-you compiled a @LaTeX{} file from the Internet.  By default,
-unrestricted @code{\write18} is not allowed.  (The default for @TeX{}
-Live, Mac at TeX{}, and MiK at TeX{} is to allow the execution of a limited
-number of @TeX{}-related programs, which they distribute.)
-
 For example, if you invoke @LaTeX{} with the option
 @code{no-shell-escape}, and in your document you call
 @code{\write18@{ls -l@}}, then you do not get an error but the log