.TH ppd_check_option_is_marked 3
.SH NAME
ppd_check_option_is_marked, ppd_mark_defaults, ppd_mark_option \- a set of functions
for determining the current status of PPD options and selecting them.
.SH SYNOPSIS
.B #include <ppd.h>
.sp
.B gboolean ppd_check_option_is_marked (PpdFile *ppd, const char *keyword, const char *option);
.sp
.B gint ppd_mark_option(PpdFile *ppd, const char *option, const char *choice);
.sp
.B void ppd_mark_defaults (PpdFile *ppd);
.SH "DESCRIPTION"
These three functions are used to query the marked status of an option
in a PPD file as well as forcing an option to be selected.
.sp
.SS ppd_check_option_is_marked(PpdFile *ppd, const char *option, const char *choice);
ppd_check_option_is_marked() accepts three parameters as input. The first is the PpdFile
pointer to a PPD file obtained by calling one of the \fBppd_load(3)\fP 
functions.  The second parameter is the option of the keyword name.  
The final input parameter is the actual choice name.
.sp
.SS ppd_mark_option(PpdFile *ppd, const char *option, const char *choice);
ppd_mark_option allows the programmer to manually select an option in a PPD
file.  The parameters are the a valid PpdFile pointer (see 
\fBppd_file_new(3)\fP), the option name, and the choice name.
.sp
.SS void ppd_mark_defaults (PpdFile *ppd);
ppd_mark_defaults() resets all the default options in the PPD file specified
by the PpdFile pointer (see \fBppd_file_new(3)\fP).
.sp
.SH "RETURN VALUE"
.TP
ppd_check_option_is_marked()
FALSE if the option is not currently selected and TRUE is it marked
.TP
ppd_mark_option()
Always returns 0.  The only means of determining whether or not
the function succeeded is to make a subsequent call to ppd_check_option_is_marked()
on the same option.
.sp
.SH "SEE ALSO"
ppd_file_new(3), ppd_emit_to_file(3), ppd_file_free(3), ppd_find_choice(3),
ppd_get_num_conflicts(3), ppd_get_page_length(3)
.sp
.SH AUTHOR
This man page was written by Gerald Carter <gcarter@valinux.com>.
It was updated by Mark Fasheh <mfasheh@valinux.com> to reflect changes in libppd 0.5.  Some of the code was originally part of the Common UNIX Printing System (CUPS).