diff --git a/src/tools/editors/emacs.samples b/src/tools/editors/emacs.samples
index a4d00bedc4..b15f8fee4e 100644
--- a/src/tools/editors/emacs.samples
+++ b/src/tools/editors/emacs.samples
@@ -76,3 +76,20 @@
 	       ))))
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+
+;;; To work on the documentation, the following (or a variant, as above)
+;;; can be helpful.
+
+(defun pgsql-sgml-mode ()
+  "SGML mode adjusted for PostgreSQL project"
+  (interactive)
+  (sgml-mode)
+
+  (setq sgml-basic-offset 1)
+)
+
+(setq auto-mode-alist
+  (cons '("\\(postgres\\|pgsql\\).*\\.sgml\\'" . pgsql-c-mode)
+        auto-mode-alist))
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;