/usr/include/htdig/WordContext.h is in htdig 1:3.2.0b6-12.
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 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | //
// WordContext.h
//
// NAME
//
// read configuration description and setup mifluz context.
//
// SYNOPSIS
//
// #include <mifluz.h>
//
// Configuration* config = WordContext::Initialize();
// ...
// WordContext::Finish();
//
// DESCRIPTION
//
// The WordContext::Initialize() method initialize the global context
// for the mifluz library. All other classes depend on it. It must
// therefore be called before any other <i>mifluz</i> classes are used.
//
// CONFIGURATION
//
// wordlist_monitor {true|false} (default false)
// If true create a <i>WordMonitor</i> instance to gather statistics and
// build reports.
//
//
// ENVIRONMENT
//
// <b>MIFLUZ_CONFIG</b> file name of configuration file read by
// WordContext(3). Defaults to <b>~/.mifluz.</b>
//
// END
//
// Part of the ht://Dig package <http://www.htdig.org/>
// Copyright (c) 1999-2004 The ht://Dig Group
// For copyright details, see the file COPYING in your distribution
// or the GNU Library General Public License (LGPL) version 2 or later
// <http://www.gnu.org/copyleft/lgpl.html>
//
// $Id: WordContext.h,v 1.5 2004/05/28 13:15:26 lha Exp $
//
#ifndef _WordContext_h_
#define _WordContext_h_
#ifndef SWIG
#include "Configuration.h"
#endif /* SWIG */
//
// Short hand for calling Initialize for all classes
// Word* that have a single instance (WordType, WordKeyInfo, WordRecordInfo).
//
class WordContext
{
public:
//-
// Create environment. Must be called before any other class are used.
//
// When calling <b>Initialize</b> a second time, one must ensure
// that all WordList and WordCursor objects have been
// destroyed. WordList and WordCursor internal state depends on the
// current WordContext that will be lost by a second call.
// <br>
// For those interested by the internals, the <b>Initialize</b> function
// maintains a Berkeley DB environment (DB_ENV) in the following way:
//
// First invocation:
// <pre>
// Initialize -> new DB_ENV (thru WordDBInfo)
// </pre>
//
// Second invocation:
// <pre>
// Initialize -> delete DB_ENV -> new DB_ENV (thru WordDBInfo)
// </pre>
//
static void Initialize(Configuration &config);
#ifndef SWIG
//-
// Build a <i>Configuration</i> object from the file pointed to by the
// MIFLUZ_CONFIG environment variable or ~/.mifluz.
// The <b>config_defaults</b> argument, if provided, is passed to
// the <i>Configuration</i> object using the <b>Defaults</b> method.
// The <b>Initialize(const Configuration &)</b> method is then called
// with the <i>Configuration</i> object.
//
// Refer to the <i>Configuration</i> description for more information.
//
//
static Configuration *Initialize(const ConfigDefaults* config_defaults = 0);
#endif /* SWIG */
//-
// Destroy environment. Must be called after all other <i>mifluz</i>
// objects are destroyed.
//
static void Finish();
};
#endif // _WordContext_h_
|