texlive[43991] Master: Updated sources and documentation for tlaunch
commits+siepo at tug.org
commits+siepo at tug.org
Sun Apr 23 21:06:31 CEST 2017
Revision: 43991
http://tug.org/svn/texlive?view=revision&revision=43991
Author: siepo
Date: 2017-04-23 21:06:31 +0200 (Sun, 23 Apr 2017)
Log Message:
-----------
Updated sources and documentation for tlaunch
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/support/tlaunch/Changes
trunk/Master/texmf-dist/doc/support/tlaunch/README
trunk/Master/texmf-dist/doc/support/tlaunch/figures/custom_ed.png
trunk/Master/texmf-dist/doc/support/tlaunch/tlaunch.pdf
trunk/Master/texmf-dist/doc/support/tlaunch/tlaunch.tex
Added Paths:
-----------
trunk/Master/source/tlaunch-0.5.2-src.zip
Removed Paths:
-------------
trunk/Master/source/tlaunch-0.5.1-src.zip
Deleted: trunk/Master/source/tlaunch-0.5.1-src.zip
===================================================================
(Binary files differ)
Added: trunk/Master/source/tlaunch-0.5.2-src.zip
===================================================================
(Binary files differ)
Index: trunk/Master/source/tlaunch-0.5.2-src.zip
===================================================================
--- trunk/Master/source/tlaunch-0.5.2-src.zip 2017-04-23 13:21:28 UTC (rev 43990)
+++ trunk/Master/source/tlaunch-0.5.2-src.zip 2017-04-23 19:06:31 UTC (rev 43991)
Property changes on: trunk/Master/source/tlaunch-0.5.2-src.zip
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: trunk/Master/texmf-dist/doc/support/tlaunch/Changes
===================================================================
--- trunk/Master/texmf-dist/doc/support/tlaunch/Changes 2017-04-23 13:21:28 UTC (rev 43990)
+++ trunk/Master/texmf-dist/doc/support/tlaunch/Changes 2017-04-23 19:06:31 UTC (rev 43991)
@@ -1,12 +1,14 @@
+2017-02-01 Siep Kroonenberg <siepo at cybercomm.nl> Release 0.5.2
+
+ * Various silent command-line options added
+ * Updated documentation
+
2017-02-01 Siep Kroonenberg <siepo at cybercomm.nl> Release 0.5.1
* Tlaunch uninst options are now called uninst and uninst_all
- rather than uninst_keep_tldir and uninst.
-
+ rather than uninst_keep_tldir and uninst.
* Added -v/--version option and help output
-
* Simpler root texmf.cnf in RUG example files
-
* Reorganized packaging
2017-01-27 Siep Kroonenberg <siepo at cybercomm.nl> Release 0.5.0
Modified: trunk/Master/texmf-dist/doc/support/tlaunch/README
===================================================================
--- trunk/Master/texmf-dist/doc/support/tlaunch/README 2017-04-23 13:21:28 UTC (rev 43990)
+++ trunk/Master/texmf-dist/doc/support/tlaunch/README 2017-04-23 19:06:31 UTC (rev 43991)
@@ -16,11 +16,13 @@
See the manual for placement of tlaunch.exe and tlaunch.ini, and for
customizing the ini file.
-For trying this out on an existing local installation, a script
-tlaunchmode is included which can convert a classic installation
-into a launcher-based one and back. The manual has a section on this
-script which also explains how to install it.
+The launcher is already part of TeX Live. The 2017 installer has an
+option to make the installation launcher-based.
+A script tlaunchmode is included which can convert a classic
+installation into a launcher-based one and back. The manual has a
+section on this script.
+
The file rug.zip contains as an example a more elaborate
configuration, based on the installation at the Rijksuniversiteit
Groningen.
Modified: trunk/Master/texmf-dist/doc/support/tlaunch/figures/custom_ed.png
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/support/tlaunch/tlaunch.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/support/tlaunch/tlaunch.tex
===================================================================
--- trunk/Master/texmf-dist/doc/support/tlaunch/tlaunch.tex 2017-04-23 13:21:28 UTC (rev 43990)
+++ trunk/Master/texmf-dist/doc/support/tlaunch/tlaunch.tex 2017-04-23 19:06:31 UTC (rev 43991)
@@ -1,4 +1,24 @@
\documentclass[11pt,a4paper,oneside]{report}
+
+% narrow margins, same layout
+\AtBeginDocument{%
+ \paperwidth\textwidth
+ \advance\paperwidth48bp
+ \oddsidemargin-48bp
+ \paperheight\textheight
+ \advance\paperheight48bp
+ % no header
+ %\headheight=0bp
+ %\headsep=0bp
+ % otherwise:
+ \advance\paperheight\headheight
+ \advance\paperheight\headsep
+ \advance\paperheight\footskip
+ \topmargin=-48bp
+ \pdfpagewidth=\paperwidth
+ \pdfpageheight=\paperheight
+}
+
% fonts
\usepackage{tgpagella}
\let\slshape\itshape
@@ -45,7 +65,7 @@
\newenvironment{ttdesc}{%
\def\descriptionlabel##1{\hspace\labelsep\ttfamily\selectfont ##1}%
\description}{\enddescription}
-\hyphenation{head-ache}
+\hyphenation{head-ache work-space}
\title{TLaunch: a launcher for a \TL{} system}
\author{Siep Kroonenberg}
@@ -55,7 +75,7 @@
\thispagestyle{empty}
\null\vfill
{\small\parindent=0pt
-This manual is for tlaunch, the \TL{} Launcher, version 0.5.1.
+This manual is for tlaunch, the \TL{} Launcher, version 0.5.2.
Copyright \textcopyright{} 2017 Siep Kroonenberg.
@@ -169,8 +189,7 @@
button or a menu control; see section \ref{sec:utscripts}. Scripts
may also run automatically, as supplemental initialization or
cleanup; see the \texttt{pre\_config}, \texttt{post\_config} and
-\texttt{pre\_forget} variables in table \ref{tab:strings}. Examples
-uses:
+\texttt{pre\_forget} variables in table \ref{tab:strings}. Examples:
\begin{itemize}
\item Forgetting a previous release of \TL{} before configuring the
current one. This only makes sense for a centrally-managed \TeX{}
@@ -190,19 +209,23 @@
The ini file defines the menu items and buttons of the graphical
interface. These controls can start up \GUI{} programs or run
utility scripts, or run some predefined functions. The ini file also
-defines filetype associations, and may define scripts for doing
+defines filetype associations, and may specify scripts for doing
additional configuration and cleanup.
\subsection{Location}
\label{sec:loc}
-One option is to place both the binary and the ini file in the
-root of the \TL{} installation. Another is to place the binary in
-\TL{} binary directory, \texttt{\emph{tlroot}/bin/win32}, and the
-ini file where \texttt{kpsewhich} can find it, \emph{e.g.} in
-\texttt{\emph{tlroot}/texmf-config/web2c}.
+In \TL, the binary is in the \TL{} binary directory,
+\texttt{\emph{tlroot}/bin/win32}, and the ini file is in
+\texttt{\emph{tlroot}/texmf-dist/web2c}. The installer may have
+created a modified higher-priority copy in
+\texttt{\emph{tlroot}/texmf-var/web2c}. A custom
+\texttt{tlaunch.ini} in \texttt{\emph{tlroot}/texmf-config/web2c}
+will override either. In this case, do not forget to update the
+filename database.
-The binary and the ini file should have the same first name.
+Another option is to place both the binary and the ini file in the
+root of the \TL{} installation.
\subsection{Encoding}
\label{sec:enc}
@@ -374,9 +397,11 @@
\item [FU:clear] Undo all configuration and terminate
\item [FU:initialize] Undo all configuration, terminate and
restart. This forces re-initialization.
-\item [FU:editor\_select] See section \ref{sec:edsel} below
-\item [FU:default\_editor] See section \ref{sec:edsel} below
+\item [FU:editor\_select] See section \ref{sec:edsel}
+\item [FU:default\_editor] See section \ref{sec:edsel}
\item [FU:about] An About box
+\item [FU:uninst\_all] See section \ref{sec:lbased}
+\item [FU:uninst] See section \ref{sec:lbased}
\end{ttdesc}
\subsection{Menus and buttons}
@@ -426,7 +451,7 @@
\subsection{The General section}
\label{sec:gen}
-Here, three keywords are allowed:
+This section is optional. Three keywords are allowed:
\begin{ttdesc}
\item[Filetypes] Allowed values are
\begin{itemize}
@@ -433,7 +458,7 @@
\item \texttt{none}: do not set or change filetype associations
\item \texttt{new}: create filetype associations only if they do
not override existing ones; default
- \item \texttt{overwrite} create filetype associations regardless
+ \item \texttt{overwrite}: create filetype associations regardless
of existing ones
\end{itemize}
\item[searchpath] {\sloppy Allowed values are 0 (leave searchpath
@@ -455,7 +480,7 @@
SEARCHPATH=1
KEEPTEMPS=0
\end{verbatim}
-Since these are all default settings, one may as well omit this section.
+The above values are the defaults.
\section{Editor choice}
\label{sec:edsel}
@@ -505,25 +530,35 @@
parameters:
\begin{ttdesc}
-\item[user\_inst] Install the launcher for a single user
+\item[user\_inst] Install the launcher for a single user. This
+ includes doing the first-time initialization as in a regular
+ invokation.
+\item[user\_inst\_silent] Silent single-user install
\item[admin\_inst] Install the launcher for all users
+\item[admin\_inst\_silent] Silent multi-user install
\item[uninst] Undo installation but leave the \TL{}
- directory tree alone
+ directory tree alone. Also runs the forgetter for the current
+ user silently, if it exists.
\item[uninst\_all] Undo installation and remove the \TL{} directory
- tree. This is the only option of these four which touches the \TL{}
- installation itself.
+ tree. Also runs the forgetter for the current user silently, if it
+ exists. This is the only option of these four which touches the
+ \TL{} installation itself.
+\item[silent] (Only for the forgetter) Remove settings silently
\end{ttdesc}
-If there is a forgetter for the current user, both uninst options
-will run it. A command-line option \texttt{silent} will ensure
-that the forgetter will run without user interaction.
+The new launcher mode option of the 2017 \TL{} installer invokes the
+launcher with one of the silent installer options.
-Within the launcher, there are corresponding functions
-\texttt{FU:uninst\_all} and \texttt{FU:uninst} which can be
-assigned to a menu- or button control. If necessary, the launcher
-will pop up a \textsc{uac} prompt and restart in elevated
-mode.
+Within the launcher, there are functions \texttt{FU:uninst\_all} and
+\texttt{FU:uninst} which can be assigned to a menu- or button
+control. If necessary, the launcher will pop up a \textsc{uac}
+prompt and restart in elevated mode.
+If for either the path setting option or the file associations
+option a non-default value was selected, the \TL{} installer creates
+a higher-priority \texttt{tlaunch.ini} with corresponding settings,
+even if launcher mode was not selected.
+
\subsection{The tlaunchmode script}
\label{sec:tlaunchmode}
@@ -531,20 +566,10 @@
installation between classic and launcher-based. Run with a
parameter `on', the script turns launcher mode on; with `off' it
reverts the installation to classic, and anything else prints a
-brief help message.
+brief help message. It is already part of \TL.
It aborts if admin permissions are required but missing.
-It can be installed in the usual way: put it under the scripts
-subdirectory of some texmf tree, run \texttt{mktexlsr} on that tree,
-and copy in the \texttt{\emph{tlroot}\bslb bin\bslb win32} directory
-\texttt{runscript.exe} to \texttt{tlaunchmode.exe}.
-
-Although at the moment there is no mechanism to make the path- and
-file association settings in the ini file conform to those set
-during a classic installation, those orginal settings are restored
-when converting back to classic mode.
-
\subsection{\TeX{} Live Manager}
Nothing special has been done for the \TL{} Manager. It can be
@@ -552,7 +577,8 @@
sense for a centrally managed network installation. If necessary it
will automatically pop up a \textsc{uac} prompt.
-\chapter[The launcher at the RUG]{The launcher at the Rijksuniversiteit Groningen}
+\chapter[The launcher at the RUG]{The launcher at the
+ Rijksuniversiteit Groningen}
\label{chap:rug}
\begin{figure}[tb]
@@ -613,8 +639,8 @@
This desktop is also available remotely, which works reasonably well
most of the time.
-For \TL, I submit a wish list of settings to the workspace
-management people, and they enter everything into the RES
+For \TL, I submit a wish list of settings to be captured to the
+workspace management people, and they enter everything into the RES
system. Unfortunately, the RES system has its quirks, and what I
expect to happen is not always what actually does happen. But this
is not the place to expand on my trials and tribulations with RES.
@@ -720,9 +746,9 @@
In the absence of any registry settings, SumatraPDF assumes that it
is a portable setup, and tries to write user configuration to its
-own directory. Its developers informed me what registry setting
-would convince SumatraPDF otherwise, so that it would write its
-configuration data to the user's profile.
+own directory. Following advise from its developers, I created a
+registry setting to convince SumatraPDF otherwise, and let it write
+its configuration data to the user's profile.
Checks for updates are disabled in a similar way as for \TS.
@@ -745,17 +771,16 @@
\section{Moving the \XeTeX{} font cache}
\label{sec:xecache}
-{\sloppy At the time of writing, the default location of the
- \XeTeX{} font cache in \TL{} is \texttt{\$TEXMFYSVAR/\dbr
- fonts/\dbr cache}, \emph{i.e.} \texttt{\emph{tlroot}/\dbr
- texmf-var/\dbr fonts/\dbr cache}. In a multi-user or network
- install, this location is not user-writable. Since this was a
- problem, a line
+The default location of the \XeTeX{} font cache in \TL{} is
+\texttt{\$TEXMFYSVAR/\dbr fonts/\dbr cache}, \emph{i.e.}
+\texttt{\emph{tlroot}/\dbr texmf-var/\dbr fonts/\dbr cache}. In a
+multi-user or network install, this location is not
+user-writable. Since this was a problem, a line
\begin{verbatim}
FC_CACHEDIR = $TEXMFVAR/fonts/cache
\end{verbatim}
in the file \texttt{\emph{tlroot}/\dbr texmf.cnf} moved the cache to a
-user-writable location.\par}
+user-writable location.
Since I generate the \TL{} installation on a Linux system, the
configured \TL{} font paths in \texttt{\$TEXMFSYSVAR/\dbr fonts/\dbr
More information about the tex-live-commits
mailing list