410d0f4380
This code has been developed by Abhinav Upadhyay as part of Google's Summer of Code 2011. It uses libmandoc to parse man pages and builds a Full Text Index in a SQLite database. The combination of indexing the full manual page, filtering out stop words and ranking individual matches based on the section gives a much improved user experience. The old makewhatis and friends are kept under MKMAKEMANDB=no for now.
68 lines
2.4 KiB
Groff
68 lines
2.4 KiB
Groff
.\" $NetBSD: apropos-utils.3,v 1.1 2012/02/07 19:13:32 joerg Exp $
|
|
.\"
|
|
.\" Copyright (c) 2011 Abhinav Upadhyay <er.abhinav.upadhyay@gmail.com>
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" This code was developed as part of Google's Summer of Code 2011 program.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\"
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in
|
|
.\" the documentation and/or other materials provided with the
|
|
.\" distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
|
|
.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.Dd August 17, 2011
|
|
.Dt APROPOS-UTILS 3
|
|
.Os
|
|
.Sh NAME
|
|
.Nm apropos-utils
|
|
.Nd support functions for querying the man page index
|
|
.Sh SYNOPSIS
|
|
.In apropos-utils.h
|
|
.Ft sqlite3 *
|
|
.Fn init_db "int db_flag"
|
|
.Ft void
|
|
.Fn close_db "sqlite3 *db"
|
|
.Ft int
|
|
.Fn run_query "sqlite3 *db" "const char *snippet_args[3]" "query_args *args"
|
|
.Ft int
|
|
.Fn run_query_html "sqlite3 *db" "query_args *args"
|
|
.Ft int
|
|
.Fn run_query_pager "sqlite3 *db" "query_args *args"
|
|
.Sh DESCRIPTION
|
|
These functions all live in the
|
|
.Pa apropos-utils.h
|
|
header file.
|
|
They operate on
|
|
.Pa /var/db/man.db
|
|
which is an Sqlite database containing a full text search index of the manual
|
|
pages.
|
|
The functions provide an easy to use interface to query the database and
|
|
develop applications on top of it.
|
|
.Sh SEE ALSO
|
|
.Xr close_db 3 ,
|
|
.Xr init_db 3 ,
|
|
.Xr run_query 3 ,
|
|
.Xr run_query_html 3 ,
|
|
.Xr run_query_pager 3
|
|
.Sh AUTHORS
|
|
.An Abhinav Upadhyay
|