Skip to content

Manual update extracted from earlier PR - #1063

Merged
rswgnu merged 2 commits into
rswgnu:masterfrom
matsl:pr_update_install_doc
Oct 9, 2026
Merged

rswgnu merged 2 commits into
rswgnu:masterfrom
matsl:pr_update_install_doc

Conversation

@matsl

@matsl matsl commented Sep 30, 2026

Copy link
Copy Markdown
Collaborator

What

Proposal for update on the install documentation.

Why

With using use-package for configuration the text can be simplified.

Note

Draft WIP.

@rswgnu rswgnu left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

With my few comments fixed, I'll be ready to approve this.

Comment thread man/hyperbole.texi Outdated
Comment thread man/hyperbole.texi Outdated
Comment thread man/hyperbole.texi
the Emacs Package Manager with @bkbd{M-x list-packages @key{RET}},
then use the @bkbd{U} key followed by the @bkbd{x} key to upgrade all
out-of-date packages, Hyperbole among them. Then skip the text below
and move on to the next section, @pxref{Invocation}.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Why do you want to remove the description of how to update Hyperbole if you already have it installed via the regular package manager. Have all users really mastered how to do this with all the newbie-like users we see on reddit?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

My reasoning is this:

  • By telling users to learn how their package manager works they get to know that packages can be updated. Adding that in the install section seems to me to be to verbose.
  • I have not seen text about upgrades in other packages install instructions.
  • Update instructions could possibly fit better if really needed in a release announcement.

@rswgnu
rswgnu marked this pull request as ready for review October 9, 2026 19:20
@rswgnu
rswgnu merged commit 4403e7d into rswgnu:master Oct 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants