[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[aspell-devel] doxigen API documentation
From: |
Alexandre Leduc |
Subject: |
[aspell-devel] doxigen API documentation |
Date: |
Fri, 07 Feb 2003 19:38:56 -0500 |
User-agent: |
Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.2.1) Gecko/20021130 |
I started to reformat the comments in "aspell.h" (see attachment) so
that I can generate some documentation out of it with Doxygen (
http://www.stack.nl/~dimitri/doxygen/index.html ). I figure such a thing
would be usefull to a lot of people interested in using/developing Aspell.
If anyone that is knowledgable about Aspell's functions and data
structures would like to help me in this effort, it would be very
appreciated. All I need is for you to add a short comment that describes
whatever a function does and I'll reformat it for doxygen.
I'm hosting what little I've generated so far here.
http://attention-span.net/aspell/aspell_8h.html
Alexandre Leduc
/* Automatically generated file. Do not edit directly. */
/* This file is part of The New Aspell
* Copyright (C) 2001-2002 by Kevin Atkinson under the GNU LGPL
* license version 2.0 or 2.1. You should have received a copy of the
* LGPL license along with this library if you did not you can find it
* at http://www.gnu.org/. */
#ifndef ASPELL_ASPELL__H
#define ASPELL_ASPELL__H
#ifdef __cplusplus
extern "C" {
#endif
/******************************* type id *******************************/
union AspellTypeId {
unsigned int num;
char str[4];
};
typedef union AspellTypeId AspellTypeId;
/************************** mutable container **************************/
typedef struct AspellMutableContainer AspellMutableContainer;
int aspell_mutable_container_add(struct AspellMutableContainer * ths, const
char * to_add);
int aspell_mutable_container_remove(struct AspellMutableContainer * ths, const
char * to_rem);
void aspell_mutable_container_clear(struct AspellMutableContainer * ths);
struct AspellMutableContainer *
aspell_mutable_container_to_mutable_container(struct AspellMutableContainer *
ths);
/******************************* key info *******************************/
enum AspellKeyInfoType {AspellKeyInfoString, AspellKeyInfoInt,
AspellKeyInfoBool, AspellKeyInfoList};
typedef enum AspellKeyInfoType AspellKeyInfoType;
struct AspellKeyInfo {
/** The name of the key. */
const char * name;
/** The key type. */
enum AspellKeyInfoType type;
/** The default value of the key. */
const char * def;
/** A brief description of the key or null if internal value. */
const char * desc;
/** Other data used by config implementations
* should be set to 0 if not used. */
char otherdata[16];
};
typedef struct AspellKeyInfo AspellKeyInfo;
/******************************** config ********************************/
typedef struct AspellKeyInfoEnumeration AspellKeyInfoEnumeration;
int aspell_key_info_enumeration_at_end(const struct AspellKeyInfoEnumeration *
ths);
const struct AspellKeyInfo * aspell_key_info_enumeration_next(struct
AspellKeyInfoEnumeration * ths);
void delete_aspell_key_info_enumeration(struct AspellKeyInfoEnumeration * ths);
struct AspellKeyInfoEnumeration * aspell_key_info_enumeration_clone(const
struct AspellKeyInfoEnumeration * ths);
void aspell_key_info_enumeration_assign(struct AspellKeyInfoEnumeration * ths,
const struct AspellKeyInfoEnumeration * other);
typedef struct AspellConfig AspellConfig;
/** Creates a new object of the AspellConfig class.
It is allocated with new and it is your
responsibility to delete it with delete_aspell_config.
\note Once you have initialized an AspellSpeller with it
through new_aspell_speller, the AspellSpeller object will
contain it's own copy of the AspellConfig object. Deleting it will therefore
not affect the Speller's configuration.
*/
struct AspellConfig * new_aspell_config();
void delete_aspell_config(struct AspellConfig * ths);
/** Creates a copy of \a ths
\return Returns a new AspellConfig object who's options are identical to those
of \a ths.
*/
struct AspellConfig * aspell_config_clone(const struct AspellConfig * ths);
void aspell_config_assign(struct AspellConfig * ths, const struct AspellConfig
* other);
unsigned int aspell_config_error_number(const struct AspellConfig * ths);
/** This function to returns a string that describes the error.
aspell_config_error is usually called before this function to check if there
was an error.
\par
\param *ths Pointer to an existing AspellConfig structure.
*/
const char * aspell_config_error_message(const struct AspellConfig * ths);
/** Checks if the previous operation on \a ths was successful.
\par
\param *ths Pointer to an existing AspellConfig structure.
\par
\return Returns NULL on success or an AspellError containing information on the
error.
*/
const struct AspellError * aspell_config_error(const struct AspellConfig * ths);
/** Sets extra keys which this config class should accept.
Begin and end are expected to point to the begging
and end of an array of Aspell Key Info
*/
void aspell_config_set_extra(struct AspellConfig * ths, const struct
AspellKeyInfo * begin, const struct AspellKeyInfo * end);
/** Returns the KeyInfo object for the
* corresponding key or returns null and sets
* error_num to PERROR_UNKNOWN_KEY if the key is
* not valid. The pointer returned is valid for
* the lifetime of the object.
*/
const struct AspellKeyInfo * aspell_config_keyinfo(struct AspellConfig * ths,
const char * key);
/** Returns a newly allocated enumeration of all the possible objects this
config class uses.
*/
struct AspellKeyInfoEnumeration * aspell_config_possible_elements(struct
AspellConfig * ths, int include_extra);
/** Returns the default value for given key which may involve substating
variables.
* Thus it is not the same as keyinfo(key)->def returns null
* and sets error_num to PERROR_UNKNOWN_KEY if
* the key is not valid. Uses the temporary
* string.
\par
\param *ths Pointer to an existing AspellConfig structure.
\param *key The name of the option who's value you wish to retreive.
*/
const char * aspell_config_get_default(struct AspellConfig * ths, const char *
key);
/** Returns a newly allocated enumeration of all the key/value pairs.
This does NOT include ones which are set to their default values.
*/
struct AspellStringPairEnumeration * aspell_config_elements(struct AspellConfig
* ths);
/**\brief Sets or replaces a configuration key.
Inserts an item, if the item already exists it
* will be replaced. If the key in not valid it
* sets error_num to PERROR_UNKNOWN_KEY, if the
* value is not valid it will sets error_num to
* PERROR_BAD_VALUE, if the value can not be
* changed it sets error_num to
* PERROR_CANT_CHANGE_VALUE, and if the value is
* a list and you are trying to set it directory
* it sets error_num to PERROR_LIST_SET
/return Returns true if it succesed or false on error.
*/
int aspell_config_replace(struct AspellConfig * ths, const char * key, const
char * value);
/** Remove a key and returns true if it exists
* otherise return false.
This effictly sets the
* key to its default value. Calling replace with
* a value of "<default>" will also call
* remove. If the key does not exists sets
* error_num to 0 or PERROR_NOT, if the key in
* not valid sets error_num to
* PERROR_UNKNOWN_KEY, if the value can not be
* changed sets error_num to
* PERROR_CANT_CHANGE_VALUE
*/
int aspell_config_remove(struct AspellConfig * ths, const char * key);
int aspell_config_have(const struct AspellConfig * ths, const char * key);
/** Retreives the value of the AspellConfig structure's key.
\par
\param *ths Pointer to an existing AspellConfig structure.
\param *key The name of the option who's value you wish to retreive.
\par
\return Returns the key's value as a C string or NULL on error.
*/
const char * aspell_config_retrieve(struct AspellConfig * ths, const char *
key);
int aspell_config_retrieve_list(struct AspellConfig * ths, const char * key,
struct AspellMutableContainer * lst);
/** Retreives the value of the AspellConfig structure's key.
\par
\param *ths Pointer to an existing AspellConfig structure.
\param *key The name of the option who's value you wish to retreive.
\par
\return Returns -1 on error, 0 if false, 1 if true.
*/
int aspell_config_retrieve_bool(struct AspellConfig * ths, const char * key);
/** Retreives the value of the AspellConfig structure's key.
\par
\param *ths Pointer to an existing AspellConfig structure.
\param *key The name of the option who's value you wish to retreive.
\par
\return Returns -1 on error.
*/
int aspell_config_retrieve_int(struct AspellConfig * ths, const char * key);
/******************************** error ********************************/
struct AspellError {
const char * mesg;
const struct AspellErrorInfo * err;
};
typedef struct AspellError AspellError;
int aspell_error_is_a(const struct AspellError * ths, const struct
AspellErrorInfo * e);
struct AspellErrorInfo {
const struct AspellErrorInfo * isa;
const char * mesg;
unsigned int num_parms;
const char * parms[3];
};
typedef struct AspellErrorInfo AspellErrorInfo;
/**************************** can have error ****************************/
typedef struct AspellCanHaveError AspellCanHaveError;
unsigned int aspell_error_number(const struct AspellCanHaveError * ths);
const char * aspell_error_message(const struct AspellCanHaveError * ths);
const struct AspellError * aspell_error(const struct AspellCanHaveError * ths);
void delete_aspell_can_have_error(struct AspellCanHaveError * ths);
/******************************** errors ********************************/
extern const struct AspellErrorInfo * const aerror_other;
extern const struct AspellErrorInfo * const aerror_operation_not_supported;
extern const struct AspellErrorInfo * const aerror_cant_copy;
extern const struct AspellErrorInfo * const aerror_file;
extern const struct AspellErrorInfo * const aerror_cant_open_file;
extern const struct AspellErrorInfo * const aerror_cant_read_file;
extern const struct AspellErrorInfo * const aerror_cant_write_file;
extern const struct AspellErrorInfo * const aerror_invalid_name;
extern const struct AspellErrorInfo * const aerror_bad_file_format;
extern const struct AspellErrorInfo * const aerror_dir;
extern const struct AspellErrorInfo * const aerror_cant_read_dir;
extern const struct AspellErrorInfo * const aerror_config;
extern const struct AspellErrorInfo * const aerror_unknown_key;
extern const struct AspellErrorInfo * const aerror_cant_change_value;
extern const struct AspellErrorInfo * const aerror_bad_key;
extern const struct AspellErrorInfo * const aerror_bad_value;
extern const struct AspellErrorInfo * const aerror_duplicate;
extern const struct AspellErrorInfo * const aerror_language_related;
extern const struct AspellErrorInfo * const aerror_unknown_language;
extern const struct AspellErrorInfo * const aerror_unknown_soundslike;
extern const struct AspellErrorInfo * const aerror_language_not_supported;
extern const struct AspellErrorInfo * const aerror_no_wordlist_for_lang;
extern const struct AspellErrorInfo * const aerror_mismatched_language;
extern const struct AspellErrorInfo * const aerror_encoding;
extern const struct AspellErrorInfo * const aerror_unknown_encoding;
extern const struct AspellErrorInfo * const aerror_encoding_not_supported;
extern const struct AspellErrorInfo * const aerror_conversion_not_supported;
extern const struct AspellErrorInfo * const aerror_pipe;
extern const struct AspellErrorInfo * const aerror_cant_create_pipe;
extern const struct AspellErrorInfo * const aerror_process_died;
extern const struct AspellErrorInfo * const aerror_bad_input;
extern const struct AspellErrorInfo * const aerror_invalid_word;
extern const struct AspellErrorInfo * const aerror_word_list_flags;
extern const struct AspellErrorInfo * const aerror_invalid_flag;
extern const struct AspellErrorInfo * const aerror_conflicting_flags;
/******************************* speller *******************************/
typedef struct AspellSpeller AspellSpeller;
struct AspellCanHaveError * new_aspell_speller(struct AspellConfig * config);
struct AspellSpeller * to_aspell_speller(struct AspellCanHaveError * obj);
void delete_aspell_speller(struct AspellSpeller * ths);
unsigned int aspell_speller_error_number(const struct AspellSpeller * ths);
const char * aspell_speller_error_message(const struct AspellSpeller * ths);
const struct AspellError * aspell_speller_error(const struct AspellSpeller *
ths);
struct AspellConfig * aspell_speller_config(struct AspellSpeller * ths);
/**
\return Returns 0 if it is not in the dictionary, 1 if it is, or -1 on error.
*/
int aspell_speller_check(struct AspellSpeller * ths, const char * word, int
word_size);
int aspell_speller_add_to_personal(struct AspellSpeller * ths, const char *
word, int word_size);
int aspell_speller_add_to_session(struct AspellSpeller * ths, const char *
word, int word_size);
const struct AspellWordList * aspell_speller_personal_word_list(struct
AspellSpeller * ths);
const struct AspellWordList * aspell_speller_session_word_list(struct
AspellSpeller * ths);
const struct AspellWordList * aspell_speller_main_word_list(struct
AspellSpeller * ths);
int aspell_speller_save_all_word_lists(struct AspellSpeller * ths);
int aspell_speller_clear_session(struct AspellSpeller * ths);
/** the word list returned by suggest is only valid until the next call to
suggest.
\return Returns null on error.
*/
const struct AspellWordList * aspell_speller_suggest(struct AspellSpeller *
ths, const char * word, int word_size);
int aspell_speller_store_replacement(struct AspellSpeller * ths, const char *
mis, int mis_size, const char * cor, int cor_size);
/******************************** filter ********************************/
typedef struct AspellFilter AspellFilter;
void delete_aspell_filter(struct AspellFilter * ths);
unsigned int aspell_filter_error_number(const struct AspellFilter * ths);
const char * aspell_filter_error_message(const struct AspellFilter * ths);
const struct AspellError * aspell_filter_error(const struct AspellFilter * ths);
struct AspellFilter * to_aspell_filter(struct AspellCanHaveError * obj);
/*************************** document checker ***************************/
struct AspellToken {
unsigned int offset;
unsigned int len;
};
typedef struct AspellToken AspellToken;
typedef struct AspellDocumentChecker AspellDocumentChecker;
void delete_aspell_document_checker(struct AspellDocumentChecker * ths);
unsigned int aspell_document_checker_error_number(const struct
AspellDocumentChecker * ths);
const char * aspell_document_checker_error_message(const struct
AspellDocumentChecker * ths);
const struct AspellError * aspell_document_checker_error(const struct
AspellDocumentChecker * ths);
/* Creates a new document checker.
* The speller class is expect to last until this
* class is destroyed.
* If config is given it will be used to overwide
* any relevent options set by this speller class.
* The config class is not once this function is done.
* If filter is given then it will take ownership of
* the filter class and use it to do the filtering.
* You are expected to free the checker when done. */
struct AspellCanHaveError * new_aspell_document_checker(struct AspellSpeller *
speller);
struct AspellDocumentChecker * to_aspell_document_checker(struct
AspellCanHaveError * obj);
/* reset the internal state of the filter.
* should be called whenever a new document is being filtered */
void aspell_document_checker_reset(struct AspellDocumentChecker * ths);
/* process a string
* The string passed in should only be split on white space
* characters. Furthermore, between calles to reset, each string
* should be passed in exactly once and in the order they appeared
* in the document. Passing in stings out of order, skipping
* strings or passing them in more than once may lead to undefined
* results. */
void aspell_document_checker_process(struct AspellDocumentChecker * ths, const
char * str, int size);
/* returns the next misspelled word in the processed string
* if there are no more misspelled word than token.word
* will be null and token.size will be 0 */
struct AspellToken aspell_document_checker_next_misspelling(struct
AspellDocumentChecker * ths);
/* returns the underlying filter class */
struct AspellFilter * aspell_document_checker_filter(struct
AspellDocumentChecker * ths);
/****************************** word list ******************************/
typedef struct AspellWordList AspellWordList;
int aspell_word_list_empty(const struct AspellWordList * ths);
unsigned int aspell_word_list_size(const struct AspellWordList * ths);
struct AspellStringEnumeration * aspell_word_list_elements(const struct
AspellWordList * ths);
/************************** string enumeration **************************/
typedef struct AspellStringEnumeration AspellStringEnumeration;
void delete_aspell_string_enumeration(struct AspellStringEnumeration * ths);
struct AspellStringEnumeration * aspell_string_enumeration_clone(const struct
AspellStringEnumeration * ths);
void aspell_string_enumeration_assign(struct AspellStringEnumeration * ths,
const struct AspellStringEnumeration * other);
int aspell_string_enumeration_at_end(const struct AspellStringEnumeration *
ths);
const char * aspell_string_enumeration_next(struct AspellStringEnumeration *
ths);
/********************************* info *********************************/
struct AspellModuleInfo {
const char * name;
double order_num;
const char * lib_dir;
struct AspellStringList * dict_dirs;
struct AspellStringList * dict_exts;
};
typedef struct AspellModuleInfo AspellModuleInfo;
struct AspellDictInfo {
/* name to identify the dictionary by */
const char * name;
const char * code;
const char * jargon;
int size;
const char * size_str;
struct AspellModuleInfo * module;
};
typedef struct AspellDictInfo AspellDictInfo;
typedef struct AspellModuleInfoList AspellModuleInfoList;
struct AspellModuleInfoList * get_aspell_module_info_list(struct AspellConfig *
config);
int aspell_module_info_list_empty(const struct AspellModuleInfoList * ths);
unsigned int aspell_module_info_list_size(const struct AspellModuleInfoList *
ths);
struct AspellModuleInfoEnumeration * aspell_module_info_list_elements(const
struct AspellModuleInfoList * ths);
typedef struct AspellDictInfoList AspellDictInfoList;
struct AspellDictInfoList * get_aspell_dict_info_list(struct AspellConfig *
config);
int aspell_dict_info_list_empty(const struct AspellDictInfoList * ths);
unsigned int aspell_dict_info_list_size(const struct AspellDictInfoList * ths);
struct AspellDictInfoEnumeration * aspell_dict_info_list_elements(const struct
AspellDictInfoList * ths);
typedef struct AspellModuleInfoEnumeration AspellModuleInfoEnumeration;
int aspell_module_info_enumeration_at_end(const struct
AspellModuleInfoEnumeration * ths);
const struct AspellModuleInfo * aspell_module_info_enumeration_next(struct
AspellModuleInfoEnumeration * ths);
void delete_aspell_module_info_enumeration(struct AspellModuleInfoEnumeration *
ths);
struct AspellModuleInfoEnumeration * aspell_module_info_enumeration_clone(const
struct AspellModuleInfoEnumeration * ths);
void aspell_module_info_enumeration_assign(struct AspellModuleInfoEnumeration *
ths, const struct AspellModuleInfoEnumeration * other);
typedef struct AspellDictInfoEnumeration AspellDictInfoEnumeration;
int aspell_dict_info_enumeration_at_end(const struct AspellDictInfoEnumeration
* ths);
const struct AspellDictInfo * aspell_dict_info_enumeration_next(struct
AspellDictInfoEnumeration * ths);
void delete_aspell_dict_info_enumeration(struct AspellDictInfoEnumeration *
ths);
struct AspellDictInfoEnumeration * aspell_dict_info_enumeration_clone(const
struct AspellDictInfoEnumeration * ths);
void aspell_dict_info_enumeration_assign(struct AspellDictInfoEnumeration *
ths, const struct AspellDictInfoEnumeration * other);
/***************************** string list *****************************/
typedef struct AspellStringList AspellStringList;
struct AspellStringList * new_aspell_string_list();
int aspell_string_list_empty(const struct AspellStringList * ths);
unsigned int aspell_string_list_size(const struct AspellStringList * ths);
struct AspellStringEnumeration * aspell_string_list_elements(const struct
AspellStringList * ths);
int aspell_string_list_add(struct AspellStringList * ths, const char * to_add);
int aspell_string_list_remove(struct AspellStringList * ths, const char *
to_rem);
void aspell_string_list_clear(struct AspellStringList * ths);
struct AspellMutableContainer * aspell_string_list_to_mutable_container(struct
AspellStringList * ths);
void delete_aspell_string_list(struct AspellStringList * ths);
struct AspellStringList * aspell_string_list_clone(const struct
AspellStringList * ths);
void aspell_string_list_assign(struct AspellStringList * ths, const struct
AspellStringList * other);
/****************************** string map ******************************/
typedef struct AspellStringMap AspellStringMap;
struct AspellStringMap * new_aspell_string_map();
int aspell_string_map_add(struct AspellStringMap * ths, const char * to_add);
int aspell_string_map_remove(struct AspellStringMap * ths, const char * to_rem);
void aspell_string_map_clear(struct AspellStringMap * ths);
struct AspellMutableContainer * aspell_string_map_to_mutable_container(struct
AspellStringMap * ths);
void delete_aspell_string_map(struct AspellStringMap * ths);
struct AspellStringMap * aspell_string_map_clone(const struct AspellStringMap *
ths);
void aspell_string_map_assign(struct AspellStringMap * ths, const struct
AspellStringMap * other);
int aspell_string_map_empty(const struct AspellStringMap * ths);
unsigned int aspell_string_map_size(const struct AspellStringMap * ths);
struct AspellStringPairEnumeration * aspell_string_map_elements(const struct
AspellStringMap * ths);
/* Insert a new element.
* Will NOT overright an existing entry.
* Returns false if the element already exists. */
int aspell_string_map_insert(struct AspellStringMap * ths, const char * key,
const char * value);
/* Insert a new element.
* Will overright an existing entry.
* Always returns true. */
int aspell_string_map_replace(struct AspellStringMap * ths, const char * key,
const char * value);
/* Looks up an element.
* Returns null if the element did not exist.
* Returns an empty string if the element exists but has a null value.
* Otherwises returns the value */
const char * aspell_string_map_lookup(const struct AspellStringMap * ths, const
char * key);
/***************************** string pair *****************************/
struct AspellStringPair {
const char * first;
const char * second;
};
typedef struct AspellStringPair AspellStringPair;
/*********************** string pair enumeration ***********************/
typedef struct AspellStringPairEnumeration AspellStringPairEnumeration;
int aspell_string_pair_enumeration_at_end(const struct
AspellStringPairEnumeration * ths);
struct AspellStringPair aspell_string_pair_enumeration_next(struct
AspellStringPairEnumeration * ths);
void delete_aspell_string_pair_enumeration(struct AspellStringPairEnumeration *
ths);
struct AspellStringPairEnumeration * aspell_string_pair_enumeration_clone(const
struct AspellStringPairEnumeration * ths);
void aspell_string_pair_enumeration_assign(struct AspellStringPairEnumeration *
ths, const struct AspellStringPairEnumeration * other);
#ifdef __cplusplus
}
#endif
#endif /* ASPELL_ASPELL__H */
- [aspell-devel] doxigen API documentation,
Alexandre Leduc <=