Commit a215930c authored by Glenn Morris's avatar Glenn Morris

Some package doc updates

* doc/emacs/help.texi (Package Keywords): Mention describe-package buttons.

* doc/emacs/package.texi (Package Menu): Mention package-menu-filter.

* lisp/emacs-lisp/package.el (package-menu-mode-map): Tweak menu.
(package-menu-filter): Rename from package-menu-filter-interactive.
Doc fix.

* etc/NEWS: Related edits.  Copyedit.
parent 81bf5420
2014-02-12 Glenn Morris <rgm@gnu.org>
* help.texi (Package Keywords): Mention describe-package buttons.
* package.texi (Package Menu): Mention package-menu-filter.
2014-02-11 Lars Ingebrigtsen <larsi@gnus.org>
* text.texi (Editing Format Info): Use @samp for menus (bug#13736).
......
......@@ -458,7 +458,9 @@ buffer (@pxref{Package Menu}).
@kindex C-h P
@kbd{C-h P} (@code{describe-package}) prompts for the name of a
package, and displays a help buffer describing the attributes of the
package and the features that it implements.
package and the features that it implements. The buffer lists the
keywords that relate to the package in the form of buttons. Click on
a button to see other packages related to that keyword.
@node Language Help
@section Help for International Language Support
......
......@@ -126,6 +126,12 @@ dependencies; also, delete all packages marked with @kbd{d}
Refresh the package list (@code{package-menu-refresh}). This fetches
the list of available packages from the package archive again, and
recomputes the package list.
@item f
Filter the package list (@code{package-menu-filter}). This prompts
for a keyword (e.g., @samp{games}), then shows only the packages
that relate to that keyword. To restore the full package list,
type @kbd{q}.
@end table
@noindent
......
......@@ -197,16 +197,15 @@ command `frame-configuration-to-register' still exists, but is unbound.
These are normal hooks run when an Emacs frame gains or loses input focus.
---
*** Emacs can now draw dividers between adjacent windows. To put
dividers between side-by-side windows customize the frame parameter
right-divider-width to some positive integer. To put dividers between
vertically stacked windows set the frame parameter bottom-divider-width
to some positive integer. Dividers can be dragged with the mouse and
show a corresponding cursor when the mouse hovers over them. The
appearance of dividers can be changed by customizing the basic faces
window-divider, window-divider-first-pixel and window-divider-last-pixel
where the latter two are useful to provide a 3D effect or to better set
dividers apart from surrounding display objects.
*** Emacs can now draw dividers between adjacent windows.
To put dividers between side-by-side/vertically stacked windows
customize the frame parameter `right-divider-width'/`bottom-divider-width'
to some positive integer. You can drag dividers with the mouse
(they show a corresponding cursor when the mouse hovers over them).
You can change the appearance of dividers by customizing the faces
`window-divider', `window-divider-first-pixel', and
`window-divider-last-pixel'. The last two are useful to provide a 3D
effect, or to better distinguish dividers from surrounding display objects.
---
*** `split-window' is now a non-interactive function, not a command.
......@@ -673,19 +672,21 @@ Use `electric-indent-mode' instead.
** Package
+++
*** In the `list-packages' buffer, you can use `f' (`package-menu-filter')
to filter the list of packages by a keyword.
+++
*** In the `describe-package' buffer, there are now buttons listing the
keywords related to the package. Click on a button to see other packages
related to that keyword.
---
*** The format of `archive-contents' files, generated by package
repositories, has changed to allow a new (fifth) element in the data
vectors, containing an associative list with extra properties.
*** `describe-package' buffer uses the `:url' extra property to
display a `Homepage' header, if it's present.
*** In the buffer produced by `describe-package', there are now buttons
listing the keywords related to that package. You can click on them
to see other packages related to any given keyword.
*** In the *Packages* buffer, `f' or the Package->Filter menu filters
the packages by a keyword.
(For example, `describe-package' uses the `:url' extra property to
display a "Homepage" header.)
---
** In Prolog mode, `prolog-use-smie' has been removed,
......
2014-02-12 Glenn Morris <rgm@gnu.org>
* emacs-lisp/package.el (package-menu-mode-map): Tweak menu.
(package-menu-filter): Rename from package-menu-filter-interactive.
Doc fix.
2014-02-11 Juanma Barranquero <lekktu@gmail.com>
* frameset.el (frameset--jump-to-register): Select the required
......@@ -73,9 +79,6 @@
(custom-buffer-create): Doc fix (bug#11122).
(custom-sort-items): Doc fix (bug#11121).
* dired-aux.el (dired-copy-file-recursive): Remove slighly
misleading comment (bug#11328).
* repeat.el (repeat-message-function): Reword doc slightly (bug#11619).
* icomplete.el (icomplete-with-completion-tables): Doc fix (bug#11654).
......
......@@ -1570,7 +1570,7 @@ If optional arg NO-ACTIVATE is non-nil, don't activate packages."
(define-key map "i" 'package-menu-mark-install)
(define-key map "U" 'package-menu-mark-upgrades)
(define-key map "r" 'package-menu-refresh)
(define-key map "f" 'package-menu-filter-interactive)
(define-key map "f" 'package-menu-filter)
(define-key map "~" 'package-menu-mark-obsolete-for-deletion)
(define-key map "x" 'package-menu-execute)
(define-key map "h" 'package-menu-quick-help)
......@@ -1579,9 +1579,6 @@ If optional arg NO-ACTIVATE is non-nil, don't activate packages."
(define-key menu-map [mq]
'(menu-item "Quit" quit-window
:help "Quit package selection"))
(define-key menu-map [mf]
'(menu-item "Filter" package-menu-filter-interactive
:help "Filter package selection (q to go back)"))
(define-key menu-map [s1] '("--"))
(define-key menu-map [mn]
'(menu-item "Next" next-line
......@@ -1606,6 +1603,9 @@ If optional arg NO-ACTIVATE is non-nil, don't activate packages."
'(menu-item "Mark Upgradable Packages" package-menu-mark-upgrades
:help "Mark packages that have a newer version for upgrading"))
(define-key menu-map [s3] '("--"))
(define-key menu-map [mf]
'(menu-item "Filter Package List..." package-menu-filter
:help "Filter package selection (q to go back)"))
(define-key menu-map [mg]
'(menu-item "Update Package List" revert-buffer
:help "Update the list of packages"))
......@@ -2120,8 +2120,12 @@ shown."
(package-menu--generate nil packages keywords))
(switch-to-buffer buf)))
(defun package-menu-filter-interactive (keyword)
"Filter the *Packages* buffer."
;; package-menu--generate rebinds "q" on the fly, so we have to
;; hard-code the binding in the doc-string here.
(defun package-menu-filter (keyword)
"Filter the *Packages* buffer.
Show only those items that relate to the specified KEYWORD.
To restore the full package list, type `q'."
(interactive (list (completing-read "Keyword: " (package-all-keywords))))
(package-show-package-list t (list keyword)))
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment