update packages

lisp/ess/ess-custom.el

@@ -1571,6 +1571,12 @@ by `ess-function-template'."
   :group 'ess
   :type 'regexp)
 
+(defcustom ess-r-outline-regexp
+  "^[ \t]*#+ +.*\\(?:----\\|====\\|####\\)\\s-*$"
+  "Regexp used to detect the beginning of R headings."
+  :group 'ess-R
+  :type 'regexp)
+
 
  ; ess-inf: variables for inferior-ess.
 

lisp/ess/ess-pkg.el

@@ -1,10 +1,10 @@
 ;; -*- no-byte-compile: t; lexical-binding: nil -*-
-(define-package "ess" "20251015.1619"
+(define-package "ess" "20251212.937"
   "Emacs Speaks Statistics."
   '((emacs "25.1"))
   :url "https://ess.r-project.org/"
-  :commit "a7d685bd9a3dbc8540edf86318012a0a0528e49e"
-  :revdesc "a7d685bd9a3d"
+  :commit "e39ca8fa7fce703aa2851e83987a412737d575f0"
+  :revdesc "e39ca8fa7fce"
   :authors '(("David Smith" . "dsmith@stats.adelaide.edu.au")
              ("A.J. Rossini" . "blindglobe@gmail.com")
              ("Richard M. Heiberger" . "rmh@temple.edu")

lisp/ess/ess-r-mode.el

@@ -299,6 +299,14 @@ When t, loading a file into a namespaced will output information
 about which objects are exported and which stay hidden in the
 namespace.")
 
+(defun ess-r-outline-level ()
+  "R mode `outline-level` function."
+  (save-excursion
+    (beginning-of-line)
+    (if (looking-at "^[ \t]*\\(#+\\)\\s-")
+	(length (match-string 1))
+      1000)))
+
 ;; The syntax class for '\' is punctuation character to handle R 4.1
 ;; lambdas. Inside strings it should be treated as an escape
 ;; character which we ensure here.
@@ -855,6 +863,9 @@ top level functions only."
   (setq imenu-generic-expression ess-imenu-S-generic-expression)
   (when ess-imenu-use-S
     (imenu-add-to-menubar "Imenu-R"))
+  ;; outline
+  (setq-local outline-level #'ess-r-outline-level)
+  (setq-local outline-regexp ess-r-outline-regexp)
   (setq-local beginning-of-defun-function #'ess-r-beginning-of-defun)
   (setq-local end-of-defun-function #'ess-r-end-of-defun)
   (ess-roxy-mode))

lisp/ess/ess.el

@@ -17,8 +17,8 @@
 ;;
 ;; Maintainer: ESS Core Team <ESS-core@r-project.org>
 ;; Created: 7 Jan 1994
-;; Package-Version: 20251015.1619
-;; Package-Revision: a7d685bd9a3d
+;; Package-Version: 20251212.937
+;; Package-Revision: e39ca8fa7fce
 ;; URL: https://ess.r-project.org/
 ;; Package-Requires: ((emacs "25.1"))
 ;; ESSR-Version: 1.8

lisp/ess/ess.info

@@ -3267,6 +3267,7 @@ ESS has a few extra features, which didn't fit anywhere else.
 * Parens::                      Parenthesis matching
 * Graphics::                    Using graphics with ESS
 * Imenu::                       Support for Imenu in ESS
+* Outline::                     Use outline-minor-mode in R scripts
 * Toolbar::                     Support for toolbar in ESS
 * Xref::                        Xref
 * Rdired::                      Directory editor for R objects
@@ -3482,7 +3483,7 @@ interaction and graphics within S-PLUS. (Thanks to Tim Hesterberg for
 this information.)
 
 
-File: ess.info,  Node: Imenu,  Next: Toolbar,  Prev: Graphics,  Up: Extras
+File: ess.info,  Node: Imenu,  Next: Outline,  Prev: Graphics,  Up: Extras
 
 11.7 Imenu
 ==========
@@ -3501,9 +3502,42 @@ uses, check the value of ‘imenu-generic-expression’.  This value is set
 by various ESS variables such as ‘ess-imenu-S-generic-expression’.
 
 
-File: ess.info,  Node: Toolbar,  Next: Xref,  Prev: Imenu,  Up: Extras
+File: ess.info,  Node: Outline,  Next: Toolbar,  Prev: Imenu,  Up: Extras
 
-11.8 Toolbar
+11.8 Outline navigation
+=======================
+
+R editing buffers integrate with ‘outline-minor-mode’.  When you toggle
+the minor mode (for example via ‘M-x outline-minor-mode’ or by adding it
+to ‘ess-r-mode-hook’), ESS assigns ‘ess-r-outline-level’ to
+‘outline-level’ and installs ‘ess-r-outline-regexp’ so that comment
+headings drive folding.  Lines that begin with one or more ‘#’, followed
+by text and a trailing marker of ‘----’, ‘====’, or ‘####’, are treated
+as outline headings.  This matches the section markers convention
+adopted by RStudio.
+
+     # Setup ----
+     ## Data ----
+     ### Models ====
+     #### Helpers ####
+
+   The number of leading ‘#’ characters sets the outline depth.  Use
+standard Outline commands (such as ‘C-c  C-t’) to cycle visibility once
+the minor mode is active.  To enable Outlining automatically, add it to
+the R mode hook:
+
+     (add-hook 'ess-r-mode-hook #'outline-minor-mode)
+
+ -- User Option: ess-r-outline-regexp
+     Regular expression used by ESS to recognise outline headings in R
+     buffers.  The default matches the RStudio-style sections shown
+     above, but you can customise it if you prefer a different comment
+     convention.
+
+
+File: ess.info,  Node: Toolbar,  Next: Xref,  Prev: Outline,  Up: Extras
+
+11.9 Toolbar
 ============
 
 The R and S editing modes have support for a toolbar.  This toolbar
@@ -3515,8 +3549,8 @@ ways to change the toolbar.
 
 File: ess.info,  Node: Xref,  Next: Rdired,  Prev: Toolbar,  Up: Extras
 
-11.9 Xref
-=========
+11.10 Xref
+==========
 
 Xref is an Emacs interface that supports finding "identifiers," usually
 function definitions in ESS's view.  ESS ships with support for Xref in
@@ -3526,7 +3560,7 @@ Emacs versions 25.1 and higher.  For how to use this feature, see *Note
 
 File: ess.info,  Node: Rdired,  Next: Package listing,  Prev: Xref,  Up: Extras
 
-11.10 Rdired
+11.11 Rdired
 ============
 
 Ess-rdired provides a dired-like buffer for viewing, editing and
@@ -3558,7 +3592,7 @@ the object, 'v' will view it, and 'd' will mark the object for deletion
 
 File: ess.info,  Node: Package listing,  Next: Org,  Prev: Rdired,  Up: Extras
 
-11.11 Package listing
+11.12 Package listing
 =====================
 
 ESS[R] provides several commands to list and manage packages and objects
@@ -3598,7 +3632,7 @@ bindings in this mode (type ‘?’ in this buffer for a description).
 
 File: ess.info,  Node: Org,  Next: Sweave and AUCTeX,  Prev: Package listing,  Up: Extras
 
-11.12 Interaction with Org mode
+11.13 Interaction with Org mode
 ===============================
 
 Org-mode (<https://orgmode.org>) now supports reproducible research and
@@ -3617,7 +3651,7 @@ R process.  (This section contributed by Dan Davison and Eric Schulte.)
 
 File: ess.info,  Node: Sweave and AUCTeX,  Prev: Org,  Up: Extras
 
-11.13 Support for Sweave in ESS and AUCTeX
+11.14 Support for Sweave in ESS and AUCTeX
 ==========================================
 
 Libraries for literate data analysis are obsolete and not loaded by
@@ -4778,6 +4812,7 @@ Function and program index
 * ess-quit:                              Hot keys.            (line  70)
 * ess-quit <1>:                          Help.                (line 170)
 * ess-R-complete-object-name:            roxygen2.            (line  80)
+* ess-r-outline-level:                   Outline.             (line   6)
 * ess-r-package-list-available-packages: Package listing.     (line  12)
 * ess-r-package-list-local-packages:     Package listing.     (line   9)
 * ess-r-package-update-packages:         Package listing.     (line  16)
@@ -4827,6 +4862,7 @@ Function and program index
 * mark-paragraph:                        roxygen2.            (line  85)
 * newline-and-indent:                    roxygen2.            (line 102)
 * objects():                             Hot keys.            (line  24)
+* outline-minor-mode:                    Outline.             (line   6)
 * printer():                             printer.             (line  11)
 * q():                                   Hot keys.            (line  71)
 * R:                                     Starting up.         (line  11)
@@ -4877,6 +4913,8 @@ Variable index
 * ess-r-flymake-linters:                 ESS Flymake.          (line 16)
 * ess-r-flymake-lintr-cache:             ESS Flymake.          (line 23)
 * ess-R-font-lock-keywords:              Highlighting.         (line 19)
+* ess-r-outline-regexp:                  Outline.              (line  6)
+* ess-r-outline-regexp <1>:              Outline.              (line 27)
 * ess-search-list:                       Source Directories.   (line 62)
 * ess-source-directory:                  Source Directories.   (line 22)
 * ess-style:                             Styles.               (line 21)
@@ -4915,6 +4953,7 @@ Concept Index
 * changing ESS processes:                Multiple ESS processes.
                                                               (line   6)
 * cleaning up:                           Hot keys.            (line  71)
+* code folding:                          Outline.             (line   6)
 * comint:                                Credits.             (line   6)
 * command history:                       Command History.     (line   6)
 * command line arguments:                iESS(R)--Inferior ESS processes.
@@ -4997,6 +5036,7 @@ Concept Index
                                                               (line   6)
 * new objects, creating:                 Edit buffer.         (line  14)
 * objects:                               Hot keys.            (line  24)
+* outline-minor-mode:                    Outline.             (line   6)
 * pages in the process buffer:           Transcript.          (line  24)
 * paging commands in help buffers:       Help.                (line  28)
 * paragraphs in the process buffer:      Transcript.          (line  13)
@@ -5111,50 +5151,51 @@ Node: R documentation files132772
 Node: roxygen2136587
 Node: Namespaced Evaluation141110
 Node: Extras143124
-Node: ESS ElDoc144148
-Node: ESS Flymake145728
-Node: Handy commands146858
-Node: Highlighting148135
-Node: Parens149186
-Node: Graphics149662
-Node: printer150333
-Node: X11151105
-Node: winjava151444
-Node: Imenu151856
-Node: Toolbar152711
-Node: Xref153119
-Node: Rdired153447
-Node: Package listing154526
-Node: Org155974
-Node: Sweave and AUCTeX156928
-Node: ESS for R159560
-Node: ESS(R)--Editing files159860
-Node: iESS(R)--Inferior ESS processes160365
-Node: Philosophies for using ESS(R)163084
-Node: Example ESS usage164011
-Node: ESS for SAS165415
-Node: ESS(SAS)--Design philosophy166142
-Node: ESS(SAS)--Editing files167079
-Node: ESS(SAS)--TAB key169023
-Node: ESS(SAS)--Batch SAS processes170437
-Node: ESS(SAS)--Function keys for batch processing175657
-Node: iESS(SAS)--Interactive SAS processes185564
-Node: iESS(SAS)--Common problems189506
-Node: ESS(SAS)--Graphics191120
-Node: ESS(SAS)--Windows191919
-Node: ESS for BUGS192503
-Node: ESS for JAGS194315
-Node: Mailing lists/bug reports197811
-Node: Bugs198075
-Node: Reporting Bugs199751
-Node: Mailing Lists200670
-Node: Help with Emacs201408
-Node: Customization201944
-Node: Indices202722
-Node: Key index202897
-Node: Function and program index208029
-Node: Variable index217449
-Node: Concept index221010
+Node: ESS ElDoc144216
+Node: ESS Flymake145796
+Node: Handy commands146926
+Node: Highlighting148203
+Node: Parens149254
+Node: Graphics149730
+Node: printer150401
+Node: X11151173
+Node: winjava151512
+Node: Imenu151924
+Node: Outline152779
+Node: Toolbar154091
+Node: Xref154501
+Node: Rdired154831
+Node: Package listing155910
+Node: Org157358
+Node: Sweave and AUCTeX158312
+Node: ESS for R160944
+Node: ESS(R)--Editing files161244
+Node: iESS(R)--Inferior ESS processes161749
+Node: Philosophies for using ESS(R)164468
+Node: Example ESS usage165395
+Node: ESS for SAS166799
+Node: ESS(SAS)--Design philosophy167526
+Node: ESS(SAS)--Editing files168463
+Node: ESS(SAS)--TAB key170407
+Node: ESS(SAS)--Batch SAS processes171821
+Node: ESS(SAS)--Function keys for batch processing177041
+Node: iESS(SAS)--Interactive SAS processes186948
+Node: iESS(SAS)--Common problems190890
+Node: ESS(SAS)--Graphics192504
+Node: ESS(SAS)--Windows193303
+Node: ESS for BUGS193887
+Node: ESS for JAGS195699
+Node: Mailing lists/bug reports199195
+Node: Bugs199459
+Node: Reporting Bugs201135
+Node: Mailing Lists202054
+Node: Help with Emacs202792
+Node: Customization203328
+Node: Indices204106
+Node: Key index204281
+Node: Function and program index209413
+Node: Variable index218979
+Node: Concept index222686
 
 End Tag Table