<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Generator" content="Microsoft Exchange Server">
<!-- converted from text --><style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style>
</head>
<body>
<div style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:11pt; color:black">
<span style="font-family:Calibri,Arial,Helvetica,sans-serif; font-size:11pt; color:black">How about high lighting it? Some people just skim the text.
<br>
<br>
Sent from my tablet using TouchDown<br>
<br>
<span style="color:black">-----Original Message----- <br>
<b>From:</b> Siep Kroonenberg [siepo@cybercomm.nl]<br>
<b>Received:</b> søndag, 29 jun. 2014, 15:46<br>
<b>To:</b> tex-live@tug.org [tex-live@tug.org]<br>
<b>Subject:</b> Re: [tex-live] [BUG] Upgrade-Description<br>
<br>
</span></span></div>
<font size="2"><span style="font-size:10pt;">
<div class="PlainText">On Sun, Jun 29, 2014 at 08:30:28AM -0400, Haines Brown wrote:<br>
> I believe it is never inappropriate to look at directions critically,<br>
> for they are extraordinarily difficult to write. You have to insert<br>
> yourself into the mental world of someone else, and this is nearly<br>
> impossible to do. Let me give an example. In the TUG directions for<br>
> upgrading from TL2013 to TL2014, steps 7-8 read:<br>
> <br>
>   7. cd to your top-level 2014 directory.<br>
> <br>
>   8. Remove the updmap.cfg file in TEXMFSYSCONFIG that was copied over,<br>
>      which is no longer needed or desirable: <br>
>      rm `kpsewhich -var-value TEXMFSYSCONFIG`/web2c/updmap.cfg <br>
>      mktexlsr `kpsewhich -var-value TEXMFSYSCONFIG`<br>
> <br>
> The "top-level 2014 directory" default would seem to be<br>
> /usr/local/texlive/2014/, but it would be helpful to say so lest a<br>
> person think the top level directory for 2014 is its top, its parent,<br>
> .../texlive/<br>
> <br>
> Some may not know what the kpsewhich -a command does and thus the logic<br>
> of the rm command. A description of what the command does would be<br>
> comforting to the user. Is the rm command run by root or user? The<br>
> answer might be intuitive for one person, but not at all for someone<br>
> feeling insecure. Directions must assume the latter.<br>
> <br>
> I did a default installation of TL2013, and the value it assigned to the<br>
> TEXMFSYSCONFIG variable was<br>
> /usr/local/texlive/2013/texmf-config. Unfortutely, /web2c/updmap.cfg is<br>
> not in that directory but instead is in /usr/local/texlive/texmf-local/.<br>
> I knew the value of TEXMFSYSCONFIG only because I kept the notes I took<br>
> during installation, but most users I suppose would not know what the<br>
> value is and so be unable to debug the TL2014 installation directions.<br>
> <br>
> Haines Brown<br>
<br>
The instructions start out with:<br>
<br>
  We do not provide a dedicated upgrade script. This procedure is not<br>
  bullet-proof, or especially recommended; consider it provided as-is,<br>
  to be used at your own risk. It's your responsibility to understand<br>
  what is being done.          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^<br>
  ^^^^^^^^^^^^^^^^^^^<br>
<br>
  If you have any doubts, please do a new installation instead of<br>
  blindly proceeding here.<br>
<br>
Should this not be enough warning?<br>
<br>
-- <br>
Siep Kroonenberg<br>
<br>
<br>
</div>
</span></font>
</body>
</html>