Bug 29525

Summary: hier(7) has sometimes-erroneous descriptions of tmp dirs.
Product: Documentation Reporter: Gary W. Swearingen <swear>
Component: Books & ArticlesAssignee: Murray Stokely <murray>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Gary W. Swearingen 2001-08-08 04:40:01 UTC 
The descriptions in hier(7) of /tmp and /var/tmp may lead users to make
inefficient or dangerous-to-their-data usage of the directories.  The
descriptions state policies of tmp file deletion that are not in effect
on many systems which don't bother to make a custom hier(7).
================

Fix: Change the descriptions to say, in essence, that file deletion is
at the system administrators' discretion/policy in both directories.

It would probably be prudent to vet the changes with well-experienced
SAs; I'm just an experienced user and home SA.

patch -d "some man/man1" < this-PR
How-To-Repeat: n/a
================
Comment 1 dd freebsd_committer freebsd_triage 2001-09-03 17:26:23 UTC 
State Changed
From-To: open->feedback

I don't like how this duplicates information.  How about just adding a 
NOTES or CAVEATS section at the bottom warning that the entire 
filesystem hierarchy is at the SA's discretion, and that stuff in 
there is only supposed to reflect the FreeBSD default?
Comment 2 Murray Stokely freebsd_committer freebsd_triage 2001-10-08 05:00:37 UTC 
How about the following patch?  Does this please everyone?

Index: hier.7
===================================================================
RCS file: /home/ncvs/src/share/man/man7/hier.7,v
retrieving revision 1.57
diff -u -r1.57 hier.7
--- hier.7	2001/10/01 08:52:40	1.57
+++ hier.7	2001/10/08 03:58:09
@@ -752,6 +752,12 @@
 the NIS maps
 .El
 .El
+.Sh NOTES
+This manual page documents the default FreeBSD filesystem layout, but
+the actual hierarchy on a given system is defined at the system
+administrator's discretion.
+A well-maintained installation will include a customized version of
+this document.
 .Sh SEE ALSO
 .Xr apropos 1 ,
 .Xr find 1 ,
Comment 3 Murray Stokely freebsd_committer freebsd_triage 2001-10-13 22:49:39 UTC 
State Changed
From-To: feedback->analyzed

Updated text has been committed to -CURRENT.  Thanks!
Comment 4 Murray Stokely freebsd_committer freebsd_triage 2001-10-13 22:49:39 UTC 
Responsible Changed
From-To: freebsd-doc->murray

My MFC reminder.
Comment 5 Murray Stokely freebsd_committer freebsd_triage 2001-10-18 09:21:09 UTC 
State Changed
From-To: analyzed->closed

Your change has been merged to -STABLE.  Thanks!