Module Name: src
Committed By: wiz
Date: Fri May 8 20:20:40 UTC 2009
Modified Files:
src/external/bsd/file/dist/doc: magic.5
Log Message:
New sentence, new line.
To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/external/bsd/file/dist/doc/magic.5
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/bsd/file/dist/doc/magic.5
diff -u src/external/bsd/file/dist/doc/magic.5:1.3 src/external/bsd/file/dist/doc/magic.5:1.4
--- src/external/bsd/file/dist/doc/magic.5:1.3 Fri May 8 20:19:39 2009
+++ src/external/bsd/file/dist/doc/magic.5 Fri May 8 20:20:39 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: magic.5,v 1.3 2009/05/08 20:19:39 wiz Exp $
+.\" $NetBSD: magic.5,v 1.4 2009/05/08 20:20:39 wiz Exp $
.\"
.\" $File: magic.man,v 1.59 2008/11/06 23:22:53 christos Exp $
.Dd August 30, 2008
@@ -155,11 +155,12 @@
Starting at the given offset, consult the magic database again.
.It Dv regex
A regular expression match in extended POSIX regular expression syntax
-(like egrep). Regular expressions can take exponential time to
-process, and their performance is hard to predict, so their use is
-discouraged. When used in production environments, their performance
-should be carefully checked. The type specification can be optionally
-followed by
+(like egrep).
+Regular expressions can take exponential time to process, and their
+performance is hard to predict, so their use is discouraged.
+When used in production environments, their performance
+should be carefully checked.
+The type specification can be optionally followed by
.Dv /[c][s] .
The
.Dq c
@@ -178,15 +179,17 @@
match the beginning and end of individual lines, respectively,
not beginning and end of file.
.It Dv search
-A literal string search starting at the given offset. The same
-modifier flags can be used as for string patterns. The modifier flags
-(if any) must be followed by
+A literal string search starting at the given offset.
+The same modifier flags can be used as for string patterns.
+The modifier flags (if any) must be followed by
.Dv /number
the range, that is, the number of positions at which the match will be
-attempted, starting from the start offset. This is suitable for
+attempted, starting from the start offset.
+This is suitable for
searching larger binary expressions with variable offsets, using
.Dv \e
-escapes for special characters. The offset works as for regex.
+escapes for special characters.
+The offset works as for regex.
.It Dv default
This is intended to be used with the test
.Em x
@@ -195,14 +198,18 @@
.El
.Pp
Each top-level magic pattern (see below for an explanation of levels)
-is classified as text or binary according to the types used. Types
+is classified as text or binary according to the types used.
+Types
.Dq regex
and
.Dq search
are classified as text tests, unless non-printable characters are used
-in the pattern. All other tests are classified as binary. A top-level
+in the pattern.
+All other tests are classified as binary.
+A top-level
pattern is considered to be a test text when all its patterns are text
-patterns; otherwise, it is considered to be a binary pattern. When
+patterns; otherwise, it is considered to be a binary pattern.
+When
matching a file, binary patterns are tried first; if no match is
found, and the file looks like text, then its encoding is determined
and the text patterns are tried.
