10067 Miscellaneous man page typos
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Andy Fiddaman <andy@omniosce.org>
Reviewed by: Volker A. Brandt <vab@bb-c.de>

          --- old/usr/src/man/man1b/file.1b
          +++ new/usr/src/man/man1b/file.1b

   1    1  '\" te
   2    2  .\" Copyright (c) 1992, Sun Microsystems, Inc.
   3    3  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4    4  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5    5  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]

   6    6  .TH FILE 1B "Sep 14, 1992"
   7    7  .SH NAME
   8    8  file \- determine the type of a file by examining its contents
   9    9  .SH SYNOPSIS
  10   10  .LP
  11   11  .nf
  12   12  \fB/usr/ucb/file\fR [\fB-f\fR \fIffile\fR] [\fB-cL\fR] [\fB-m\fR \fImfile\fR] \fIfilename\fR...
  13   13  .fi
  14   14  
  15   15  .SH DESCRIPTION
  16      -.sp
  17   16  .LP
  18   17  \fBfile\fR performs a series of tests on each  \fIfilename\fR in an attempt to
  19   18  determine what it contains. If the contents of a file appear to be  \fBASCII\fR
  20   19  text, \fBfile\fR examines the first 512 bytes and tries to guess its language.
  21   20  .sp
  22   21  .LP
  23   22  \fBfile\fR uses the file \fB/etc/magic\fR to identify files that have some sort
  24   23  of \fImagic number\fR, that is, any file containing a numeric or string
  25   24  constant that indicates its type.
  26   25  .SH OPTIONS
  27      -.sp
  28   26  .ne 2
  29   27  .na
  30   28  \fB\fB-c\fR\fR
  31   29  .ad
  32   30  .RS 12n
  33   31  Check for format errors in the magic number file. For reasons of efficiency,
  34   32  this validation is not normally carried out. No file type-checking is done
  35   33  under \fB-c\fR.
  36   34  .RE
  37   35  

  38   36  .sp
  39   37  .ne 2
  40   38  .na
  41   39  \fB\fB-f\fR \fIffile\fR\fR
  42   40  .ad
  43   41  .RS 12n
  44   42  Get a list of filenames to identify from  \fIffile.\fR
  45   43  .RE
  46   44  
  47   45  .sp
  48   46  .ne 2
  49   47  .na
  50   48  \fB\fB-L\fR\fR
  51   49  .ad
  52   50  .RS 12n
  53   51  If a file is a symbolic link, test the file the link references rather than the
  54   52  link itself.
  55   53  .RE
  56   54  
  57   55  .sp
  58   56  .ne 2
  59   57  .na
  60   58  \fB\fB-m\fR\fI mfile\fR\fR
  61   59  .ad
  62   60  .RS 12n
  63   61  Use \fImfile\fR as the name of an alternate magic number file.
  64   62  .RE
  65   63  
  66   64  .SH EXAMPLES
  67   65  .LP
  68   66  \fBExample 1 \fRUsing \fBfile\fR on all the files in a specific user's
  69   67  directory.
  70   68  .sp
  71   69  .LP
  72   70  This example illustrates the use of \fBfile\fR on all the files in a specific
  73   71  user's directory:
  74   72  
  75   73  .sp
  76   74  .in +2
  77   75  .nf
  78   76  example% \fBpwd
  79   77  /usr/blort/misc\fR
  80   78  .fi
  81   79  .in -2
  82   80  .sp
  83   81  
  84   82  .sp
  85   83  .in +2

  86   84  .nf
  87   85  example% \fB/usr/ucb/file  *\fR
  88   86  
  89   87  code:           mc68020 demand paged executable
  90   88  code.c:         c program text
  91   89  counts:         ascii text
  92   90  doc:            roff,nroff, or eqn input text
  93   91  empty.file:     empty
  94   92  libz:           archive random library
  95   93  memos:          directory
  96      -project:        symboliclink to /usr/project
       94 +project:        symbolic link to /usr/project
  97   95  script:         executable shell script
  98   96  titles:         ascii text
  99   97  s5.stuff:       cpio archive
 100   98  
 101   99  
 102  100  example%
 103  101  .fi
 104  102  .in -2
 105  103  .sp
 106  104  
 107  105  .SH ENVIRONMENT VARIABLES
 108      -.sp
 109  106  .LP
 110  107  The environment variables \fBLC_CTYPE\fR, \fBLANG\fR, and \fBLC_default\fR
 111  108  control the character classification throughout \fBfile\fR. On entry to
 112  109  \fBfile\fR, these environment variables are checked in the following order:
 113  110  \fBLC_CTYPE\fR, \fBLANG\fR, and \fBLC_default\fR. When a valid value is found,
 114  111  remaining environment variables for character classification are ignored. For
 115  112  example, a new setting for \fBLANG\fR does not override the current valid
 116  113  character classification rules of \fBLC_CTYPE\fR. When none of the values is
 117  114  valid, the shell character classification defaults to the   POSIX.1 "C"
 118  115  locale.
 119  116  .SH FILES
 120      -.sp
 121  117  .LP
 122  118  \fB/etc/magic\fR
 123  119  .SH SEE ALSO
 124      -.sp
 125  120  .LP
 126  121  \fBmagic\fR(4), \fBattributes\fR(5)
 127  122  .SH BUGS
 128      -.sp
 129  123  .LP
 130  124  \fBfile\fR often makes mistakes.  In particular, it often suggests that command
 131  125  files are C programs.
 132  126  .sp
 133  127  .LP
 134  128  \fBfile\fR does not recognize Pascal or  LISP.
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX