[elpa] externals/auctex 3c1f820 25/27: Add TODO item about remove-style feature

[Tassilo Horn]

branch: externals/auctex
commit 3c1f820224a0530ef50e658d43f4110f84b21cb4
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Commit: Ikumi Keita <ikumi@ikumi.que.jp>

    Add TODO item about remove-style feature
    
    * doc/todo.texi (Mid-term Goals): Add an item about remove-style
    feature.
    * doc/changes.texi (News in 12.3): Fix typo.
---
 doc/changes.texi |  2 +-
 doc/todo.texi    | 15 ++++++++++++++-
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/doc/changes.texi b/doc/changes.texi
index 396e955..1c09683 100644
--- a/doc/changes.texi
+++ b/doc/changes.texi
@@ -33,7 +33,7 @@ instead.
 @item
 Support for highlighting and in-math state detection for AMS-LaTeX
 specific environments, such as @samp{align}, @samp{gather} and
-@samp{multiline}, are refactored and put into style file
+@samp{multline}, are refactored and put into style file
 @file{amsmath.el}. So these support are available only when
 @code{TeX-parse-self} option is enabled.
 
diff --git a/doc/todo.texi b/doc/todo.texi
index 43a8248..ca4db2f 100644
--- a/doc/todo.texi
+++ b/doc/todo.texi
@@ -1,5 +1,5 @@
 @c This is part of the AUCTeX Manual.
-@c Copyright (C) 2004-2006, 2008, 2009, 2013-2015 Free Software
+@c Copyright (C) 2004-2006, 2008, 2009, 2013-2015, 2020 Free Software
 @c Foundation, Inc.
 @c See the file auctex.texi for copying conditions.
 @ifset rawfile
@@ -59,6 +59,19 @@ be looked up in the catalogs in sequence until they were 
identified.
 Macro cross references should also be usable for document navigation
 using RefTeX.
 
+@item Fix remove-style feature
+
+Currently @code{TeX-remove-style} implementation isn't good. It is
+common practice that major mode functions directly add macros and
+environments via @code{TeX-add-symbols} and
+@code{LaTeX-add-environments}, but those macros and environments are
+lost once @code{TeX-remove-style} runs. It is necessary to run major
+mode function, by e.g. @code{normal-mode}, again to recover them, but
+that makes no point in running @code{TeX-remove-style} itself because
+major mode function kills all buffer-local variables.
+
+As of @AUCTeX{} 12.3, @code{TeX-remove-style} is no longer used by any
+other codes.
 
 @end itemize