diff options
| author | Richard M. Stallman | 2001-07-02 21:24:10 +0000 |
|---|---|---|
| committer | Richard M. Stallman | 2001-07-02 21:24:10 +0000 |
| commit | 55d3737db5916a3091e27feddbff9a3103a4336f (patch) | |
| tree | f58ce0e54d929a2616aa7ccc2a6127149ce220fb | |
| parent | 4ce5c22387689e206cb06d367d9ef7564f2ab79b (diff) | |
| download | emacs-55d3737db5916a3091e27feddbff9a3103a4336f.tar.gz emacs-55d3737db5916a3091e27feddbff9a3103a4336f.zip | |
Clarify when it's good to update a tags table and why.
| -rw-r--r-- | man/maintaining.texi | 16 |
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 |
| 378 | described in the table, the way to update the tags table is the same | 378 | described in the table, the way to update the tags table is the same |
| 379 | way it was made in the first place. But it is not necessary to do | 379 | way it was made in the first place. If the tags table fails to record |
| 380 | this very often. | 380 | a tag, or records it for the wrong file, then Emacs cannot possibly |
| 381 | 381 | find 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 | ||
| 383 | file, then Emacs cannot possibly find its definition. However, if the | ||
| 384 | position recorded in the tags table becomes a little bit wrong (due to | 382 | position recorded in the tags table becomes a little bit wrong (due to |
| 385 | some editing in the file that the tag definition is in), the only | 383 | other editing), the only consequence is a slight delay in finding the |
| 386 | consequence is a slight delay in finding the tag. Even if the stored | 384 | tag. Even if the stored position is very far wrong, Emacs will still |
| 387 | position is very wrong, Emacs will still find the tag, but it must | 385 | find the tag, after searching most of the file for it. Even that |
| 388 | search the entire file for it. | 386 | delay 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 |
| 391 | to have listed, or when you move tag definitions from one file to another, | 389 | to have listed, or when you move tag definitions from one file to another, |