Values, OsValues not reachable in docs

[bluss]

Iterators Values and OsValues are not reachable in the docs (they are black, non-links). This is because they are pub but not really reachable, so they are not linked.

Suggestion: Either make them reachable, or expand the documentation for values_of, values_of_os to spell it out exactly what the return value is (Iterator of X).

I'm new to this library, but it seems very solid, congratulations 😄

[kbknapp]

Thanks for pointing this out! Yeah, it's been in the back of my mind that I need to go through and not only ensure each of these types of things is reachable, but also inter-linked between all the different pieces.

I'm almost done with the base of the 3.x work to allow non-stringly typed usage (i.e. using enums as arg and subcommand keys), but I'll see if I can do this on the 2.x branch too.

Thanks for the kind words 😄

[kbknapp]

I'll use this as the tracking issue for:

• Ensure all public facing types are reachable
  • Values
  • OsValues
  • ArgSettings
• Ensure all types are inter-linked

[bluss]

ArgSettings is another.

[kbknapp]

ArgSettings was intentionally hidden since it's used internally, but I haven't yet decided if I wanted to expose it publicly.

[bluss]

it's used as a public argument type for a method on Arg I believe. Since it's not linked, it's hard to understand exactly how those methods are used.

[kbknapp]

Ah you're right, my mistake!

[kbknapp]

#508 takes care of all this. Finally, all types are inter-linked and the docs feel much more usable.