[latex3-commits] [git/LaTeX3-latex3-l3build] master: docu to keep author/email secret (575e883)

[Will Robertson]

Repository : https://github.com/latex3/l3build
On branch  : master
Link       : https://github.com/latex3/l3build/commit/575e8839e393cce7f6936d8c6eaa15016706f69b

>---------------------------------------------------------------

commit 575e8839e393cce7f6936d8c6eaa15016706f69b
Author: Will Robertson <wspr81 at gmail.com>
Date:   Mon Jan 7 15:32:04 2019 +0800

    docu to keep author/email secret


>---------------------------------------------------------------

575e8839e393cce7f6936d8c6eaa15016706f69b
 l3build.dtx |    8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/l3build.dtx b/l3build.dtx
index 88f65f8..7674b3d 100644
--- a/l3build.dtx
+++ b/l3build.dtx
@@ -1305,12 +1305,19 @@
 %
 % Note that the \texttt{upload} target will \emph{not} execute the \texttt{ctan} target first.
 %
+% \paragraph{Announcement text}
 % It can be convenient not to include the announcement text within the |build.lua| file
 % directly. The command line argument |--message| (|-m|) allows the announcement to be
 % included as part of the |l3build| arguments, and |--file| (|-F|) reads the announcement
 % from a specified file. Note that if the announcement text is omitted a `silent update'
 % is performed; this should usually be performed for minor bug or documentation fixes only.
 %
+% \paragraph{Uploader details}
+% The CTAN team use the uploader details (name and email) as a form of low-security sanity
+% check that the upload is coming from a reputable source. Therefore, it is advisable not
+% to store this information within a public |build.lua| file and instead use a private
+% configuration file to add this information at upload time.
+%
 % \begin{table}[p]
 %   \def\YES{\textbullet}
 %   \caption{Fields used in the \texttt{uploadconfig} setup table. The first section of fields are \emph{required} and if they are omitted the user will be interactively prompted for further input. Most commands take string input, but those that are indicated with `Multi' accept more than one entry using an array of strings.}
@@ -1355,7 +1362,6 @@
 %       summary     = "Mark vertical rules in margin of text",
 %       ctanPath    = "/macros/latex/contrib/vertbars",
 %       repository  = "https://github.com/wspr/herries-press/",
-%       uploader    = "Will Robertson",
 %       update      = true,
 %     }
 %   \end{lstlisting}