Main Page | Modules | Data Structures | Directories | File List | Data Fields | Globals | Related Pages

popthelp.c File Reference

#include "system.h"
#include <wchar.h>
#include "poptint.h"

Go to the source code of this file.

Data Structures

struct  poptDone_s
 Keep track of option tables already processed. More...

Defines

#define POPT_WCHAR_HACK

Typedefs

typedef poptDone_spoptDone
 Keep track of option tables already processed.

Functions

void displayArgs (poptContext con, enum poptCallbackReason foo, struct poptOption *key, const char *arg, void *data)
 Display arguments.
const char *const getTableTranslationDomain (const struct poptOption *table)
const char *const getArgDescrip (const struct poptOption *opt, const char *translation_domain)
char * singleOptionDefaultValue (size_t lineLength, const struct poptOption *opt, const char *translation_domain)
 Display default value for an option.
void singleOptionHelp (FILE *fp, size_t maxLeftCol, const struct poptOption *opt, const char *translation_domain)
 Display help text for an option.
size_t maxArgWidth (const struct poptOption *opt, const char *translation_domain)
 Find display width for longest argument string.
void itemHelp (FILE *fp, poptItem items, int nitems, size_t left, const char *translation_domain)
 Display popt alias and exec help.
void singleTableHelp (poptContext con, FILE *fp, const struct poptOption *table, size_t left, const char *translation_domain)
 Display help text for a table of options.
int showHelpIntro (poptContext con, FILE *fp)
void poptPrintHelp (poptContext con, FILE *fp, int flags)
size_t singleOptionUsage (FILE *fp, size_t cursor, const struct poptOption *opt, const char *translation_domain)
 Display usage text for an option.
size_t itemUsage (FILE *fp, size_t cursor, poptItem item, int nitems, const char *translation_domain)
 Display popt alias and exec usage.
size_t singleTableUsage (poptContext con, FILE *fp, size_t cursor, const struct poptOption *opt, const char *translation_domain, poptDone done)
 Display usage text for a table of options.
int showShortOptions (const struct poptOption *opt, FILE *fp, char *str)
 Return concatenated short options for display.
void poptPrintUsage (poptContext con, FILE *fp, int flags)
void poptSetOtherOptionHelp (poptContext con, const char *text)

Variables

poptOption poptAliasOptions []
 Empty table marker to enable displaying popt alias/exec options.
poptOption poptHelpOptions []
 Auto help table options.
poptOption poptHelpOptions2 []
poptOptionpoptHelpOptionsI18N = poptHelpOptions2


Detailed Description

Definition in file popthelp.c.


Define Documentation

#define POPT_WCHAR_HACK
 

Definition at line 13 of file popthelp.c.


Typedef Documentation

typedef struct poptDone_s * poptDone
 

Keep track of option tables already processed.

Referenced by poptPrintUsage(), and singleTableUsage().


Function Documentation

void displayArgs poptContext  con,
enum poptCallbackReason  foo,
struct poptOption key,
const char *  arg,
void *  data
[static]
 

Display arguments.

Parameters:
con context
foo (unused)
key option(s)
arg (unused)
data (unused)

Definition at line 29 of file popthelp.c.

References poptContext, poptPrintHelp(), poptPrintUsage(), and poptOption::shortName.

const char* const getArgDescrip const struct poptOption opt,
const char *  translation_domain
[static]
 

Parameters:
opt option(s)
translation_domain translation domain

Definition at line 109 of file popthelp.c.

References poptOption::argDescrip, poptOption::argInfo, D_, POPT_, POPT_ARG_DOUBLE, POPT_ARG_FLOAT, POPT_ARG_INT, POPT_ARG_LONG, POPT_ARG_NONE, POPT_ARG_STRING, POPT_ARG_VAL, and poptHelpOptions.

Referenced by maxArgWidth(), singleOptionHelp(), and singleOptionUsage().

const char* const getTableTranslationDomain const struct poptOption table  )  [static]
 

Parameters:
table option(s)

Definition at line 91 of file popthelp.c.

References poptOption::arg, poptOption::argInfo, poptOption::longName, and poptOption::shortName.

Referenced by singleTableHelp().

void itemHelp FILE *  fp,
poptItem  items,
int  nitems,
size_t  left,
const char *  translation_domain
[static]
 

Display popt alias and exec help.

Parameters:
fp output file handle
items alias/exec array
nitems no. of alias/exec entries
left largest argument display width
translation_domain translation domain

Definition at line 470 of file popthelp.c.

References poptOption::argInfo, poptOption::longName, poptItem_s::option, poptItem, poptOption::shortName, and singleOptionHelp().

Referenced by singleTableHelp().

size_t itemUsage FILE *  fp,
size_t  cursor,
poptItem  item,
int  nitems,
const char *  translation_domain
[static]
 

Display popt alias and exec usage.

Parameters:
fp output file handle
cursor current display position
item alias/exec array
nitems no. of ara/exec entries
translation_domain translation domain

Definition at line 656 of file popthelp.c.

References poptOption::arg, poptOption::argInfo, poptOption::longName, poptItem_s::option, poptItem, poptOption::shortName, and singleOptionUsage().

Referenced by poptPrintUsage().

size_t maxArgWidth const struct poptOption opt,
const char *  translation_domain
[static]
 

Find display width for longest argument string.

Parameters:
opt option(s)
translation_domain translation domain
Returns:
display width

Definition at line 409 of file popthelp.c.

References poptOption::arg, poptOption::argInfo, getArgDescrip(), poptOption::longName, and poptOption::shortName.

Referenced by poptPrintHelp().

