X-Git-Url: https://code.delx.au/gnu-emacs-elpa/blobdiff_plain/3ad3bf290c5527930de97589a89e2891ac023895..4bb39f7378b13ff4c536b863f32f324c31ed5b75:/packages/compact-docstrings/README.rst

diff --git a/packages/compact-docstrings/README.rst b/packages/compact-docstrings/README.rst
new file mode 100644
index 000000000..7a56b5a59
--- /dev/null
+++ b/packages/compact-docstrings/README.rst
@@ -0,0 +1,23 @@
+=============================
+ Compact docstrings in Emacs
+=============================
+
+Shrink blank lines in docstrings and doc comments
+
+.. image:: etc/compact-docstrings.png
+
+Setup
+=====
+
+Enable locally with ``compact-docstrings-mode``::
+
+  (add-hook 'some-mode-hook #'compact-docstrings-mode)
+
+Enable globally (in all programming modes) with ``global-compact-docstrings-mode``::
+
+  (add-hook 'after-init-hook #'global-compact-docstrings-mode)
+
+Customization
+=============
+
+Enable compaction of all comments and strings by setting ``compact-docstrings-only-doc-blocks`` to ``nil``.  Change the compact line height by customizing ``compact-docstrings-face``.