Re: 970529: Version 3.3 documentation question

>To: address@hidden
>From: address@hidden (Matthew H. Savoie)
>Organization: NOAA/FSL
>Keywords: 199705292140.PAA20687

Matt,

> > Sorry, we no longer maintain the User's Guides in Texinfo.
> 
> Bummer, that's really too bad, I loved the emacs interface for info files.

I also use and like info documentation for other software.  I'm hoping
there will some day be a MIF-to-Texinfo or HTML-to-info filter that
will permit making info versions available again, but so far the
existing filters seem to go the other direction.

> > If you want an info version in order to have an easily searchable text
> > file, we can make a text-only version available by saving as text from
> > FrameMaker.
> 
> This might be nice if it's not a big problem.

OK, I'll see whether it's easier generating ASCII from FrameMaker or
HTML and make something available.

>                                                Also, I've run into a
> couple of errors in the documentation.  Here's the diffs.  If I find
> more of these would you rather have them from the html version or the
> text version?

Since I have to manually edit the fixes into the FrameMaker source,
either is equally OK for me.  Thanks for sending these.  You've been
added to the official netCDF acknowledgments list at

    ftp://ftp.unidata.ucar.edu/pub/netcdf/THANKS

Incidentally, I've just made new versions of the PostScript files
available, this time with index entries for every function and with a
table of contents that had been inadvertently left out, in case you ever
need to print the User's Guides.  I'll get your fixes in soon.

> (with diff -c)
> ======================================================================
> *** netcdf-c-12.html  Tue Jun  3 13:43:47 1997
> --- netcdf-c-12.html.~1.1~    Tue Jun  3 13:44:48 1997
> ***************
> *** 142,148 ****
>   <A NAME=HEADING12-85></A>
>   <H4>Usage </H4>
>   <PRE>
> ! int nc_inq_var      (int ncid, int varid, char *name, nc_type *xtypep,
>                        int *ndimsp, int dimids[], int *nattsp);
>   int nc_inq_varname  (int ncid, int varid, char *name);
>   int nc_inq_vartype  (int ncid, int varid, nc_type *xtypep);
> --- 142,148 ----
>   <A NAME=HEADING12-85></A>
>   <H4>Usage </H4>
>   <PRE>
> ! int nc_inq_var      (int ncid, int varid, char *name, nc_type, *xtypep,
>                        int *ndimsp, int dimids[], int *nattsp);
>   int nc_inq_varname  (int ncid, int varid, char *name);
>   int nc_inq_vartype  (int ncid, int varid, nc_type *xtypep);
> ***************
> *** 638,651 ****
>   <A NAME=HEADING12-461></A>
>   <H4>Usage </H4>
>   <PRE>
> ! int nc_get_var_text  (int ncid, int varid, char *tp);
> ! int nc_get_var_uchar (int ncid, int varid, unsigned char *up);
> ! int nc_get_var_schar (int ncid, int varid, signed char *cp);
> ! int nc_get_var_short (int ncid, int varid, short *sp);
> ! int nc_get_var_int   (int ncid, int varid, int *ip);
> ! int nc_get_var_long  (int ncid, int varid, long *lp);
> ! int nc_get_var_float (int ncid, int varid, float *fp);
> ! int nc_get_var_double(int ncid, int varid, double *dp);
>   <TABLE BORDER="1"><TD><CODE>ncid</CODE><TD>NetCDF ID, from a previous call 
> to <CODE>nc_open</CODE> or <CODE>nc_create</CODE>.<TR>
>   <TD><CODE>varid</CODE><TD>Variable ID.<TR>
>   <TD><CODE>tp, up, cp, sp, ip, lp, fp, </CODE>or<CODE> dp</CODE><TD>Pointer 
> to the location into which the data value is read. If the type of data value 
> differs from the netCDF variable type, type conversion will occur. <A 
> HREF=netcdf-c-8.html#MARKER-9-584>See Section 3.3 "Type Conversion,"  page 
> 26</A>, for details.</TABLE>
> --- 638,651 ----
>   <A NAME=HEADING12-461></A>
>   <H4>Usage </H4>
>   <PRE>
> ! int nc_get_var_text  (int ncid, int varid char *tp);
> ! int nc_get_var_uchar (int ncid, int varid unsigned char *up);
> ! int nc_get_var_schar (int ncid, int varid signed char *cp);
> ! int nc_get_var_short (int ncid, int varid short *sp);
> ! int nc_get_var_int   (int ncid, int varid int *ip);
> ! int nc_get_var_long  (int ncid, int varid long *lp);
> ! int nc_get_var_float (int ncid, int varid float *fp);
> ! int nc_get_var_double(int ncid, int varid double *dp);
>   <TABLE BORDER="1"><TD><CODE>ncid</CODE><TD>NetCDF ID, from a previous call 
> to <CODE>nc_open</CODE> or <CODE>nc_create</CODE>.<TR>
>   <TD><CODE>varid</CODE><TD>Variable ID.<TR>
>   <TD><CODE>tp, up, cp, sp, ip, lp, fp, </CODE>or<CODE> dp</CODE><TD>Pointer 
> to the location into which the data value is read. If the type of data value 
> differs from the netCDF variable type, type conversion will occur. <A 
> HREF=netcdf-c-8.html#MARKER-9-584>See Section 3.3 "Type Conversion,"  page 
> 26</A>, for details.</TABLE>
> ======================================================================
> 
> 
> -- 
> Matthew H. Savoie                           Systems Technology Associates
> Systems Analyst                          Supporting NOAA Profiler Network
> ph. 303.497.6642                           Demonstration Division/FSL/ERL
> mailto: address@hidden  <URL:http://www-dd.fsl.noaa.gov/online.html>

--Russ

_____________________________________________________________________

Russ Rew                                         UCAR Unidata Program
address@hidden                     http://www.unidata.ucar.edu