From 76ecdcbd762bab20cf5bf93997d95944576a867a Mon Sep 17 00:00:00 2001 From: Adam Dickmeiss Date: Wed, 15 Oct 2008 13:36:55 +0200 Subject: [PATCH] Beautifying documentation Conflicts: doc/book.xml --- doc/ajaxdev.xml | 19 ++++++++++--------- doc/book.xml | 12 ++++++------ doc/pazpar2.xml | 2 +- m4 | 2 +- 4 files changed, 18 insertions(+), 17 deletions(-) diff --git a/doc/ajaxdev.xml b/doc/ajaxdev.xml index 3e8d543..035f250 100644 --- a/doc/ajaxdev.xml +++ b/doc/ajaxdev.xml @@ -9,7 +9,7 @@ Pz2.js - Pazapar2 comes with a small JavaScript library called pz2.js. This library is designed to simplify development of an Ajax-based pazpar2 clients and alleviate programmer from the low-level details like polling the web service, fetching and parsing returned XML output or managing timers, sessions and basic state variables. + Pazpar2 comes with a small JavaScript library called pz2.js. This library is designed to simplify development of an Ajax-based pazpar2 client and alleviate programmer from the low-level details like polling the web service, fetching and parsing returned XML output or managing timers, sessions and basic state variables. @@ -28,7 +28,7 @@ Using pz2.js - Client development with the pz2.js is strongly event based and should be familiar to most JavaScript developers. A simple client (jsdemo) is distributed with pazpar2's source code and shows how to set-up and use pz2.js. + Client development with the pz2.js is strongly event based and the style should be familiar to most JavaScript developers. A simple client (jsdemo) is distributed with pazpar2's source code and shows how to set-up and use pz2.js. @@ -62,7 +62,7 @@ - Each command callback is a user defined function that takes a hash object as a parameter. The hash object contains parsed pazpar2 responses (hash members that correspond to the elements in the response XML document). Within the handler programmer further processes the data and updates the the viewed document. + Each command callback is a user defined function that takes a hash object as a parameter. The hash object contains parsed pazpar2 responses (hash members that correspond to the elements in the response XML document). Within the handler programmer further processes the data and updates the viewed document. @@ -81,7 +81,8 @@ } function on_record(data) { - // if detailsstylesheet parameter was set data array will contain raw xml // // and xsl data + // if detailsstylesheet parameter was set data array + // will contain raw xml and xsl data Element_appendTransformResult(someDiv, data.xmlDoc, data.xslDoc); } @@ -117,7 +118,7 @@ PARAMATERS ARRAY pazpar2path - server path to pazpar2 (relative to the portal), when pazar2 is installed as a package this does not have to be set + server path to pazpar2 (relative to the portal), when pazpar2 is installed as a package this does not have to be set usesessions @@ -156,7 +157,7 @@ specifies reset method callback function termlist - coma separated list of facets + comma separated list of facets keepAlive ping period, should not be lower than 5000 usec @@ -183,19 +184,19 @@ reset state init (sesionId) - session-mode, intitialize new session or pick up a session already initialized + session-mode, initialize new session or pick up a session already initialized ping () session-mode, intitialize pinging search (query, num, sort, filter, showfrom) - execute piggy-back search and activate polling on every command specfied by assigning command callback (in the pz2 constructor) + execute piggy-back search and activate polling on every command specified by assigning command callback (in the pz2 constructor) show (start, num, sort) start or change parameters of polling for a given window of records record (id, offset, syntax, handler) - retrieve detailed or raw record. handler temporary overrirdes default callback function. + retrieve detailed or raw record. handler temporarily overrides default callback function. termlist () start polling for termlists diff --git a/doc/book.xml b/doc/book.xml index aae3a77..87f022b 100644 --- a/doc/book.xml +++ b/doc/book.xml @@ -87,7 +87,7 @@ scenes. Pazpar2 connects to servers, carries out searches, and retrieves, deduplicates, and stores results internally. Your application code may periodically inquire about the status of an ongoing operation, - and ask to see records or other result set facets. Result become + and ask to see records or other result set facets. Result becomes available immediately, and it is easy to build end-user interfaces which feel extremely responsive, even when searching more than 100 servers concurrently. @@ -118,7 +118,7 @@ If you wish to connect to commercial or other databases which do not support open standards, please contact Index Data. We have a licensing agreement with a third party vendor which will enable Pazpar2 to access - thousands of online databases, in addition the vast number of catalogs + thousands of online databases, in addition to the vast number of catalogs and online services that support the Z39.50 protocol. @@ -148,7 +148,7 @@ Installation - The Pazpar2 package very small. It includes documentation as well + The Pazpar2 package is very small. It includes documentation as well as the Pazpar2 server. The package also includes a simple user interface test1 which consists of a single HTML page and a single JavaScript file to illustrate the use of Pazpar2. @@ -465,8 +465,8 @@ Sometimes, it may be necessary to implement functionality on your regular webserver that makes use of search results, for example to implement data import functionality, emailing results, history - lists, personal citation lists, interlibrary loan functionality - ,etc. Fortunately, it is simple to exchange information between + lists, personal citation lists, interlibrary loan functionality, + etc. Fortunately, it is simple to exchange information between Pazpar2, your browser scripting, and backend server-side scripting. You can send a session ID and possibly a record ID from your browser code to your server code, and from there use Pazpar2s webservice API @@ -481,7 +481,7 @@ Your data model Pazpar2 does not have a preconceived model of what makes up a data - model. There are no assumption that records have specific fields or + model. There are no assumptions that records have specific fields or that they are organized in any particular way. The only assumption is that data comes packaged in a form that the software can work with (presently, that means XML or MARC), and that you can provide diff --git a/doc/pazpar2.xml b/doc/pazpar2.xml index 491a2cb..e22f4f0 100644 --- a/doc/pazpar2.xml +++ b/doc/pazpar2.xml @@ -127,7 +127,7 @@ Makes the Pazpar2 server change user ID to the uid given. - This, normally, require root privilege. + This, normally, requires root privilege. diff --git a/m4 b/m4 index acee1cf..a3d7a33 160000 --- a/m4 +++ b/m4 @@ -1 +1 @@ -Subproject commit acee1cf4678c8c0908d65fcbc19f49c7c5aa677f +Subproject commit a3d7a3375702caae9794ae3a724e51ae9ee46ac3 -- 1.7.10.4