Library info+.el extends the standard Emacs library info.el in several ways. Info+ provides:
‘C-h C-b’ to show the metadata for a (bookmarked) node. This is all of the associated bookmark information, including the annotation and tags for that node and the number of times you have visited it. If invoked with point on a link, the targeted node is described; otherwise, you are prompted for the node name.‘Info-fontify-bookmarked-xrefs-flag’ controls whether this is done.‘info-xref-bookmarked’ by default, but you can set the face to use for a given Info bookmark using ‘C-x f’ (command ‘Info-set-face-for-bookmarked-xref’). This gives you an easy way to classify nodes and show the class of a node by its links. Uses faces to make clear which nodes are most important to you, or which are related to this or that general topic.‘Info-node-access-invokes-bookmark-flag’ is non-‘nil’ then going to a bookmarked Info node invokes its bookmark, so that the node metadata (such as number of visits) gets updated. Command ‘Info-toggle-node-access-invokes-bookmark’ toggles the option value.‘bmkp-info-auto-bookmark-mode’. Toggle the mode off anytime you do not want to record Info visits.‘C-x r l’) you can sort bookmarks by the time of last visit (‘s d’) or by the number of visits (‘s v’). This gives you an easy way to see which parts of which Info manuals you have visited most recently and how much you have visited them.‘Info-toc-outline’ (bound to ‘O’) opens a separate Info buffer showing the table of contents (TOC). This is similar to the standard command ‘Info-toc’ (bound to ‘T’), but the buffer is cloned from the manual and is in ‘outline-minor-mode’. Also, there is no redundancy, by default: each TOC entry is listed only once, not multiple times. (This is controlled by option ‘Info-toc-outline-no-redundancy-flag’.)‘*note’ … `::’ surrounding links) is kept hidden.‘C-x DEL’), and the Info+ bookmarking enhancements (e.g., special link highlighting and persistently tracking the number of visits per node), ‘Info-toc-outline’ gives you a way to organize access and visibility of a manual’s nodes, to reflect how you use it.‘name-stands-out’ or `name-stands-out', and strings, like this: "string-stands-out" are highlighted if ‘Info-fontify-quotations-flag’ is non-‘nil’.<tab>, are highlighted if ‘Info-fontify-angle-bracketed-flag’ and ‘Info-fontify-quotations-flag’ are non-‘nil’.'foobar, are highlighted if ‘Info-fontify-single-quote-flag’ and ‘Info-fontify-quotations-flag’ are non-‘nil’._this is emphasized text_ ,is highlighted if ‘Info-fontify-emphasis-flag’ is non-‘nil’. (But if internal variable ‘info-fontify-emphasis’ is ‘nil’ then there is no such highlighting, and that option has no effect.)‘Info-fontify-*-flag’ options from the ‘Info’ menu or using an ‘Info-toggle-fontify-*’ command. For example, command ‘Info-toggle-fontify-emphasis’ toggles option ‘Info-fontify-emphasis-flag’.*Info* buffer, showing some of the highlighting:‘Toggle Breadcrumbs’ in ‘mouse-3’ mode-line menu and ‘Toggle Breadcrumbs in Mode Line’ in ‘Info’ menu (e.g. in the minor-mode indicator). You can customize option ‘Info-breadcrumbs-in-mode-line-mode’ if you want to turn it off by default. (Available for Emacs 23+ only.)‘Toggle Breadcrumbs in Header Line’ in ‘Info’ menu. Be aware that unlike breadcrumbs in the mode line, this can occasionally throw off the destination accuracy of cross references and searches slightly. Here is a screenshot showing breadcrumbs in the header line (only):‘info-display-manual’: Completion for manual name.‘Info-goto-emacs-key-command-node’: If the key’s command is not found, then it searches for the key sequence in the text.') and non-breaking space have punctuation syntax, not word syntax. So for example, you can easily use ‘C-s C-w’ to select text between `…' without also grabbing the ' at the end. (I reported this as Emacs bug #3312, which was fixed a couple years later in Emacs 24.)‘Info-fit-frame-flag’ is non-‘nil’).‘search-highlight’ is non-‘nil’).‘*info*’ has been removed from ‘same-window-buffer-names’, so that a separate window can be used if you so choose.‘Info-virtual-book’ (bound to ‘v’) – Open a virtual Info manual of saved nodes from any number of manuals. The nodes are those saved in option ‘Info-virtual-book’. With ‘C-u’, bookmarked Info nodes are also included. See also `icicle-Info-virtual-book’.‘Info-persist-history-mode’ – Enabling this minor mode saves the list of your visited Info nodes between Emacs sessions. Together with command ‘Info-history’ (bound to ‘L’ by default), this gives you a persistent virtual manual of the nodes you have visited in the past. If the mode is enabled then the list of visited nodes is saved to the file named by option ‘Info-saved-history-file’ when you quit Emacs (not Info) or when you kill an Info buffer. (If you also use library Bookmark+ then you can also bookmark Info nodes, including automatically. This records how many times you have visited each node and when you last did so.)‘Info-change-visited-status’ (bound to ‘C-x DEL’) – Toggle or set the visited status of the node at point or the nodes in the active region. Useful if you use ‘Info-fontify-visited-nodes’ to show you which nodes you have visited. No prefix arg: toggle. Non-negative prefix arg: set to visited. Negative prefix arg: set to unvisited.‘Info-save-current-node’ (bound to `.’) – Save name of current node to list ‘Info-saved-nodes’, for use by ‘v’ (‘Info-virtual-book’).‘Info-merge-subnodes’ – Integrate the current Info node with its subnodes (the nodes in its Menu), perhaps recursively.‘Info-merge-subnodes’ to extract a self-contained report (possibly the whole manual) from an Info manual. The report is itself an Info buffer, with hyperlinks and normal Info behavior.
‘mkhtml-any-buffer’) from library Lisp:mkhtml.el. For more information, see SaveAsHtml. (That code is quite old, however.)See Also: Icicles - Info Enhancements.
Your recognition of info-quoted-name seems like is not right, e.g.
`(a list of (+ 2 3) elements)
info-quoted-name highlight it. – ahei
Only if it is followed (somewhere) by a normal single-quote: '. But yes, otherwise, you are correct.
Highlighting ‘...’ or `...', and "..." strings is problematic. In general, the results are good, but there are several things that can throw it off. Fortunately, these things do not occur that commonly in manuals – but they do occur. The more typical problem is an isolated " character referred to as such in the manual (e.g. ?"). You’ll just have to live with it or, if you think it’s not worth it, customize ‘Info-fontify-quotations-flag’ to nil. – DrewAdams
OK, I see – ahei
Hi! A quick question: how to prevent info+ to split my window. I want the original info behavior, if i type M-x info, i want a full window to read. Thanks! --PasJa
Should be OK now. I had some hard-coded cruft leftover from 1999. Thx – DrewAdams
Hi! Version info in current update is inconsistent with previous one. We had Version 21.1 Update #: 4855 while currently Version is 0 with Update #: 4857 Could you correct this? Thanks! --Marcin
Hi Marcin. It is correct as is. I don’t use version information for info+.el (or for most of my other libraries either). package.el needs header field ‘Package-Requires’ to include a version number, however. (Pseudo) version ‘0’ allows any package requiring the given package to use any version of the required one.
Each of my library files has a ‘Last-Updated’ field that has the date and last `Update #’ (which is incremented each time I save the file). This is the best info to use for reporting/communicating (e.g. about bugs). Users can ignore the ‘Version’ field for most of my libraries.
Thx – DrewAdams
CategoryDocumentation CategoryHelp CategoryHypermedia CategoryModes