aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2001-07-02 21:24:10 +0000
committerRichard M. Stallman2001-07-02 21:24:10 +0000
commit55d3737db5916a3091e27feddbff9a3103a4336f (patch)
treef58ce0e54d929a2616aa7ccc2a6127149ce220fb
parent4ce5c22387689e206cb06d367d9ef7564f2ab79b (diff)
downloademacs-55d3737db5916a3091e27feddbff9a3103a4336f.tar.gz
emacs-55d3737db5916a3091e27feddbff9a3103a4336f.zip
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
376 376
377 If the tags table data become outdated due to changes in the files 377 If the tags table data become outdated due to changes in the files
378described in the table, the way to update the tags table is the same 378described in the table, the way to update the tags table is the same
379way it was made in the first place. But it is not necessary to do 379way it was made in the first place. If the tags table fails to record
380this very often. 380a tag, or records it for the wrong file, then Emacs cannot possibly
381 381find its definition until you update the tags table. However, if the
382 If the tags table fails to record a tag, or records it for the wrong
383file, then Emacs cannot possibly find its definition. However, if the
384position recorded in the tags table becomes a little bit wrong (due to 382position recorded in the tags table becomes a little bit wrong (due to
385some editing in the file that the tag definition is in), the only 383other editing), the only consequence is a slight delay in finding the
386consequence is a slight delay in finding the tag. Even if the stored 384tag. Even if the stored position is very far wrong, Emacs will still
387position is very wrong, Emacs will still find the tag, but it must 385find the tag, after searching most of the file for it. Even that
388search the entire file for it. 386delay is hardly noticeable with today's computers.
389 387
390 So you should update a tags table when you define new tags that you want 388 So you should update a tags table when you define new tags that you want
391to have listed, or when you move tag definitions from one file to another, 389to have listed, or when you move tag definitions from one file to another,