branch: externals/spacious-padding
commit fc0609182962649bbb7c2df8cff17614c0ecbef2
Author: Protesilaos Stavrou <[email protected]>
Commit: Protesilaos Stavrou <[email protected]>
Move the installation and sample configuration further up
---
README.org | 162 ++++++++++++++++++++++++++++++-------------------------------
1 file changed, 81 insertions(+), 81 deletions(-)
diff --git a/README.org b/README.org
index d6e51cf99b..786057c1c8 100644
--- a/README.org
+++ b/README.org
@@ -69,6 +69,87 @@ included in the section entitled “GNU Free Documentation
License.”
modify this GNU manual.”
#+end_quote
+* Installation
+:PROPERTIES:
+:CUSTOM_ID: h:f3bdac2c-4704-4a51-948c-a789a2589790
+:END:
+#+cindex: Installation instructions
+
+** GNU ELPA package
+:PROPERTIES:
+:CUSTOM_ID: h:42953f87-82bd-43ec-ab99-22b1e22955e7
+:END:
+
+The package is available as ~spacious-padding~. Simply do:
+
+: M-x package-refresh-contents
+: M-x package-install
+
+And search for it.
+
+GNU ELPA provides the latest stable release. Those who prefer to follow
+the development process in order to report bugs or suggest changes, can
+use the version of the package from the GNU-devel ELPA archive. Read:
+https://protesilaos.com/codelog/2022-05-13-emacs-elpa-devel/.
+
+** Manual installation
+:PROPERTIES:
+:CUSTOM_ID: h:d397712c-c8c0-4cfa-ad1a-ef28cf78d1f0
+:END:
+
+Assuming your Emacs files are found in =~/.emacs.d/=, execute the
+following commands in a shell prompt:
+
+#+begin_src sh
+cd ~/.emacs.d
+
+# Create a directory for manually-installed packages
+mkdir manual-packages
+
+# Go to the new directory
+cd manual-packages
+
+# Clone this repo, naming it "spacious-padding"
+git clone https://git.sr.ht/~protesilaos/spacious-padding spacious-padding
+#+end_src
+
+Finally, in your =init.el= (or equivalent) evaluate this:
+
+#+begin_src emacs-lisp
+;; Make Elisp files in that directory available to the user.
+(add-to-list 'load-path "~/.emacs.d/manual-packages/spacious-padding")
+#+end_src
+
+Everything is in place to set up the package.
+
+* Sample configuration
+:PROPERTIES:
+:CUSTOM_ID: h:5d16932d-4f7b-493d-8e6a-e5c396b15fd6
+:END:
+#+cindex: Package configuration
+
+#+begin_src emacs-lisp
+(use-package spacious-padding
+ :ensure t
+ :config
+ ;; These are the default values, but I keep them here for visibility.
+ ;; Also check `spacious-padding-subtle-frame-lines'.
+ (setq spacious-padding-widths
+ '( :internal-border-width 15
+ :header-line-width 4
+ :mode-line-width 6
+ :custom-button-width 3
+ :tab-width 4
+ :right-divider-width 30
+ :scroll-bar-width 8
+ :fringe-width 8))
+
+ (spacious-padding-mode 1)
+
+ ;; Set a key binding if you need to toggle spacious padding.
+ (define-key global-map (kbd "<f8>") #'spacious-padding-mode))
+#+end_src
+
* Overview
:PROPERTIES:
:CUSTOM_ID: h:ea728ce0-d319-4054-b8ee-5109a316c795
@@ -216,87 +297,6 @@ Users of Emacs 28 need to set
~x-underline-at-descent-line~ to a non-nil
value to get the desired spacing with the underlines. Newer versions of
Emacs give us control of this attribute at the level of the individual face.
-* Installation
-:PROPERTIES:
-:CUSTOM_ID: h:f3bdac2c-4704-4a51-948c-a789a2589790
-:END:
-#+cindex: Installation instructions
-
-** GNU ELPA package
-:PROPERTIES:
-:CUSTOM_ID: h:42953f87-82bd-43ec-ab99-22b1e22955e7
-:END:
-
-The package is available as ~spacious-padding~. Simply do:
-
-: M-x package-refresh-contents
-: M-x package-install
-
-And search for it.
-
-GNU ELPA provides the latest stable release. Those who prefer to follow
-the development process in order to report bugs or suggest changes, can
-use the version of the package from the GNU-devel ELPA archive. Read:
-https://protesilaos.com/codelog/2022-05-13-emacs-elpa-devel/.
-
-** Manual installation
-:PROPERTIES:
-:CUSTOM_ID: h:d397712c-c8c0-4cfa-ad1a-ef28cf78d1f0
-:END:
-
-Assuming your Emacs files are found in =~/.emacs.d/=, execute the
-following commands in a shell prompt:
-
-#+begin_src sh
-cd ~/.emacs.d
-
-# Create a directory for manually-installed packages
-mkdir manual-packages
-
-# Go to the new directory
-cd manual-packages
-
-# Clone this repo, naming it "spacious-padding"
-git clone https://git.sr.ht/~protesilaos/spacious-padding spacious-padding
-#+end_src
-
-Finally, in your =init.el= (or equivalent) evaluate this:
-
-#+begin_src emacs-lisp
-;; Make Elisp files in that directory available to the user.
-(add-to-list 'load-path "~/.emacs.d/manual-packages/spacious-padding")
-#+end_src
-
-Everything is in place to set up the package.
-
-* Sample configuration
-:PROPERTIES:
-:CUSTOM_ID: h:5d16932d-4f7b-493d-8e6a-e5c396b15fd6
-:END:
-#+cindex: Package configuration
-
-#+begin_src emacs-lisp
-(use-package spacious-padding
- :ensure t
- :config
- ;; These are the default values, but I keep them here for visibility.
- ;; Also check `spacious-padding-subtle-frame-lines'.
- (setq spacious-padding-widths
- '( :internal-border-width 15
- :header-line-width 4
- :mode-line-width 6
- :custom-button-width 3
- :tab-width 4
- :right-divider-width 30
- :scroll-bar-width 8
- :fringe-width 8))
-
- (spacious-padding-mode 1)
-
- ;; Set a key binding if you need to toggle spacious padding.
- (define-key global-map (kbd "<f8>") #'spacious-padding-mode))
-#+end_src
-
* Acknowledgements
:PROPERTIES:
:CUSTOM_ID: h:f8126820-3b59-49fa-bcc2-73bd60132bb9
