masscollaborationlabs/emacs
2
0
Fork 0
mirror of https://github.com/masscollaborationlabs/emacs.git synced 2025-07-04 11:23:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Improve 'compilation-transform-file-match-alist' documentation

Browse source 
* doc/emacs/building.texi (Compilation Mode): Document
'compilation-transform-file-match-alist'.
* lisp/progmodes/compile.el
(compilation-transform-file-match-alist):
Expand docstring and add some examples.
This commit is contained in:
Robert Pluim 2024-12-03 15:20:04 +01:00
parent a73d08bb67
commit 7c50e4cc8c
2 changed files with 23 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

8
doc/emacs/building.texi
View file

@ -310,6 +310,14 @@ error message formats and tells Emacs how to extract the locus from
each. A similar variable, @code{grep-regexp-alist}, tells Emacs how each. A similar variable, @code{grep-regexp-alist}, tells Emacs how
to parse output from a @code{grep} command (@pxref{Grep Searching}). to parse output from a @code{grep} command (@pxref{Grep Searching}).
@vindex compilation-transform-file-match-alist
@cindex compilation transform file
@cindex compilation find file
Sometimes @code{compilation-error-regexp-alist} doesn't correctly
determine the filename that is the source of the error. Use user option
@code{compilation-transform-file-match-alist} to make any necessary
adjustments, such as adding or changing a directory component.
@findex compilation-next-error @findex compilation-next-error
@findex compilation-previous-error @findex compilation-previous-error
@findex compilation-next-file @findex compilation-next-file

18
lisp/progmodes/compile.el
View file

@ -62,9 +62,21 @@ If nil, use Emacs default."
(defcustom compilation-transform-file-match-alist (defcustom compilation-transform-file-match-alist
'(("/bin/[a-z]*sh\\'" nil)) '(("/bin/[a-z]*sh\\'" nil))
"Alist of regexp/replacements to alter file names in compilation errors. "Alist of regexp/replacements to alter file names in compilation errors.
If the replacement is nil, the file will not be considered an If the replacement is nil, the file will not be considered an error
error after all. If not nil, it should be a regexp replacement after all. If not nil, it should be a regexp replacement string.
string."
When a replacement regexp is specified, the value of the file name used
to locate the error is changed, but the compilation buffer still
displays the original value.
For example, to prepend a subdirectory \"bar/\" to all file names, add
an entry matching \"\\\\=`\" and a replacement regexp of \"bar/\", i.e.:
(\"\\\\=`\" \"bar/\")
Similarly, to remove a prefix \"bar/\", use:
(\"\\\\=`bar/\" \"\")"
:type '(repeat (list regexp (choice (const :tag "No replacement" nil) :type '(repeat (list regexp (choice (const :tag "No replacement" nil)
string))) string)))
:version "27.1") :version "27.1")