/usr/share/doc/rsl/RSL_read_these_sweeps.html is in librsl-doc 1.42-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 | <HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="GENERATOR" CONTENT="Mozilla/4.01b6C [en] (X11; I; Linux 2.0.28 i686) [Netscape]">
</HEAD>
<BODY>
<A HREF="index.html"><IMG SRC="rsl.gif" HEIGHT=100 WIDTH=100></A><A HREF="index.html"> </A>
<HR>
<BR>
<BR>
<H1>
RSL_read_these_sweeps</H1>
<HR>
<H3>
Synopsis</H3>
<B>#include "rsl.h"</B>
<BR><B>void RSL_read_these_sweeps(char *sweep#, [char *sweep#...], NULL);</B>
<BR>
<HR>
<H3>
Description</H3>
Call this routine prior to any ingest routine and only the sweeps specified
will be stored in memory. This drastically reduces memory requirements
and speeds up the ingest, especially, if you're only interesed in a few
sweeps. This function is useful, for instance, when you're making
images of the base sweeps. Why bother reading the entire file when
you only need the first sweep? By default, all sweeps are ingested.
The sweep# is a character string representing the sweep number, "4" for
instance. Order does not matter. Specify NULL as the last argument.
This signals this routine when to stop parsing for sweep numbers.
The first sweep is "0".
<P>The list of possible sweep numbers is: "all", "none", "0", "1", ...
<P>Action or side-effects: A second call to this function over-rides any
previous settings. In other words, multiple calls are not additive.
Therefore, you must list all the sweeps you want in a single call.
<P>RSL_read_these_sweeps("1", "2", NULL);
<P>which reads the second and third sweep is not the same as:
<P>RSL_read_these_sweeps("1", NULL);
<BR>RSL_read_these_sweeps("2", NULL);
<P>wherein, only the third (index 2) sweep is ingested.
<BR>
<P>
<HR>
<H3>
Return value</H3>
Upon successful completion, RSL_read_these_sweeps silently sets a hidden
array that each of the specific radar format ingest routines access.
<BR>
<HR>
<H3>
See also</H3>
<A HREF="RSL_anyformat_to_radar.html">RSL_anyformat_to_radar</A>.
<BR>
<HR>Author: <A HREF="john.merritt.html">John H. Merritt</A>.
</BODY>
</HTML>
|