1 files changed, 69 insertions, 0 deletions
diff --git a/funtools/fitsy/doc/headfind.wu b/funtools/fitsy/doc/headfind.wu
new file mode 100644
index 0000000..20b143d
--- /dev/null
+++ b/funtools/fitsy/doc/headfind.wu
@@ -0,0 +1,69 @@
+Title: headfind
+
+
+NAME
+====
+ ft_headfind,ft_headindex,ft_headfindidx,ft_headfindseq -Fitsy FITS header find
+ routines.
+
+SYNOPSIS
+========
+ 
+
+-
+FITSCard ft_headfind(FITSHead fits, char *name, int n, int add);
+void ft_headindex(FITSHead fits);
+FITSCard ft_headfindidx(FITSHead fits, char *name, int n, int *match);
+FITSCard ft_headfindseq(FITSHead fits, char *name, int n, int *match);
+
+
+-
+PARAMETERS
+==========
+  * #"FITSHead fits" - The FITS header to search.
+  * #"char *name" - Name of the card keyword to search for.
+  * #"int n" - keyword index number, if is zero no
+      index number is appended to the keyword.
+  * #"int add" - If add is true the card will
+      be added to the header if it is
+      not found.
+  * #"int *match" - Returns true if the card found is
+      an exact match for the keyword
+      requested.
+
+DESCRIPTION
+===========
+
+ ft_headfind
+ -----------
+ Find a FITS card in the header.
+ 
+ If the header has been indexed the index will be used
+ otherwise a sequential search will be done.
+
+ ft_headindex
+ ------------
+ Index a header for use with #ft_headfind.
+
+ ft_headfindidx
+ --------------
+ Find a FITS card in the header.
+ 
+ #headfindidx uses an index to find the card.
+
+ ft_headfindseq
+ --------------
+ Find a FITS card in the header.
+ 
+ Find a card in the header using sequential search.
+ 
+ If the requested card is a FITS indexed keyword and an exact match
+ is not found, the highest existing card of that type is returned and
+ match is set to 0.
+
+RETURNS
+=======
+
+ ft_headfind
+ -----------
+ The card found or NULL if an exact match was not found.
+\ No newline at end of file