Author: Michael Piefel Description: FIXME, and #417511. diff -Naurp file.orig/doc/file.man file/doc/file.man --- file.orig/doc/file.man 2008-11-06 23:18:35.000000000 +0000 +++ file/doc/file.man 2009-02-18 12:28:42.000000000 +0000 @@ -51,7 +51,7 @@ meaning anything else (data is usually or non-printable). Exceptions are well-known file formats (core files, tar archives) that are known to contain binary data. -When modifying magic files or the program itself, make sure to +When adding local definitions to /etc/magic, make sure to .Em "preserve these keywords" . Users depend on knowing that all the readable files in a directory have the word @@ -95,7 +95,8 @@ The concept of a has been applied by extension to data files. Any file with some invariant identifier at a small fixed offset into the file can usually be described in this way. -The information identifying these files is read from the compiled +The information identifying these files is read from /etc/magic +and the the compiled magic file .Pa __MAGIC__.mgc , or the files in the directory @@ -325,6 +326,11 @@ will not attempt to open adds .Sq .mgc to the value of this variable as appropriate. +However, +.Pa file +has to exist in order for +.Pa file.mime +to be considered. The environment variable .Dv POSIXLY_CORRECT controls (on systems that support symbolic links), whether @@ -400,12 +406,6 @@ will be distributed periodically. The order of entries in the magic file is significant. Depending on what system you are using, the order that they are put together may be incorrect. -If your old -.Nm -command uses a magic file, -keep the old magic file around for comparison purposes -(rename it to -.Pa __MAGIC__.orig ). .Sh EXAMPLES .Bd -literal -offset indent $ file file.c file /dev/{wd0a,hda} @@ -547,3 +547,8 @@ on .Dv ftp.astron.com in the directory .Dv /pub/file/file-X.YZ.tar.gz +.Pp +This Debian version adds a number of new magic entries. It can be +obtained from every site carrying a Debian distribution (that is +.Dv ftp.debian.org +and mirrors).