update_mirror Readme

UNIFORM REPOSITORY SERVICE - Version 1.1

Gerald J. F. Banon,
banon@dpi.inpe.br

Copyright for the Uniform Repository Service (c) 1995, 1996, 1997,
by Gerald Banon. All rights reserved.

update_mirror
alias is um

The mirror.bib BibTeX ascii file is a mirror of all the
col/*/*/*/*/doc/@reference.bib files in the local collection.
The repositories that contain a Local Collection Index are examples
of repositories that contain a @reference.bib file.

The mirror.html file contains a list of all the accessible files which
are mentioned in the mirror.bib file.

These files should not be edited.

The update_mirror command updates the mirror.bib and mirror.html files.

WHEN TO USE the update_mirror command?

When any col/*/*/*/*/doc/@reference.bib files in your local collection has
been added, removed or modified and when you want to see the change.

This command is useful in conjunction with the send_repository command.

Example 1

If you want to make a search from other local collections, you have to
go through the following steps:

1. request to the persons in charge of these local collections to send you
   the repositories containing the Local Collection Index;
2. the persons in charge of these collections will send you such
   repositories by answering yes, at the execution time of the
   send_repository command, to the question:
   Do you want to include the repository that contains your
   Local Collection Index?
3. upon reception, install them;
4. execute the update_mirror command;
5. execute the lookup_mirror command.

Example 2

If you want to contribute to making a mirror.bib file richer, you have to
go through the following steps:

Let suppose that you have the B local collection and you want to
contribute to enrich the mirror.bib file of the A local collection.
You have to go through the following steps:

1. request the A collection repositories which contain the
   @reference.bib files;
2. the person in charge of the A collection will send you such repositories
   by answering yes, at the execution time of the send_repository command,
   to the question:
   Do you want to include the repositories that contain an @reference.bib
   file?
3. upon reception, install them in the B collection by executing the
   install_repository command;
4. execute the update_mirror command;
5. execute the make_repository command with the entry type "Misc" and the
   citation key "Yourname::R", and fill in the a.bib file with your name in
   the author field and "References" in the title field;
6. edit your contribution in a @reference.bib file and deposit it in this
   repository (use the lookup_mirror command to be sure not to add already
   existing references);
7. send to the person in charge of the A collection the B collection
   repositories which contain the @reference.bib files by executing the
   send_repository command and answering yes at the above mentioned
   question;
8. upon reception and installation the person in charge of the A collection
   will execute the command update_mirror;
9. execute the update_mirror command.

Now both A and B collections have the same enriched mirror.bib file.

OBS: if the document "Yourname::R" already exists, discard step 5.

HOW TO USE the update_mirror command?

Go to the following directory:

col/dpi.inpe.br/banon/1995/08.08.00.00/not_sent/library_service

(
for example if the current directory is the one in which you have
installed the initial collection (e.g. URLib), just execute the line

cd col/dpi.inpe.br/banon/1995/08.08.00.00/not_sent/library_service
)

then execute the line

update_mirror

OBSERVATION

The execution of this command can be time-consuming (to process 100 entries
it took 8 minutes on a SUN machine), so it is recommended to use it
just when it is needed and as a background process.

If something wrong is happening with the update_mirror command, just
remove the doc/mirror.bib file in the repository containing the
bibliographical mirror and try again.

If there is no entry with the URL option installed, then just the
mirror.bib file is created (and no mirror.html file is created).

end_Readme