=================================================================== RCS file: /cvs/mandoc/Attic/apropos_db.h,v retrieving revision 1.3 retrieving revision 1.13 diff -u -p -r1.3 -r1.13 --- mandoc/Attic/apropos_db.h 2011/11/13 11:10:27 1.3 +++ mandoc/Attic/apropos_db.h 2012/03/24 01:46:25 1.13 @@ -1,6 +1,6 @@ -/* $Id: apropos_db.h,v 1.3 2011/11/13 11:10:27 schwarze Exp $ */ +/* $Id: apropos_db.h,v 1.13 2012/03/24 01:46:25 kristaps Exp $ */ /* - * Copyright (c) 2011 Kristaps Dzonsons + * Copyright (c) 2011, 2012 Kristaps Dzonsons * * Permission to use, copy, modify, and distribute this software for any * purpose with or without fee is hereby granted, provided that the above @@ -17,7 +17,14 @@ #ifndef APROPOS_H #define APROPOS_H -struct rec { +enum restype { + RESTYPE_MAN, /* man(7) file */ + RESTYPE_MDOC, /* mdoc(7) file */ + RESTYPE_CAT /* pre-formatted file */ +}; + +struct res { + enum restype type; /* input file type */ char *file; /* file in file-system */ char *cat; /* category (3p, 3, etc.) */ char *title; /* title (FOO, etc.) */ @@ -25,8 +32,13 @@ struct rec { char *desc; /* description (from Nd) */ unsigned int rec; /* record in index */ /* - * By the time the apropos_search() callback is called, these - * are superfluous. + * The index volume. This indexes into the array of directories + * searched for manual page databases. + */ + unsigned int volume; + /* + * The following fields are used internally. + * * Maintain a binary tree for checking the uniqueness of `rec' * when adding elements to the results array. * Since the results array is dynamic, use offset in the array @@ -34,6 +46,8 @@ struct rec { */ int lhs; int rhs; + int matched; /* expression is true */ + int *matches; /* partial truth evaluations */ }; struct opts { @@ -45,12 +59,14 @@ __BEGIN_DECLS struct expr; -void apropos_search(const struct opts *, - const struct expr *, void *, - void (*)(struct rec *, size_t, void *)); - -struct expr *exprcomp(int, char *[]); +int apropos_search(int, char **, const struct opts *, + const struct expr *, size_t, + void *, size_t *, struct res **, + void (*)(struct res *, size_t, void *)); +struct expr *exprcomp(int, char *[], size_t *); void exprfree(struct expr *); +void resfree(struct res *, size_t); +struct expr *termcomp(int, char *[], size_t *); __END_DECLS