NEWS (7890B)
1 -*- org -*- 2 3 * Version 1.0.0 (Under Development) 4 From this version onward, we will follow Semantic Versioning for new ~pdf-tools~ releases. 5 6 ** Breaking changes: 7 *** Raise the minimum supported version of Emacs to 26.3 #26 8 Drop support for Emacs 24 and 25. This allows for some code cleanup. *This is a major breaking change*. 9 *** Change the default value of pdf-view-use-scaling #133 10 ~pdf-view-use-scaling~ is now true by default, leading to rendering of crisp images on high-resolution screens. This should not cause problems on low-resolution screen (other than taking up more cache space / increasing rendering time), but if it does, please ~(setq pdf-view-use-scaling nil)~ in your configuration. 11 12 ** Improve overall user experience 13 - Set ~pdf-annot-list-highlight-type~ to true by default. 14 + Show annotation color when listing them by default, allow the user to turn them off if need be. 15 16 ** Make changes required by newer versions of Emacs 17 - Emacs 29 introduces ~pixel-scroll-precision-mode~, which interferes with ~pdf-view~ scrolling. This is fixed in #124 18 19 ** Functionality fixes and improvements 20 - Fix ~revert-buffer~ to correctly work over Tramp #128 21 - Fix sorting by date in ~pdf-annot-list-mode~ #75 22 23 * Version 0.91 24 ** Change the keybindings for traversing history 25 This is a minor but *breaking change*. ~l~ (backward) and ~r~ (forward) are the conventional bindings for history navigation in Emacs, but ~pdf-tools~ uses ~B~ and ~N~. The previous keybindings are kept as-is for people who were used to it, while introducing ~l~ and ~r~ keybindings as well. 26 27 This is a breaking change because ~r~ was previously bound to ~revert-buffer~. However, ~g~ is also bound to ~revert-buffer~ and is the conventional binding for ~revert~ so this should be okay. 28 29 ** Make changes required by newer versions of Emacs 30 A number of changes are made to support new elisp / package changes. There is no impact of this on existing users. 31 - Emacs 27, Emacs 28 and Emacs 29 are supported now. 32 - Synctex 1.21 is supported now. 33 ** Improve overall install experience 34 Running ~M-x pdf-tools-install~ should _just work_ now. 35 ** Add support for high-resolution displays (Retina display on Mac) 36 Setting ~pdf-view-use-scaling~ to a non-nil value now renders crisp images on high-resolution displays. 37 * Version 0.90 38 ** The displayed columns when listing annotations is now customizable 39 See variable ~pdf-annot-list-format~ and ~pdf-annot-list-highlight-type~. 40 ** Improved handling of default annotation properties 41 A new variable ~pdf-annot-default-annotation-properties~ was introduced, subsuming and obsoleting ~pdf-annot-default-text-annotation-properties~ and ~pdf-annot-default-markup-annotation-properties~. The new variable lets the user choose default properties, e.g. a color, for all supported annotations separately. 42 ** Provide a faster "boot-loader" 43 The autoloaded function ~pdf-loader-install~ acts as a replacement for ~pdf-tools-install~ and makes Emacs load and use PDF Tools as soon as a PDF file is opened, but not sooner. 44 ** Improved the process of (re)compiling the server 45 This obsoletes the variable ~pdf-tools-handle-upgrades~, which does nothing anymore. 46 * Version 0.80 47 ** Tablist package 48 The files ~tablist.el~ and ~tablist-filter.el~ are no longer part of ~pdf-tools~, but continue to live on in the ~tablist~ package, on which ~pdf-tools~ now depends on. 49 ** View 50 *** Encrypted files 51 When encountering an encrypted file, query for a password and attempt to decrypt it. 52 *** Backward sync from isearch 53 In ~isearch~, press ~M-s s~ to visit the source of the current match. 54 *** Disable unicode in mode-line 55 New variable ~pdf-view-use-unicode-lighter~ which allows for disabling the use of unicode in the mode-line. 56 * Version 0.70 57 ** View 58 *** Register integration 59 The keys ~m~ and ~'~ now set respectively to jump to a register corresponding to a position in the PDF. Also ~''~ is handled special: It jumps to the position before the last register-jump. 60 *** Export parts of a page as an image 61 See ~pdf-view-extract-region-image~. 62 ** Info 63 *** Interface changes 64 The return value of many pdf-info-* functions was changed in order to prefer alists over other data-structures (indexed lists, trees). 65 ** Virtual PDF 66 A virtual PDF is a collection of pages (or parts thereof) of arbitrary documents, which appear to the rest of ~pdf-tools~ as one big PDF, though they are always read-only. 67 68 * Version 0.60 69 ** Regexp support 70 You may now search for perl-compatible regular expressions (PCRE) in PDF documents, both via Isearch and Occur. If that scares you, customize the variable ~pdf-occur-prefer-string-search~. 71 ** Occur 72 *** Asynchronous search 73 Searching is performed asynchronously in a private server instance, i.e. it doesn't block neither ordinary editing nor ~pdf-view-mode~. 74 *** Moccur 75 Added the ability to search multiple documents in one occur buffer. 76 ** Isearch 77 *** Occur Integration 78 ~M-s o~ now starts occur, while keeping the isearch session, like it is in text-buffers. 79 *** Word search 80 ~M-s w~ now does a word search, which will also find hyphenated words (as determined by ~pdf-isearch-hyphenation-character~), though not at page boundaries. 81 ** View 82 *** Navigate by pagelabels 83 ~M-g l~ may be used to jump to a page by label, i.e. its displayed number. 84 *** Rendering 85 Added the ability to display the page as it would be printed (e.g. w/o annotations) via ~pdf-view-printer-minor-mode~ and to apply a color filter via ~pdf-view-midnight-minor-mode~. 86 ** Outline 87 New option ~pdf-outline-display-labels~, determining whether to display labels instead of plain page-numbers. 88 * Version 0.50 89 ** PDF Tools is now available on MELPA. 90 ** SyncTeX 91 *** File name handling 92 SyncTeX is pretty picky about source filenames. So instead of trying various filenames and hoping for best, we find it by directly inspecting the database. 93 *** Heuristic backward search 94 Backward searching now tries to find the exact position in the LaTeX buffer. This may be disabled by setting ~pdf-sync-backward-use-heuristic~ to ~nil~. 95 *** Renamed most variables/functions/commands. 96 The old ones are still there but declared obsolete. 97 ** Compatible with Emacs 24.3 98 ** Integrate with bookmark.el 99 ** Compiling on OSX 100 PDF Tools should now compile on OSX, though it is unsupported. 101 ** MELPA 102 Try to handle an update via MELPA by ~package.el~ by shutting down the server, recompiling and restarting it. This may be deactivated by setting ~pdf-tools-handle-upgrades~ to nil. 103 ** Auto slicing 104 A new minor mode which will automatically slice the page according to its bounding box. 105 * Version 0.40 106 I basically reimplemented the whole thing. (Not really, but a lot has changed.) 107 ** Displaying PDF Files. 108 Rendering is now done almost completely in ~libpoppler~ (no convert anymore), while PNG images are kept in memory and files are solely used as a means of exchange between Emacs and ~epdfinfo~. In essence, display should be much faster. 109 *** New Major Mode pdf-view 110 Hacking up ~doc-view.el~ to support a server-based *rendering engine* would have been to awkward. So a new major-mode was needed : ~pdf-view-mode~. Both are very similar regarding user-interface. Some differences are: 111 + Setting the width to ~fit-width~, ~fit-height~ or ~fit-page~ keeps up with window-size changes. 112 + The values of the slice are relative, i.e. independent of the ~image-size~. 113 *** PNG Image Cache 114 Image data is cached, in order to keep the time it needs to display a page low. Some pages are pre-loaded for the same reason, while idling. The number of cached images per buffer may be customized using ~pdf-cache-image-limit~. 115 ** Annotations 116 *** New supported types 117 Provided ~epdfinfo~ was build with a recent version of ~libpoppler~, you may now create and modify the following markup annotation types: highlight, squiggly, underline and strike-out. 118 ** Various 119 *** You may now select extended regions with C-mouse-1. 120 *** Numerous other changes