Bug 57063

Summary: Slightly misleading comment in texmf.cnf
Product: [Retired] Red Hat Raw Hide Reporter: Michal Jaegermann <michal>
Component: tetexAssignee: Tim Waugh <twaugh>
Status: CLOSED RAWHIDE QA Contact: David Lawrence <dkl>
Severity: low Docs Contact:
Priority: medium    
Version: 1.0   
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2001-12-06 11:00:34 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Michal Jaegermann 2001-12-03 22:46:06 UTC 
Description of Problem:
A comment in /usr/share/texmf/web2c/texmf.cnf says:

% Now, list all the texmf trees. If you have multiple trees you can
% use shell brace notation, like this:
%   TEXMF = {$HOMETEXMF,!!$TEXMFLOCAL,!!$TEXMFMAIN}

This should likely rather be "{!!$HOMETEXMF,".  A line just below is:

TEXMF = {!!$HOMETEXMF,!!$TEXMFMAIN}

but somebody new may not catch right away what is the meaning of
this difference.

A comment to a sample TEXMFLOCAL should also likely explain that
a tree below this directory has to be created.  A minimum would
be 'tex/generic/'.  Otherwise somebody will drop new files in
$TEXMFLOCAL and s/he will start to wonder why they are not found
even after rehashing was done.

Version-Release number of selected component (if applicable):
tetex-1.0.7-36.4
Comment 1 Tim Waugh 2001-12-06 11:00:29 UTC 
The '!!' construct is explained near the top of the file.

I've added a comment about how to use HOMETEXMF though, including an 
instruction to run texhash on it.
Comment 2 Tim Waugh 2001-12-11 09:47:10 UTC 
Fixed in tetex-1.0.7-37.