=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/file/file.1,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- src/usr.bin/file/file.1 1999/03/30 01:21:22 1.5 +++ src/usr.bin/file/file.1 1999/06/05 01:21:24 1.6 @@ -1,4 +1,4 @@ -.\" $OpenBSD: file.1,v 1.5 1999/03/30 01:21:22 ian Exp $ +.\" $OpenBSD: file.1,v 1.6 1999/06/05 01:21:24 aaron Exp $ .TH FILE 1 "Copyrighted but distributable" .SH NAME file @@ -12,7 +12,7 @@ .B \-f namefile ] [ -.B \-m +.B \-m magicfiles ] file ... .SH DESCRIPTION @@ -44,7 +44,7 @@ that are known to contain binary data. When modifying the file .I /etc/magic -or the program itself, +or the program itself, .B "preserve these keywords" . People depend on knowing that all the readable files in a directory have the word ``text'' printed. @@ -67,7 +67,7 @@ particular fixed formats. The canonical example of this is a binary executable (compiled program) .I a.out -file, whose format is defined in +file, whose format is defined in .I a.out.h and possibly .I exec.h @@ -82,7 +82,7 @@ .I /etc/magic. .PP If an argument appears to be an -.SM ASCII +.SM ASCII file, .B file attempts to guess its language. @@ -93,16 +93,16 @@ .B .br indicates that the file is most likely a .BR troff (1) -input file, just as the keyword +input file, just as the keyword .B struct indicates a C program. These tests are less reliable than the previous two groups, so they are performed last. The language test routines also test for some miscellany -(such as +(such as .BR tar (1) archives) and determine whether an unknown file should be -labelled as `ascii text' or `data'. +labelled as `ascii text' or `data'. .SH OPTIONS .TP 8 .B \-v @@ -117,16 +117,16 @@ .TP 8 .B \-c Cause a checking printout of the parsed form of the magic file. -This is usually used in conjunction with +This is usually used in conjunction with .B \-m to debug a new magic file before installing it. .TP 8 .B \-f namefile -Read the names of the files to be examined from +Read the names of the files to be examined from .I namefile -(one per line) +(one per line) before the argument list. -Either +Either .I namefile or at least one filename argument must be present; to test the standard input, use ``-'' as a filename argument. @@ -151,12 +151,12 @@ .SH STANDARDS CONFORMANCE This program is believed to exceed the System V Interface Definition of FILE(CMD), as near as one can determine from the vague language -contained therein. +contained therein. Its behaviour is mostly compatible with the System V program of the same name. This version knows more magic, however, so it will produce -different (albeit more accurate) output in many cases. +different (albeit more accurate) output in many cases. .PP -The one significant difference +The one significant difference between this version and System V is that this version treats any white space as a delimiter, so that spaces in pattern strings must be escaped. @@ -191,7 +191,7 @@ mainly USENET, and contributed by various authors. Christos Zoulas (address below) will collect additional or corrected magic file entries. -A consolidation of magic file entries +A consolidation of magic file entries will be distributed periodically. .PP The order of entries in the magic file is significant. @@ -201,10 +201,10 @@ .B file command uses a magic file, keep the old magic file around for comparison purposes -(rename it to +(rename it to .IR /etc/magic.orig ). .SH HISTORY -There has been a +There has been a .B file command in every \s-1UNIX\s0 since at least Research Version 6 (man page dated January, 1975). @@ -303,11 +303,11 @@ Regular expression support would make this easy. .PP The program doesn't grok \s-2FORTRAN\s0. -It should be able to figure \s-2FORTRAN\s0 by seeing some keywords which +It should be able to figure \s-2FORTRAN\s0 by seeing some keywords which appear indented at the start of line. Regular expression support would make this easy. .PP -The list of keywords in +The list of keywords in .I ascmagic probably belongs in the Magic file. This could be done by using some keyword like `*' for the offset value. @@ -319,12 +319,12 @@ Make a rule that the magic entries sort based on file offset rather than position within the magic file? .PP -The program should provide a way to give an estimate +The program should provide a way to give an estimate of ``how good'' a guess is. We end up removing guesses (e.g. ``From '' as first 5 chars of file) because they are not as good as other guesses (e.g. ``Newsgroups:'' versus "Return-Path:"). Still, if the others don't pan out, it should be -possible to use the first guess. +possible to use the first guess. .PP This program is slower than some vendors' file commands. .PP