Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

🐛 Fix mailbox attrs #73

Merged
merged 3 commits into from
Nov 22, 2022
Merged

🐛 Fix mailbox attrs #73

merged 3 commits into from
Nov 22, 2022

Conversation

nevans
Copy link
Collaborator

@nevans nevans commented Nov 21, 2022

I don't think many people use the Mailbox Attr and flags constants, but I had incorrectly capitalized some of them, so they didn't all work anyway. I intend to submit a future PR that does use these constants for some simple predicate methods, and that requires fixing them first.

Additionally, the first commit 6624000 (shared with several other PRs) fixes a long-outstanding issue with RDoc: section comments aren't rendered. I don't think that the way that I've fixed it here is ultimately the Right Way to fix it, but I want to push our updated documentation to https://ruby.github.io/net-imap, and my patched rdoc will work very well for that.

Once my rdoc fork was able to render the section comments, I made some significant formatting changes so it all reads much more nicely now.

@nevans nevans added bug Something isn't working documentation Improvements or additions to documentation labels Nov 21, 2022
@nevans nevans requested a review from shugo November 21, 2022 15:43
Copy link
Member

@shugo shugo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks fine except "nevans/rdoc" dependency.

@nevans
Copy link
Collaborator Author

nevans commented Nov 22, 2022

@shugo Thanks for catching my nevans/rdoc dependency. I've pushed this branch without that dependency and I'll update the other branches too.

Prepended modules are to:
* Fix `:section:` comments
* Convert the "note" list type to tables, like the hanna-nouveau format.
  Unlike hanna-nouveau, label lists remain lists.
* remove redundant "()" from methods

Add basic stylesheet tweaks to give more visual separation between
methods, make the navbar sticky, fix *bold* font-weight, etc.

n.b. some of these styles look best with a couple of rdoc darkfish
patches which have not (yet?) been accepted.
* Fix formatting and linking that wasn't obviously wrong before,
  because rdoc wasn't rendering the section comments before.
* Add some missing links.
* Update mailbox attributes section names
* link to #list
* simplify section names
Now the constants match Net::IMAP's behavior, so they can be used for
comparison.

Also add docs and aliases for flag and mailbox attrs.  Because the
consts are ALL_CAPS, it's nicer to use underscore versions.
@nevans nevans merged commit d59fb98 into master Nov 22, 2022
@nevans nevans deleted the fix-mailbox-attrs branch November 22, 2022 14:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working documentation Improvements or additions to documentation
Development

Successfully merging this pull request may close these issues.

2 participants