summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>2001-07-02 21:24:10 +0000
committerRichard M. Stallman <rms@gnu.org>2001-07-02 21:24:10 +0000
commit4df36f600a3c03a107715f636f9381dace100dea (patch)
tree9c87ab3922144c6af3a8842421700d4555f6e7b0
parentd8a31a438e5e1b82e721b8116041ef4e87020fdc (diff)
downloademacs-4df36f600a3c03a107715f636f9381dace100dea.tar.gz
Clarify when it's good to update a tags table and why.
-rw-r--r--man/maintaining.texi16
1 files changed, 7 insertions, 9 deletions
diff --git a/man/maintaining.texi b/man/maintaining.texi
index 37a82e7c292..3ffd6dd5e76 100644
--- a/man/maintaining.texi
+++ b/man/maintaining.texi
@@ -376,16 +376,14 @@ its file name and contents. You can specify the language with the
If the tags table data become outdated due to changes in the files
described in the table, the way to update the tags table is the same
-way it was made in the first place. But it is not necessary to do
-this very often.
-
- If the tags table fails to record a tag, or records it for the wrong
-file, then Emacs cannot possibly find its definition. However, if the
+way it was made in the first place. If the tags table fails to record
+a tag, or records it for the wrong file, then Emacs cannot possibly
+find its definition until you update the tags table. However, if the
position recorded in the tags table becomes a little bit wrong (due to
-some editing in the file that the tag definition is in), the only
-consequence is a slight delay in finding the tag. Even if the stored
-position is very wrong, Emacs will still find the tag, but it must
-search the entire file for it.
+other editing), the only consequence is a slight delay in finding the
+tag. Even if the stored position is very far wrong, Emacs will still
+find the tag, after searching most of the file for it. Even that
+delay is hardly noticeable with today's computers.
So you should update a tags table when you define new tags that you want
to have listed, or when you move tag definitions from one file to another,