< BibTeX Language Template for LSE - Version 1.00 (8-Jun-1988)< ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~         1. Introduction  ~~~~~~~~~~~~~~~   P An LSE template to assist with the creation of BibTeX bibliography databases hasP been written. This is a short guide on installing the BibTeX language definitionI and  its online help. The guide is fairly brief and is aimed at the local H System Manager / TeX maintainer, who should be familiar with LSE and its installation / customization.   A N.B. You must have LSE V2.1 or later for this definition to work. B      The language definition is for BibTeX v0.9. A definition for !      BibTeX v0.99 being prepared.      2. Files Provided  ~~~~~~~~~~~~~~~~~   Q Three files are provided for the installation of the BibTeX language definition:     	AAAREADME.TXT	- this file4 	BIBTEX.LSE	- the BibTeX language definition for LSE: 	BIBTEX.HLP	- the online help file for the BibTeX language        * 3. Installation of the Language Definition* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  F Assuming that all of the files are present, the addition of the BibTeX? language definition to LSE's capabilities proceeds as follows:    D 	a. Set the default directory to the one containing the above files.  % 	b. Invoke LSE with the DCL command :    		LSEDIT/READ_ONLY BIBTEX.LSE   D 	c. Press CTRL-Z, to enter the LSE command mode. You should get the  	   prompt "LSE>"   ? 	d. At the "LSE>" prompt, instruct LSE to execute the language  B 	   definition with the LSE command "DO". You will notice a large C 	   number of error messages in the dialogue region of the screen.  3 	   This is to be expected and is entirely normal!   	   F 	e. When the "LSE>" prompt returns, repeat the LSE "DO" command. This D 	   time there should be no messages; the "LSE>" prompt reappearing  	   after a short time.   A 	f. To confirm that the language definition is OK, issue the LSE  
 	   commands:   # 		CHECK LANGUAGE/DEFINITIONS BIBTEX & 		CHECK LANGUAGE/HELP_INTERFACE BIBTEX  : 	   Both commands should report that no errors were found.  F 	g. LSE now "knows" all about BibTeX. To save that knowledge as an LSEG 	   environment file in the file "XXXXXXXX.ENV", issue the LSE command:    		SAVE ENVIRONMENT XXXXXXXX    	   at the "LSE>" prompt.   H 	h. The file "XXXXXXXX.ENV" environment now contains the BibTeX language: 	   definition in addition to any other languages defined.  C 	i. To make use of this definition, LSE must be told about the new  A 	   environment file using the "/ENVIRONMENT" command qualifier,  H 	   or by setting the VMS logical name "LSE$ENVIRONMENT" to refer to the 	   new environment file.  	 F 	   NOTE: The full file specification for the environment file must be? 		 given, or the environment file must be moved to SYS$LIBRARY.          4. Installation of Online Help ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  N An online help file is provided which is used by LSE (and may be used by DCL).I The help file "BIBTEX.HLP" must be added to an appropriate help library.    H To add BIBTEX.HLP to the help library "TEX$:LATEX_HELP.HLB", use the DCL	 command:   		9 		LIBRARY/REPLACE/HELP/LOG TEX$:LATEX_HELP.HLB BIBTEX.HLP   O The BibTeX language definition tells LSE to find the help information in a help M library referred to by the VMS logical name "BIBTEX$HELP_LIBRARY". You should P ensure that this logical name is defined to refer to the help library, or changeF the /HELP_LIBRARY qualifier of the "DEFINE LANGUAGE BIBTEX" command in BIBTEX.LSE.   2 If you decide on the latter approach, be careful!           ! 5. Bugs / Problems / Deficiencies ! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~   L There is no automated command procedure for installation. Experienced users,O however, never seem to trust automated procedures from 'public domain' sources.        6. Further Assistance  ~~~~~~~~~~~~~~~~~~~~~   G If problems are encountered, the author will be happy to assist. He is:      		Niel Kempson 		, 		School of Electrical Engineering & Science# 		Royal Military College of Science  		Shrivenham 		SWINDON   	 		SN6 8LA 	 		ENGLAND   + 		Telephone:	0793 782551 ext 2687 (or 2248)   & 		Network:	rm001A@uk.ac.cranfield.cdvc3 				(Mark for the attention of Niel Kempson as this  				 is a shared mail address). 