Skip to content

📚 Various documentation updates - #763

Merged
nevans merged 6 commits into
masterfrom
rdoc-updates
Sep 8, 2026
Merged

📚 Various documentation updates#763
nevans merged 6 commits into
masterfrom
rdoc-updates

Conversation

@nevans

@nevans nevans commented Sep 8, 2026

Copy link
Copy Markdown
Collaborator
  • Update responses frozen_dup documentation (should've been updated by v0.6.0).
  • Add missing method and attributes to Net::IMAP "What's here" list.
  • Other minor changes to Net::IMAP "What's here" list.
  • Add warnings to ssl_ctx and ssl_ctx_params rdoc.
  • Add line breaks to long lines in README.
  • Add "What's here" section to Net::IMAP::Config
  • Update basic usage examples in README and Net::IMAP class rdoc

This should've been updated for v0.6.0.
In addition to minor changes to a some of the documentation text, this
adds some missing methods and attributes and a couple of new sections.
Emphasizes that these attributes to _NOT_ indicate a secure connection.
This is especially usefor for Config, since rdoc doesn't include
attributes in the sidebar method list.
This simplifies some of the examples to to remove unnecessary confusing
bits, or to operate on message sets without looping.  This also updates
them to use more modern features and work in more situations.

More documentation is added to the Net::IMAP class rdoc examples,
linking to the various commands.  The README examples have been updated
to match, but the text has been intentionally left out to keep it simple
and clean.

These are only meant as simple examples, so they're still missing error
handling that would be needed in a production system.
@nevans nevans added the documentation Improvements or additions to documentation label Sep 8, 2026
@nevans
nevans merged commit 9cd9fbd into master Sep 8, 2026
34 checks passed
@nevans
nevans deleted the rdoc-updates branch September 8, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant