summaryrefslogtreecommitdiff
path: root/support/bundledoc/arlatex.1
diff options
context:
space:
mode:
Diffstat (limited to 'support/bundledoc/arlatex.1')
-rw-r--r--support/bundledoc/arlatex.120
1 files changed, 10 insertions, 10 deletions
diff --git a/support/bundledoc/arlatex.1 b/support/bundledoc/arlatex.1
index 8ffce4fe1a..17807b103a 100644
--- a/support/bundledoc/arlatex.1
+++ b/support/bundledoc/arlatex.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
+.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "ARLATEX 1"
-.TH ARLATEX 1 "2018-05-23" "v1.03" "User Commands"
+.TH ARLATEX 1 "2022-10-04" "v1.1" "User Commands"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -272,14 +272,14 @@ might use in a \fBbundledoc\fR configuration file:
See the \fBbundledoc\fR documentation for more information.
.SH "CAVEATS"
.IX Header "CAVEATS"
-\&\fBarlatex\fR makes use of LaTeX2e's \f(CW\*(C`filecontents*\*(C'\fR environment.
-\&\f(CW\*(C`filecontents*\*(C'\fR refuses to overwrite an existing file. However, it
-also refuses to create a file that exists \fIanywhere\fR that LaTeX can
-find it. That is, if the user running \fBlatex\fR on an
-\&\fBarlatex\fR\-generated \fI.tex\fR file already has a
-\&\fI/usr/share/texmf/tex/latex/whatever/whatever.sty\fR file then
-\&\f(CW\*(C`filecontents*\*(C'\fR will refuse to create a \fIwhatever.sty\fR file, even in
-a different directory.
+\&\fBarlatex\fR makes use of LaTeX's \f(CW\*(C`filecontents*\*(C'\fR environment. It
+passes \f(CW\*(C`filecontents*\*(C'\fR the \f(CW\*(C`overwrite\*(C'\fR option to indicate that
+existing files with the same name should be overwritten. Be
+forewarned that building the generated file will overwrite the files
+used to create it.
+.PP
+It is best to avoid bundling binary files (e.g., included graphics)
+with \fBarlatex\fR. These typically do not extract cleanly.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBbundledoc\fR\|(1), \fBlatex\fR\|(1), \fBshar\fR\|(1), \fBtar\fR\|(1), \fBzip\fR\|(1)