<<< "bibcard", an X based interface for BiBTeX databases. >>>

version 1.11 IAM

The bibcard executable included in this distribution has been compiled on a
SPARCstation 1 (sun4) and is statically linked. If the defaults which you'll
find in bc_macros.h and Makefile do not match your environment you'll have to
recompile the program.  To build bibcard you will need the XView 3.0 and the
DevGuide 3.0 libraries.
 
**** Environment variables

To install bibcard you need to set the following environment variables:

OPENWINHOME - the home directory of OpenWIndows, normally /usr/openwin.

GUIDEHOME - the home directory of DevGuide, /usr/local/guide3 on our machine.

**** Additional program needed

You also need the agrep programm (for the approximate search feature)
[agrep is available by anonymous ftp from cs.arizona.edu (IP 192.12.69.5)
as agrep/agrep-2.01.tar.Z]. Add the path for the agrep command in bc_macros.h.

**** Cusomizing bibcard

You can customize bibcard by editing the file bc_macros.h and Makefile.
Here is a description of the most important macros:

bc_macros.h:

BIBPATHVAR 		"BIBINPUTS"
	use this environment variable to find bibtex file
ABBREVCODE		'#'
	use this character to mark abbreviation in bibtex files.
BIB_EXTENSION		".bib"
	extension used for bibtex files
NEW_BIB_NAME		"New.bib"
	default name for new bibtex files
BIBCARD_NAME            "Bibcard (IAM)"
	name of the application. Appears in window decoration

AGREP_COMMAND           "/usr/local/bin/agrep"
	absolute path to agrep(1)
TEMP_DIR                "/tmp/"	
 	name of your favourite temporary directory
LOCATION_MENU_1..9      "Menu Text"
	define your own location menu
DEFAULT_FIND_FIELD1..5  "field token"
	set default fields for find popup
DEFAULT_MAX_TOTAL_FOR_LIST 2000
	for very long lists speed goes down. Doing without
	the list will speed up. If maximum is reached the list
	will automaticaly hide and the find selections are
	stored in a second (quite fast) list.


Makefile:

-DCRINDEX_FIELD
	set this if you want the crindex field appear in bibcard.
-DCROSS_REF_KEY_FIELD
	set this if you want the cross ref key field appear in bibcard
-DDATE_FIELD
	set this if you want the date field appear in bibcard
-DKEYWORDS_FIELD
	set this if you want the keywords field appear in bibcard
-DLOCATION_FIELD
	set this if you want the location field appear in bibcard
-DSIGNATURE_FIELD
	set this if you want the signature field appear in bibcard
-DISBN_FIELD
	set this if you want the isbn  field appear in bibcard
-DNUM_OF_FIELDS
	23 + # user fields !!!
-DPRINT_FIND_NUM
	set this if you want to get a message in the footer which says how
	many entries have been found during search.
-DSTRIP_ALL_SPACES
	set this if you want bibcard to remove leading/trailing/excessive
	spaces and tabs
-DSTRIP_WHILE_LOADING
	set this (and STRIP_ALL_SPACES) if you want bibcard to remove
	leading/trailing/excessive spaces and tabs when loading files
-DUPPERCASE
	set this if you want bibcard to change bibtex keyword to upper case.
	Otherwise they will be set to lower case.
-DSHOW_SELECTED_IN_FOOTER
	if set the number of selected entries will be shown in the footer
-DSHOW_TOTAL_IN_FOOTER
	if set the total number of entries will be shown in the footer
-DSHOW_TOTAL_SELECTED_IN_FOOTER
-DSHOW_ERROR_IN_LINE
	set this if you want bibcard to print the line number of an invalid
	entry in a bibtex file
-DUPDATE_LIST_WHILE_LOADING_IF_UPDATE_IS_OFF
	set this if you want bibcard to update list while loading even if
	update is set to OFF
-DADD_EXTENSION_IF_MISSING
	set this if you want bibcard to add .bib if missing in filename

**** Building bibcard

Did you check the settings in bc_macros.h and Makefile? OK!  Now just run
"make"

bibcard comes with a help file compatible with the OpenWindows help facility.
This file, "bc.info" should be installed in a directory specified in the
environment variable "HELPPATH"

A manpage is given in bibcard.1


