Bump to version 1.5.0

ChangeLog

@@ -1,6 +1,24 @@
+2021-03-06  Takaaki ISHIKAWA  <[email protected]>
+
+	* moom-font.el: version 1.5.0
+	- no changes
+
+	* moom.el: version 1.5.0
+	- [breaking change] moom-multi-monitors-support is t as default
+	- [new] moom-use-font-module
+	- [new] moom-update-user-margin
+	- [new] moom-cycle-monitors
+	- [improve] moom-check-user-margin
+	- [improve] Support Windows 10 and dual monitors
+	- [improve] Management of local margins in Windows 10
+	  - moom-fill-screen
+	  - moom-fill-width
+	  - moom-fill-height
+	- [new feature] disable font module by configuration
+
 2021-02-11  Takaaki ISHIKAWA  <[email protected]>
 
-	* moom-font.el version 1.4.0
+	* moom-font.el: version 1.4.0
 	- Count up just to sync the version of moom.el
 
 	* moom.el: version 1.4.0

README.org

@@ -83,18 +83,18 @@ These functions will not change font size in a frame.
 
 These functions normally change font size in a frame. But the behavior can be changed by =M-x moom-toggle-font-module=.
 
- - moom-fill-top
+ - moom-fill-width
+ - moom-fill-height
  - moom-fill-screen
+ - moom-fill-band
+ - moom-fill-top
  - moom-fill-bottom
  - moom-fill-left
  - moom-fill-right
  - moom-fill-top-left
  - moom-fill-top-right
  - moom-fill-bottom-left
  - moom-fill-bottom-right
- - moom-fill-width
- - moom-fill-height
- - moom-fill-band
 
 Note - If you find any problems around font settings when resizing the Emacs frame, you can easily disable the feature in =moom-font.el=. Just change =moom-use-font-module= to nil in your init.el. =M-x moom-toggle-font-module= can also control if the font module is utilized or not.
 
@@ -108,6 +108,7 @@ Note - If you find any problems around font settings when resizing the Emacs fra
  - moom-reset
  - moom-update-height-steps
  - moom-check-user-margin
+ - moom-update-user-margin
  - moom-identify-current-monitor
  - moom-print-monitors
  - moom-jump-to-monitor
@@ -126,32 +127,27 @@ Note - If you find any problems around font settings when resizing the Emacs fra
 
 *** How to setup screen margins
 
-For macOS users, the default margin is =(23 0 0 0)=. And for other system types, it is also automatically configured using combination of =frame-monitor-geometry= and =frame-monitor-workarea= when =moom-mode= is activated. But the actual work area is probably depends on user environment. Therefore, =moom.el= provides a capability that you can control the actual active region on your screen by setting =moom-user-margin=.
+For macOS users, the default margin is =(23 0 0 0)=. And for other system types, it is also automatically configured using combination of =frame-monitor-geometry= and =frame-monitor-workarea= when =moom-mode= is activated. But the actual work area is probably depends on user environment. Therefore, =moom.el= provides a capability that you can control the actual active region on your screen by setting =moom-user-margin= in init.el.
 
 #+begin_src emacs-lisp
 (setq moom-user-margin '(50 50 50 50)) ;; {top, bottom, left, right}
 (moom-mode 1)
 #+end_src
 
-Each value means a margin from the ~top~, ~bottom~, ~left~, and ~right~ edge of your screen. If you want to test some combinations of the margins, then =moom-check-user-margin= could be helpful since the frame will be expanded to the actual region on a screen. To reset the frame, =M-x moom-reset= can be used.
+Each value means a margin from the ~top~, ~bottom~, ~left~, and ~right~ edge of your screen. If you want to test some combinations of the margins, then =M-x moom-check-user-margin= could be helpful since it provides an interactive way to check the actual region on a screen and save the tested value for the Emacs session.
+
+It is also useful to use =moom-update-user-margin= directly by putting new margin or interactively. Note that =moom-check-user-margin= internally calls =moom-update-user-margin=.
 
 #+begin_src emacs-lisp
-(moom-check-user-margin '(50 50 50 50)) ;; {top, bottom, left, right}
+(moom-update-user-margin '(50 50 50 50)) ;; {top, bottom, left, right}
 #+end_src
 
-The =moom-check-user-margin= will fill your screen with the provided margins. The tested margins will NOT be immediately applied so please configure the margins in your init.el explicitly.
+The =moom-check-user-margin= and =moom-update-user-margin= will change =moom-user-margin= in an Emacs session, however, the updated margins will NOT be saved as a permanent value, so please configure the margins in your init.el explicitly for the next session.
 
 *** How to setup screen margins (obsolete)
 
 =moom-screen-margin= was replaced with =moom-check-user-margin=, see above section.
 
-Just provide a list to setup screen margins. The list consists of four values to control screen margins from the ~top~, ~bottom~, ~left~, and ~right~ edge. When you set the optional 2nd argument as =t=, then the frame will be automatically resized for filling screen with given margins.
-
-#+begin_src emacs-lisp
-(with-eval-after-load "moom"
-  (moom-screen-margin '(100 50 20 20) t)) ;; {top, bottom, left, right}
-#+end_src
-
 * Extension to integrate font resizing
 
 No need to load =moom-font.el= explicitly. If the package is installed in your system, then it will be activated automatically. The package is basically provided for the users who rely on Japanese fonts. And if you will never user the font module without deleting =moom-font.el=, please configure =moom-use-font-module= to nil before activating =moom-mode= by =(moom-mode 1)=.

moom.el

@@ -4,7 +4,7 @@
 
 ;; Author: Takaaki ISHIKAWA <takaxp at ieee dot org>
 ;; Keywords: frames, faces, convenience
-;; Version: 1.4.21
+;; Version: 1.5.0
 ;; Maintainer: Takaaki ISHIKAWA <takaxp at ieee dot org>
 ;; URL: https://github.com/takaxp/Moom
 ;; Package-Requires: ((emacs "25.1"))
@@ -1533,7 +1533,7 @@ The keybindings will be assigned when Emacs runs in GUI."
 (defun moom-version ()
   "The release version of Moom."
   (interactive)
-  (let ((moom-release "1.4.21"))
+  (let ((moom-release "1.5.0"))
     (message "[Moom] v%s" moom-release)))
 
 ;;;###autoload