Update to NSS 3.12.7 and NSPR 4.8.6....

nss/mozilla/nsprpub/lib/libc/include/plgetopt.h

 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
 /* ***** BEGIN LICENSE BLOCK *****
  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
  *
  * The contents of this file are subject to the Mozilla Public License Version
  * 1.1 (the "License"); you may not use this file except in compliance with
  * the License. You may obtain a copy of the License at
  * http://www.mozilla.org/MPL/
  *
  * Software distributed under the License is distributed on an "AS IS" basis,
@@ skipping 104 matching lines @@
  * - opt->option will hold the single-character option name that was parsed, 
  *   or zero.  
  * When opt->option is zero, the token parsed was either a "long" (keyword) 
  *   option or a positional parameter.  
  * For a positional parameter, 
  * - opt->longOptIndex will contain -1, and
  * - opt->value will point to the positional parameter string.
  * For a long option name, 
  * - opt->longOptIndex will contain the non-negative index of the 
  *   PLLongOpt structure in the caller's array of PLLongOpt structures 
- 8   corresponding to the long option name, and 
+ *   corresponding to the long option name, and 
  * For a single-character or long option, 
  * - opt->longOption will contain the value of the single-character option
  *   name, or the value of the longOption from the PLLongOpt structure
  *   for that long option.  See notes below.
  * - opt->value will point to the argument option string, or will
- *   be NULL if no argument option string was given.
+ *   be NULL if option does not require argument.  If option requires
+ *   argument but it is not provided, PL_OPT_BAD is returned.
  * When opt->option is non-zero, 
  * - opt->longOptIndex will be -1
  * When this function returns PL_OPT_EOL, or PL_OPT_BAD, the contents of
  *   opt are undefined.
  *
  * Notes: It is possible to ignore opt->option, and always look at 
  *   opt->longOption instead.  opt->longOption will contain the same value
  *   as opt->option for single-character option names, and will contain the
  *   value of longOption from the PLLongOpt structure for long option names.
  * This means that it is possible to equivalence long option names to 
  *   single character names by giving the longOption in the PLLongOpt struct
  *   the same value as the single-character option name.  
  * For long options that are NOT intended to be equivalent to any single-
  *   character option, the longOption value should be chosen to not match 
  *   any possible single character name.  It might be advisable to choose
  *   longOption values greater than 0xff for such long options.
  */
 PR_EXTERN(PLOptStatus) PL_GetNextOpt(PLOptState *opt);
 
 PR_END_EXTERN_C
 
 #endif /* defined(PLGETOPT_H_) */
 
 /* plgetopt.h */