[Bug 1637573] [NEW] popt man pages are incomplete and erroneous

[Daniel U. Thibault]

Public bug reported:

Error in popt man pages: the e-address ewt at redhat.com is invalid
(probably has been for quite some time)

Omissions in popt man pages:

1) poptParseArgvString has an undocumented return int value. What does
it return and what does it mean?

2) poptGetArg recovers “leftover arguments” but its documentation fails
to make it clear that it should not be called until poptGetNextOpt has
returned -1.  I ran into this with an app that used popt but knew that
it had no options to check for: after generating the context with
poptGetContext, it tried to jump directly to poptGetArg, with disastrous
results.

** Affects: popt (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: manpage

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to popt in Ubuntu.
https://bugs.launchpad.net/bugs/1637573

Title:
  popt man pages are incomplete and erroneous

Status in popt package in Ubuntu:
  New

Bug description:
  Error in popt man pages: the e-address ewt at redhat.com is invalid
  (probably has been for quite some time)

  Omissions in popt man pages:

  1) poptParseArgvString has an undocumented return int value. What does
  it return and what does it mean?

  2) poptGetArg recovers “leftover arguments” but its documentation
  fails to make it clear that it should not be called until
  poptGetNextOpt has returned -1.  I ran into this with an app that used
  popt but knew that it had no options to check for: after generating
  the context with poptGetContext, it tried to jump directly to
  poptGetArg, with disastrous results.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/popt/+bug/1637573/+subscriptions