NAME:
  rdstarc
 PURPOSE:
  Read refnet based star catalog files.
 DESCRIPTION:
 CATEGORY:
  Astrometry
 CALLING SEQUENCE:
  rdstarc,starfile,ra,dec,bmag,rmag,nstars
 INPUTS:
  starfile - Name of file to read.
 OPTIONAL INPUT PARAMETERS:
 KEYWORD INPUT PARAMETERS:
 OUTPUTS:
  ra   - right ascension in radians (J2000)
  dec  - declination in radians (J2000)
  bmag - Blue magnitude
  rmag - Red magnitude  (see the USNO A2.0 catalog docs to see what this means)
  nstars - Number of stars found (can be zero- in this case other 
          outputs not defined).
 KEYWORD OUTPUT PARAMETERS:
 COMMON BLOCKS:
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 Read star catalog file- if it is ascii (as output by refnet) use starcprmt to
 convert to v1.0 binary format.
 MODIFICATION HISTORY:
  Written by Marc W. Buie, Lowell Observatory, 2002/01/07
  02/03/10 - MWB, added nstars return value
  2007/11/23- Peter L. Collins, Lowell Observatory, convert to v1.0 binary fmt and 
                                add promote call.