New
authorMike Taylor <mike@indexdata.com>
Wed, 6 Dec 2006 14:22:22 +0000 (14:22 +0000)
committerMike Taylor <mike@indexdata.com>
Wed, 6 Dec 2006 14:22:22 +0000 (14:22 +0000)
13 files changed:
web/htdocs/help/edit/author.html [new file with mode: 0644]
web/htdocs/help/edit/contact.html [new file with mode: 0644]
web/htdocs/help/edit/country.html [new file with mode: 0644]
web/htdocs/help/edit/description.html [new file with mode: 0644]
web/htdocs/help/edit/extent.html [new file with mode: 0644]
web/htdocs/help/edit/history.html [new file with mode: 0644]
web/htdocs/help/edit/hosturl.html [new file with mode: 0644]
web/htdocs/help/edit/language.html [new file with mode: 0644]
web/htdocs/help/edit/password.html [new file with mode: 0644]
web/htdocs/help/edit/restrictions.html [new file with mode: 0644]
web/htdocs/help/edit/subjects.html [new file with mode: 0644]
web/htdocs/help/edit/title.html [new file with mode: 0644]
web/htdocs/help/edit/username.html [new file with mode: 0644]

diff --git a/web/htdocs/help/edit/author.html b/web/htdocs/help/edit/author.html
new file mode 100644 (file)
index 0000000..33c9302
--- /dev/null
@@ -0,0 +1,13 @@
+%# $Id: author.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   The author element should contain the name of the person or
+   organisation to be credited with the creation of the database, and
+   may include some form or address, either electronic or postal, as
+   well as the name.
+  </p>
+  <p>
+   Contrast with
+   <a href="/help.html?help=edit/contact">Contact</a>,
+   which is adminstrative rather than to do with giving credit.  While
+   the author and contact entities may be the same, they may not.
+  </p>
diff --git a/web/htdocs/help/edit/contact.html b/web/htdocs/help/edit/contact.html
new file mode 100644 (file)
index 0000000..3786d4d
--- /dev/null
@@ -0,0 +1,12 @@
+%# $Id: contact.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   The contact element is used to record information on a contact
+   person for the database.  This should include at least a name and
+   some form or address, either electronic or postal.
+  </p>
+  <p>
+   Contrast with
+   <a href="/help.html?help=edit/author">Author</a>,
+   which is to do with giving credit for creating the content.  While
+   the author and contact entities may be the same, they may not.
+  </p>
diff --git a/web/htdocs/help/edit/country.html b/web/htdocs/help/edit/country.html
new file mode 100644 (file)
index 0000000..3db8b2e
--- /dev/null
@@ -0,0 +1,4 @@
+%# $Id: country.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   The country in which the service is hosted, if known.
+  </p>
diff --git a/web/htdocs/help/edit/description.html b/web/htdocs/help/edit/description.html
new file mode 100644 (file)
index 0000000..c5155b6
--- /dev/null
@@ -0,0 +1,12 @@
+%# $Id: description.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+
+   Should contain a description of why this database might be of
+   interest.  Anything which does not fit under the other fields
+   (<a href="/help.html?help=edit/extent">Extent</a>,
+   <a href="/help.html?help=edit/history">History</a>,
+   <a href="/help.html?help=edit/restrictions">Restrictions</a>,
+   <a href="/help.html?help=edit/subjects">Subjects</a>,
+   etc.)
+   may also be put into this element.
+  </p>
diff --git a/web/htdocs/help/edit/extent.html b/web/htdocs/help/edit/extent.html
new file mode 100644 (file)
index 0000000..8ab835c
--- /dev/null
@@ -0,0 +1,8 @@
+%# $Id: extent.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   Used to describe the completeness of the database, or the range of
+   material that is included in it. For example a database which
+   contained all the emails sent to a mailing list would be considered
+   complete. If this database only maintained a smaller subset of the
+   emails, then it should be noted in this element.
+  </p>
diff --git a/web/htdocs/help/edit/history.html b/web/htdocs/help/edit/history.html
new file mode 100644 (file)
index 0000000..907f31c
--- /dev/null
@@ -0,0 +1,7 @@
+%# $Id: history.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   Any information which is considered useful regarding the history of
+   the database may be recorded in the history element. This might
+   include the sponsors for its creation, or significant moments in
+   its history.
+  </p>
diff --git a/web/htdocs/help/edit/hosturl.html b/web/htdocs/help/edit/hosturl.html
new file mode 100644 (file)
index 0000000..20f43e5
--- /dev/null
@@ -0,0 +1,11 @@
+%# $Id: hosturl.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   A URL for the organisation which hosts the database.  This URL may
+   or not refer to the same host as the
+   <a href="/help.html?help=edit/host">Host</a>
+   on which the service runs - for example, the Library of Congress
+   catalogue runs on the host z3950.loc.gov, but
+   <a target="_blank" href="http://www.loc.gov/"
+                           >http://www.loc.gov/</a>
+   would be a more approriate host URL.
+  </p>
diff --git a/web/htdocs/help/edit/language.html b/web/htdocs/help/edit/language.html
new file mode 100644 (file)
index 0000000..df77e8c
--- /dev/null
@@ -0,0 +1,7 @@
+%# $Id: language.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   Used to record the languages used in the database records (as
+   opposed to the target record).  For example, in an English-language
+   record describing a database of French-language records, this
+   should be set to ``French''.
+  </p>
diff --git a/web/htdocs/help/edit/password.html b/web/htdocs/help/edit/password.html
new file mode 100644 (file)
index 0000000..e898117
--- /dev/null
@@ -0,0 +1,2 @@
+%# $Id: password.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+<& username.html &>
diff --git a/web/htdocs/help/edit/restrictions.html b/web/htdocs/help/edit/restrictions.html
new file mode 100644 (file)
index 0000000..2022536
--- /dev/null
@@ -0,0 +1,8 @@
+%# $Id: restrictions.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   If there are any restrictions on the usage or availability of the
+   database or its contents then these should be recorded in this
+   element.  For example it might contain information regarding the
+   copyright status of the records, or an indication that the database
+   is only available between certain hours.
+  </p>
diff --git a/web/htdocs/help/edit/subjects.html b/web/htdocs/help/edit/subjects.html
new file mode 100644 (file)
index 0000000..4af2fdd
--- /dev/null
@@ -0,0 +1,7 @@
+%# $Id: subjects.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   If the database concerns particular subjects from a controlled
+   vocabulary then these may be recorded using this field.  These
+   subjects might be drawn from the Library of Congress Subject
+   Headings or another appropriate thesaurus.
+  </p>
diff --git a/web/htdocs/help/edit/title.html b/web/htdocs/help/edit/title.html
new file mode 100644 (file)
index 0000000..9b984e4
--- /dev/null
@@ -0,0 +1,4 @@
+%# $Id: title.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   The name by which the database is known.
+  </p>
diff --git a/web/htdocs/help/edit/username.html b/web/htdocs/help/edit/username.html
new file mode 100644 (file)
index 0000000..003a8d5
--- /dev/null
@@ -0,0 +1,12 @@
+%# $Id: username.html,v 1.1 2006-12-06 14:22:22 mike Exp $
+  <p>
+   Some Z39.50 servers require authentication before access is
+   allowed.  For such servers, a suitable username and password may be
+   provided.  Server that require authentication but for which no
+   username/password is provided cannot be tested.
+  </p>
+  <p>
+   At the time of writing there is no standard way to provide
+   authentication to SRU/SRW services, so these fields are of limited
+   utility for such services.
+  </p>