Mercurial > emacs
comparison man/maintaining.texi @ 38264:e781108d8f69
Clarify when it's good to update a tags table and why.
| author | Richard M. Stallman <rms@gnu.org> |
|---|---|
| date | Mon, 02 Jul 2001 21:24:10 +0000 |
| parents | daf29e9ae9ed |
| children | cc3f1ee23db9 |
comparison
equal
deleted
inserted
replaced
| 38263:958842a72d40 | 38264:e781108d8f69 |
|---|---|
| 374 its file name and contents. You can specify the language with the | 374 its file name and contents. You can specify the language with the |
| 375 @samp{--language=@var{name}} option, described below. | 375 @samp{--language=@var{name}} option, described below. |
| 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, |
| 392 or when changes become substantial. Normally there is no need to update | 390 or when changes become substantial. Normally there is no need to update |
| 393 the tags table after each edit, or even every day. | 391 the tags table after each edit, or even every day. |