int showHelpIntro poptContext  con,
FILE *  fp
[static]
 

Parameters:
con context
fp output file handle

Definition at line 538 of file popthelp.c.

References optionStackEntry::argv, poptContext_s::flags, poptContext_s::optionStack, POPT_, and poptContext.

Referenced by poptPrintHelp(), and poptPrintUsage().

int showShortOptions const struct poptOption opt,
FILE *  fp,
char *  str
[static]
 

Return concatenated short options for display.

Todo:
Sub-tables should be recursed.
Parameters:
opt option(s)
fp output file handle
Return values:
str concatenation of short options
Returns:
length of display string

Definition at line 751 of file popthelp.c.

References alloca(), poptOption::arg, poptOption::argInfo, poptOption::longName, and poptOption::shortName.

Referenced by poptPrintUsage().

char* singleOptionDefaultValue size_t  lineLength,
const struct poptOption opt,
const char *  translation_domain
[static]
 

Display default value for an option.

Parameters:
lineLength display positions remaining
opt option(s)
translation_domain translation domain
Returns:

Definition at line 146 of file popthelp.c.

References _free(), poptOption::arg, poptOption::argInfo, D_, POPT_ARG_DOUBLE, POPT_ARG_FLOAT, POPT_ARG_INT, POPT_ARG_LONG, POPT_ARG_NONE, POPT_ARG_STRING, and POPT_ARG_VAL.

Referenced by singleOptionHelp().

void singleOptionHelp FILE *  fp,
size_t  maxLeftCol,
const struct poptOption opt,
const char *  translation_domain
[static]
 

Display help text for an option.

Parameters:
fp output file handle
maxLeftCol largest argument display width
opt option(s)
translation_domain translation domain

Definition at line 217 of file popthelp.c.

References _free(), poptOption::argDescrip, poptOption::argInfo, D_, poptOption::descrip, getArgDescrip(), poptOption::longName, ops, POPT_ARG_DOUBLE, POPT_ARG_FLOAT, POPT_ARG_INT, POPT_ARG_LONG, POPT_ARG_NONE, POPT_ARG_STRING, POPT_ARG_VAL, POPT_ARGFLAG_AND, POPT_ARGFLAG_ONEDASH, POPT_ARGFLAG_OR, POPT_ARGFLAG_XOR, poptOption::shortName, singleOptionDefaultValue(), and poptOption::val.

Referenced by itemHelp(), and singleTableHelp().

size_t singleOptionUsage FILE *  fp,
size_t  cursor,
const struct poptOption opt,
const char *  translation_domain
[static]
 

Display usage text for an option.

Parameters:
fp output file handle
cursor current display position
opt option(s)
translation_domain translation domain

Definition at line 582 of file popthelp.c.

References poptOption::argInfo, getArgDescrip(), poptOption::longName, POPT_ARGFLAG_ONEDASH, and poptOption::shortName.

Referenced by itemUsage(), and singleTableUsage().

void singleTableHelp poptContext  con,
FILE *  fp,
const struct poptOption table,
size_t  left,
const char *  translation_domain
[static]
 

Display help text for a table of options.

Parameters:
con context
fp output file handle
table option(s)
left largest argument display width
translation_domain translation domain

Definition at line 497 of file popthelp.c.

References poptContext_s::aliases, poptOption::arg, poptOption::argInfo, D_, poptOption::descrip, poptContext_s::execs, getTableTranslationDomain(), itemHelp(), poptOption::longName, poptContext_s::numAliases, poptContext_s::numExecs, poptContext, poptOption::shortName, and singleOptionHelp().

Referenced by poptPrintHelp().

size_t singleTableUsage poptContext  con,
FILE *  fp,
size_t  cursor,
const struct poptOption opt,
const char *  translation_domain,
poptDone  done
[static]
 

Display usage text for a table of options.

Parameters:
con context
fp output file handle
cursor current display position
opt option(s)
translation_domain translation domain
done tables already processed
Returns:

Definition at line 700 of file popthelp.c.

References poptOption::arg, poptOption::argInfo, poptOption::longName, poptDone_s::maxopts, poptDone_s::nopts, poptDone_s::opts, poptContext, poptDone, poptOption::shortName, and singleOptionUsage().

Referenced by poptPrintUsage().


Variable Documentation

struct poptOption poptHelpOptions[]
 

Initial value:

 {
  { NULL, '\0', POPT_ARG_CALLBACK, (void *)&displayArgs, '\0', NULL, NULL },
  { "help", '?', 0, NULL, '?',  "Show this help message" , NULL },
  { "usage", '\0', 0, NULL, 'u',  "Display brief usage message" , NULL },
    POPT_TABLEEND
}
Auto help table options.

Definition at line 61 of file popthelp.c.

Referenced by getArgDescrip().

struct poptOption poptHelpOptions2[] [static]
 

Initial value:

 {

  { NULL, '\0', POPT_ARG_INTL_DOMAIN, PACKAGE, 0, NULL, NULL},

  { NULL, '\0', POPT_ARG_CALLBACK, (void *)&displayArgs, '\0', NULL, NULL },
  { "help", '?', 0, NULL, '?',  "Show this help message" , NULL },
  { "usage", '\0', 0, NULL, 'u',  "Display brief usage message" , NULL },




    POPT_TABLEEND
}

Definition at line 69 of file popthelp.c.

struct poptOption* poptHelpOptionsI18N = poptHelpOptions2
 

Definition at line 84 of file popthelp.c.


Generated on Tue May 30 14:44:32 2006 for rpm by  doxygen 1.3.9.1