code review from Josh and Robert

          --- old/usr/src/man/man9f/vmem_add.9f
          +++ new/usr/src/man/man9f/vmem_add.9f

   1    1  .\"
   2    2  .\" This file and its contents are supplied under the terms of the
   3    3  .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4    4  .\" You may only use this file in accordance with the terms of version
   5    5  .\" 1.0 of the CDDL.
   6    6  .\"
   7    7  .\" A full copy of the text of the CDDL should have accompanied this
   8    8  .\" source.  A copy of the CDDL is also available via the Internet at
   9    9  .\" http://www.illumos.org/license/CDDL.
  10   10  .\"
  11   11  .\"
  12   12  .\" Copyright 2017, Richard Lowe.
  13   13  .\"
  14   14  .Dd Jan 18, 2017
  15   15  .Dt VMEM_ADD 9F
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm vmem_add
  19   19  .Nd add spans to a vmem arena
  20   20  .Sh SYNOPSIS
  21   21  .In sys/vmem.h
  22   22  .Ft void *
  23   23  .Fo vmem_add
  24   24  .Fa "vmem_t *vmp"
  25   25  .Fa "void *vaddr"
  26   26  .Fa "size_t size"
  27   27  .Fa "int vmflag"

  28   28  .Fc
  29   29  .Sh INTERFACE LEVEL
  30   30  illumos DDI specific
  31   31  .Sh PARAMETERS
  32   32  .Bl -tag -width Ds
  33   33  .It Fa vmp
  34   34  The vmem arena to which the span should be added.
  35   35  .It Fa vaddr
  36   36  The base address of the span to add.
  37   37  .It Fa size
  38      -The size of the span to add
       38 +The size of the span to add.
  39   39  .It Fa vmflag
  40   40  Flags affecting the allocation of the span to add.
  41   41  .El
  42   42  .Sh DESCRIPTION
  43   43  The
  44   44  .Fn vmem_add
  45   45  function adds
  46   46  .Fa size
  47   47  bytes starting at
  48   48  .Fa vaddr
  49   49  to a vmem arena from which future calls to
  50   50  .Fn vmem_alloc
  51   51  may allocate.
  52   52  .Pp
  53   53  .Dv VM_SLEEP
  54   54  or
  55   55  .Dv VM_NOSLEEP
  56      -must be specified, and indicate whether the addition may block.
       56 +must be specified in
       57 +.Fa vmflag ,
       58 +and indicate whether the addition may block.
  57   59  .Sh CONTEXT
  58   60  This function can be called from either user or kernel context.
  59   61  If the
  60   62  .Dv VM_NOSLEEP
  61   63  flag is specified, it may also be called from interrupt context.
  62   64  .Sh RETURN VALUES
  63   65  Upon success
  64   66  .Fn vmem_add
  65   67  returns
  66   68  .Fa vaddr .
  67   69  On failure,
  68   70  .Dv NULL
  69   71  is returned.
  70   72  .Sh SEE ALSO
  71   73  .Xr vmem 9 ,
  72   74  .Xr vmem_alloc 9F ,
  73   75  .Xr vmem_create 9F
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX