Describe filename mangling from bryanh@giraffe-data.com (Bryan Henderson)

diff --git a/doc/file.man b/doc/file.man
index 8e54ad1b2f562b289add39337699b443984250cd..55f59066f0a1cab5cf87c69df3da6279e4984854 100644 (file)
--- a/doc/file.man
+++ b/doc/file.man
@@ -1,5 +1,5 @@
 .TH FILE __CSECTION__ "Copyright but distributable"
-.\" $Id: file.man,v 1.50 2003/07/10 17:51:09 christos Exp $
+.\" $Id: file.man,v 1.51 2003/10/08 16:10:15 christos Exp $
 .SH NAME
 file
 \- determine file type
@@ -204,6 +204,7 @@ option causes symlinks to be followed, as the like-named option in
 Specify an alternate list of files containing magic numbers.
 This can be a single file, or a colon-separated list of files.
 If a compiled magic file is found alongside, it will be used instead.
+With the \-i or \-\-mime option, the program adds ".mime" to each file name.
 .TP 8
 .B "\-n, \-\-no\-buffer"
 Force stdout to be flushed after checking each file.
@@ -273,7 +274,9 @@ Local additions to magic wisdom.
 .SH ENVIRONMENT
 The environment variable
 .B MAGIC
-can be used to set the default magic number files.
+can be used to set the default magic number file name.
+.B file
+adds ".mime" and/or ".mgc" to the value of this variable as appropriate.
 .SH SEE ALSO
 .BR magic (__FSECTION__)
 \- description of magic file format.

diff --git a/doc/libmagic.man b/doc/libmagic.man
index 78eb1679287c9db490a763dff9c763e109b41bce..0aae08aa574515bcf9b46ccce66cfbcaf5f18588 100644 (file)
--- a/doc/libmagic.man
+++ b/doc/libmagic.man
@@ -158,8 +158,15 @@ The
 function must be used to load the the colon
 separated list of database files passed in as
 .Ar filename ,
-or NULL for the default database
+or NULL for the default database file
 before any magic queries can performed.
+.Pp
+The default database file is named by the MAGIC environment variable.  If
+that variable is not set, the default database file name is __MAGIC__.
+.Pp
+.Fn magic_load
+adds ".mime" and/or ".mgc" to the database filename as appropriate.
+
 .Sh RETURN VALUES
 The function
 .Fn magic_open
@@ -192,13 +199,13 @@ is set.
 .Sh FILES
 .Bl -tag -width __MAGIC__.mime.mgc -compact
 .It Pa __MAGIC__.mime
-The non-compiled magic mime database.
+The non-compiled default magic mime database.
 .It Pa __MAGIC__.mime.mgc
-The compiled magic mime database.
+The compiled default magic mime database.
 .It Pa __MAGIC__
-The non-compiled magic database.
+The non-compiled default magic database.
 .It Pa __MAGIC__.mgc
-The compiled magic database.
+The compiled default magic database.
 .El
 .Sh SEE ALSO
 .Xr file __CSECTION__ ,