docs/55653: chflags.1 - note that not all tools chflags aware.

[Tony Maher]

>Number:         55653
>Category:       docs
>Synopsis:       chflags.1 - note that not all tools chflags aware.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 16 22:00:31 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Tony Maher
>Release:        FreeBSD 4.8-STABLE i386
>Organization:
>Environment:
System: FreeBSD dt.home 4.8-STABLE FreeBSD 4.8-STABLE #3: Sun Aug 10 11:11:38 EST 2003 root at dt.home:/usr/obj/usr/src/sys/DT i386


>Description:
	It was pointed out to me last week that not all tools are aware of
	BSD extension file flags (chflags).
	Attached is patch which just notes this in the chflags.1 man page.

>How-To-Repeat:

>Fix:


--- chflags.1.orig	Sun Aug 17 14:31:38 2003
+++ chflags.1	Sun Aug 17 14:43:57 2003
@@ -149,6 +149,23 @@
 .Xr stat 2 ,
 .Xr fts 3 ,
 .Xr symlink 7
+.Sh BUGS
+Only a limited number of tools know about about chflags.
+Some of the tools which are
+.Nm
+aware include:
+.Xr ls 1 ,
+.Xr cp 1 ,
+.Xr find 1 ,
+.Xr dump 8 ,
+and
+.Xr restore 8 .
+In particular the following tools are not
+.Nm
+aware:
+.Xr tar 1
+and
+.Xr pax 1 .
 .Sh HISTORY
 The
 .Nm

>Release-Note:
>Audit-Trail:
>Unformatted: