1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-11 16:08:13 +00:00

* sort.el (sort-regexp-fields): Doc fix.

This commit is contained in:
Chong Yidong 2012-08-03 16:15:24 +08:00
parent b9e74744d6
commit 385b01989f
2 changed files with 20 additions and 11 deletions

View File

@ -1,3 +1,7 @@
2012-08-03 Chong Yidong <cyd@gnu.org>
* sort.el (sort-regexp-fields): Doc fix.
2012-08-03 Tassilo Horn <tsdh@gnu.org>
* textmodes/reftex.el (reftex-compile-variables): Make keyvals

View File

@ -401,18 +401,23 @@ the sort order."
;;;###autoload
(defun sort-regexp-fields (reverse record-regexp key-regexp beg end)
"Sort the region lexicographically as specified by RECORD-REGEXP and KEY.
RECORD-REGEXP specifies the textual units which should be sorted.
For example, to sort lines RECORD-REGEXP would be \"^.*$\"
KEY specifies the part of each record (ie each match for RECORD-REGEXP)
is to be used for sorting.
If it is \"\\\\digit\" then the digit'th \"\\\\(...\\\\)\" match field from
RECORD-REGEXP is used.
If it is \"\\\\&\" then the whole record is used.
Otherwise, it is a regular-expression for which to search within the record.
If a match for KEY is not found within a record then that record is ignored.
"Sort the text in the region region lexicographically.
If called interactively, prompt for two regular expressions,
RECORD-REGEXP and KEY-REGEXP.
With a negative prefix arg sorts in reverse order.
RECORD-REGEXP specifies the textual units to be sorted.
For example, to sort lines, RECORD-REGEXP would be \"^.*$\".
KEY-REGEXP specifies the part of each record (i.e. each match for
RECORD-REGEXP) to be used for sorting.
If it is \"\\\\digit\", use the digit'th \"\\\\(...\\\\)\"
match field specified by RECORD-REGEXP.
If it is \"\\\\&\", use the whole record.
Otherwise, KEY-REGEXP should be a regular expression with which
to search within the record. If a match for KEY-REGEXP is not
found within a record, that record is ignored.
With a negative prefix arg, sort in reverse order.
The variable `sort-fold-case' determines whether alphabetic case affects
the sort order.