Category : Word Perfect
Archive   : BIBPERF.ZIP
Filename : BIB-PERF.WP

 
Output of file : BIB-PERF.WP contained in archive : BIBPERF.ZIP
ÎÎÆÆÀ
J DÀ



Ã(ÃBibliographyPerfectƒ


Ã('Ãbyƒ


Ã(ÃArthur Milholland, M.D., Ph.D.ƒ
Ã(ÃAssistant Professorƒ
Ã(ÃDepartment of Anesthesiologyƒ
Ã(ÃUniversity of Maryland Hospitalƒ
Ã(Ã22 S. Greene Streetƒ
Ã(ÃBaltimore, Maryland 21201ƒ

Ã(Ãfor the benefit ofƒ



Ã(ÃPhysicians for Social Responsibilityƒ
Ã(Ã325 E. 25th Streetƒ
Ã(ÃBaltimore, Maryland 21218ƒ


Ã(ÃCopyright (C) 1984ƒ






BibliographyPerfect is a "Freeware" product, so please
copy it and pass it on to fellow WordPerfect users.

If you like BibliographyPerfect, we would appreciate
your sending a fee (suggest $25) to PSR at the address
šabove (amounts over $25 tax deductible).  Please let us
know if you do not have the source code and wish for us
to send it to you.  We also would appreciate hearing
šabout any sug¬gestions or problems that you have.

ÜVÜ
Before we go any farther, it is time for the usual

--------------------------------------------------------
Ã(ÃDISCLAIMER OF WARRANTYƒ

This software and documentation are sold "as is"
and without warranties as to performance or merchanta­bility. Any statements made by any person about
this software do not constitute warranties and
šshall not be relied on by the buyer in deciding whether
to purchase these programs. This program is sold with­out any express or implied warranties whatsoever. Be­cause of the diversity of condi¬tions and hardware under
which these programs may be used, no warranty of fit­ness for a particular purpose is of¬fered. The user
is advised to test these programs thor¬oughly before re­lying on them. The user must assume the entire risk
of using šthese pro¬grams. Any liability of seller
or manufacturer will be limited exclusively to product
replacement or refund of the pur¬chase price.
--------------------------------------------------------


Now let's get on to the Table of Contents:

Introduction (2)
Disk Files Supplied (3)
Running BibliographyPerfect (4)
Naming Files (4)
Defaults for File Names (5)
Aborting the Run (5)
The Text (5)
The Bibliography (6)
Editing Text and Bibliography (7)
Printing the Bibliography (7)
Error Handling (7)
Glitches and Quirks (8)
Physicians for Social Responsibility (8)
›
›ççIntroductionèè

BibliographyPerfect is a bibliography program for use
in conjuction with the WordPerfect word processor.

BP will sequentially renum¬ber ref¬er¬ences in a paper
and in its bibliography šwhen¬ever new ones are added or
re¬moved, or when šblocks of text are relo¬cated. The text
file is a standard WP doc¬u¬ment. The bibliography is a
WP merge file, so it can be ad¬justed to suit different
journal formats, can in¬clude annotations or comments,ÜdÜ and could be sorted using WP Sorter. Appropriate error
šchecks are per¬formed.

WordPerfect and WordPerfect Sorter are copyrighted
pro¬grams produced by Satellite Software In¬ternational. 

BibliographyPerfect is written in Turbo Pas¬cal (a co­pyrighted program of Borland) and sup¬plied as a DOS exe­cu¬table program.

Ê@Ê
ççDisk Files Suppliedèè

Ì ÌÌÌÂÂBib-Perf.Com : Executable bibliography program in¬clud­ing both renumbering and sorting.ÞDÞ

Bib-Perf.WP : BP Documentation, in WordPerfect format.

Bib-Perf.Doc: BP Documentation, in ASCII format.

TestBP.DIN : Sample Document INput file.

TestBP.BIN : Sample Bibliography INput file.

Ì ÌÌÌÂÂBib0Sort.Pas : Source code.  BP version that renumbers
text and bibliography but does not sort the final
product.  This could be done by using WordPerfect
Sorter.  This is supplied for those Turbo users
who want source code but do not have the Borland
ToolBox, from which the sort rou¬tine Sort.Box
is obtained.ÞDÞ

Ì ÌÌÌÂÂBib1Sort.Pas : Source code.  Renumbers and sorts final
bib¬liography.  Requires šSort.Box from Turbo Tool­box (not supplied).ÞDÞ

Ì ÌÌÌÂÂInKey.Inc : Source code.  Rou¬tine from the Success
Press to permit single character in¬put without
using š.ÞDÞ

Ì ÌÌÌÂÂGetfile.Inc, Bib1.Inc, Exist.Inc : Source code. Rou­tines used to input file names, and ones used
to inter¬act with Sort.Box.ÞDÞ

Ì ÌÌÌÂÂInstall.Com, Install.Dta, Install.Msg : Installation
prog¬ram to customize Bib-Perf for your terminal/
monitor set-up.ÞDÞ

Ì ÌÌÌÂÂInstall.Doc : ASCII file documentation for Install.ÞDÞ
Ê$ÊÜb܌

ççRunning BibliographyPerfectèè

First, if necessary, refer to INSTALL.DOC, run the
INSTALL program to fit Bib-Perf to your set-up.

While in DOS, you type BIB-PERF .  If you have
two disk drives, it is convenient to designate drive B
as the de¬fault drive and to have BP on drive A, as you
do with WordPerfect.  In that case, enter A:BIB-PERF
š.

Next, BP will ask for the names of two docu¬ment and
two bibliography files (old and new).

BP then goes to work, renumbering the text and biblio­graphy, and then sorting the bibliography by the new num­bers.  The you should then examine the new files using
Word Perfect, and should remove the ^Z which will ap¬pear
at the end of each newly created file.  Once satisfied,
you may then rename the new files to their original des­ignations.

Ê(Ê

ççNaming Filesèè

WP will ask for the names of four files:

Ì ÌÌÌÂÂ 1. existing document file to be renumberedÞDÞ
Ì ÌÌÌÂÂ 2. new document file that results from renum¬bering
ÞDÞ
Ì ÌÌÌÂÂ 3. existing bibliography file, with old num¬bers ÞDÞ
Ì ÌÌÌÂÂ 4. new bibliography fileÞDÞ

Each file must have a distinct name.

If the file designated in 1 or 3 does not ex¬ist, you
will be prompted for the name until you enter a valid
name or ABORT (see below).

Any DOS 2.0 name is valid.  The prefix part of the
name (up to the period) may include drive, path, and
šfilename.  The extension is any valid string of 1-3 char­acters (may not be null except to choose default).

Ê2ÊÜ^܌ççDefaults for File Namesèè

For convenience, BP provides a default exten¬sion type
for each of the four files.  It will fill in that default
if you omit it.  The standard de¬faults are:

Ì ÌÌÌÂÂ 1. DIN (for Document INput)ÞDÞ
Ì ÌÌÌÂÂ 2. DOU (for Document OUtput)ÞDÞ
Ì ÌÌÌÂÂ 3. BIN (Bibliography INput)ÞDÞ
Ì ÌÌÌÂÂ 4. BOU (Bibliography OUtput)ÞDÞ

The prefix part must be given for the first file, and
may be defaulted to the last name used for the other
šthree files.

The current defaults are shown below the entry line
when each name is requested.

Either the prefix name or the extension name may be
defaulted, or both.  In order to default the prefix name
but not the extension, enter a per¬iod followed by the
1-3 character extension.  In order to default both names,
enter only .


ççAborting the Runèè

When asked for a file name, if you enter a string con­sisting of more than 8 z's, the job will abort.


ÊÊ
ççThe Textèè

This is a standard WordPerfect document.  Each ref­erence number is identified by preceding it with a "["
and following with a "]", for example, [26] refers to
bibliography number 26. Other uses of brackets are valid
-- BP will identify and ignore them.

The reference numbers in this text should cor¬respond
to references that appear in the bibliogra¬phy.  When new
numbers are added, they do not have to begin with the
next available integer.  They can be any 4 digit positive
integer, as long as they are the same in both text and
bibliogra¬phy.  This means you don't have to be worried
about using a number that is already used.  Just start
new en¬tries with a number far outside the range, say,
500 or 1000.  However, don't use 9999, which is re¬served
(see bibliography).
Üd܌ Multiple occurrences of a number are permitted in the
text, so the same paper can be referenced in more than
one place.

ÊÊ
ççThe Bibliographyèè

The Bibliography is in the form of a WordPerf¬ect merge
file (see WP manual if necessary).

The first field must be the reference number which
is the same as in the text, and distinct from all other
reference numbers.  Any 1-4 digit posi¬tive integer
š(except 9999) is entered; it may be preceded by blanks
but must be followed immediately by the End of Field des­igna¬tor "^R[NL]".

Other fields contain author and source infor¬mation. 
This might be all contained in the second field, or bro­ken up into separate ones for rear¬rangement (different
journals may require different format) during printing,
or for sorting using Word Perfect Sorter.

One or more fields may contain annota¬tions for print­ing or comments for you.  šWhether a field is printed or
not depends on selec¬ting it using the šmerge feature.

Each record must end with š^E[NL], the End of Record
designator.

Maximum length of an entire record (data šfields plus
comments) is about 2000 characters.

Being able to enter large integer values as reference
numbers makes it easy to be sure you are using fresh num­bers when adding new refer¬ences, because you can use num­bers far outside the range of ones that already exist. 
For example, new num¬bers might start with 1001, 1002,
etc.  BP, of šcourse, re-numbers them according to order
of oc¬currence in the text.  Duplicate numbers in the bib­liography are illegal and will cause an end of job.  The
number 9999 is special and reserved to designate extra
references that have no corres¬pond¬ing entry in the
štext. These should be edited be¬fore printing the final
bibliography.

A maximum of 999 references is permitted.

Ê
ÊÜ`܌ççEditing Text and Bibliographyèè

Word Perfect's dual file editing capability may be
quite useful in keeping text and bibliography current
with each other.
ÊÊ

ççPrinting the Bibliographyèè

For complete details, see the WP manual on merge
šfiles.

However, I can suggest that you try constructing the
primary merge file something like this:

Ì ÌÌÌÂÂ1. Set Margins if desired, and justification off.ÞDÞ
Ì ÌÌÌÂÂ2. [Margin Release] ) .  etcÞDÞ
Ì ÌÌÌÂÂ ^N^P^PÞDÞ
Ì ÌÌÌÂÂ3. Save this primary file and then execute the merge.ÞDÞ

If there are bibliography items with number 9999, you
may want to change the 9's to blanks before the merge.

Note that step two puts the number out to the left,
adds a ")" after the number, and a period after each
šfield. Experiment to get the format you like.
Ê,Ê


ççError Handlingèè

BP works by sequentially numbering each dis¬tinct num­ber in the text, and then going to the bibliography file
to renumber it. Seven kinds of er¬ror can occur:

Ì ÌÌÌÂÂ 1. Number in text but not bibliography.  BP reports
new number.  Job completes.ÞDÞ
Ì ÌÌÌÂÂ 2. Number in bibliography, not text.  BP re¬ports old
number, sets it equal to 9999 in new bibliogra­phy.  Job completes.ÞDÞ
Ì ÌÌÌÂÂ 3. Number in text too long.  BP ignores it, job com­pletes.ÞDÞ
Ì ÌÌÌÂÂ 4. Number in bibliography too long.  Error noted. Job
aborts.ÞDÞ
Ì ÌÌÌÂÂ 5. Duplicate numbers in bibliography. Error
šnoted. Job aborts.ÞDÞ
Ì ÌÌÌÂÂ 6. Non-numeric characters between [..] in text.  BP
ignores. Job completes.ÞDÞ
Ì ÌÌÌÂÂ 7. Non-numeric characters in first field of biblio­graphy.  Er¬ror noted. Job aborts.ÞDÞ
Üd܌Note that the handling of #3 and #6 is such that the use
of brackets for other than references is legitimate.
Ê0Ê
ççGlitches and Quirksèè

Ì ÌÌÌÂÂ1. Because BP is written in Turbo Pascal, new¬ly crea­ted files all have a Control Z (^Z) at the end
of them.  Therefore, use WP to edit the new text,
go to end of file (which will also re-format the
docu¬ment if needed) and delete the ^Z.ÞDÞ

Ì ÌÌÌÂÂ Failure to delete ^Z's may cause WP to hang later
on.ÞDÞ

Ì ÌÌÌÂÂ2. If you wish to have references appear in a differ­ent format, use the Search/ Re¬place feature just
before printing.  For example, instead ofÞDÞ

[5][6] --> [5,6]
or [5][6][7] --> [5,6,7],

Ì ÌÌÌsearch on "][" and replace with ",".ÞDÞ

Ì ÌÌÌÂÂ However, beware this altered version cannot be fur­ther processed by BP in case you have later revi­sions.  Use it only for printing final copies.ÞDÞ

Ê Ê


ççPhysicians for Social Responsibilityèè

Physicians for Social Responsibility is an organiza­tion of over 30,000 physicians, dentists, and others ded­icated to the education of pro¬fessionals and the pub¬lic
about the current and future consequences of nuclear arms
and nuclear war.

Physicians and other interested persons are most wel­come to join PSR and may do so by con¬tacting their local
office or by writing to

Physicians for Social Responsibility
639 Massachusetts Avenue
Cambridge, Massachusetts 02139


  3 Responses to “Category : Word Perfect
Archive   : BIBPERF.ZIP
Filename : BIB-PERF.WP

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/