etfinsrt(3)

NAME

etfinsrt - Insert template file into current buffer

SYNOPSIS

etfinsrt "template"

DESCRIPTION

etfinsrt is generally called by file hooks when the new buffer has been created as opposed to loaded from a file (see $buffer-fhook(5)).

etfinsrt uses &find(4) to locate and insert the required "template.etf" file. If successful, etfinsrt then replaces the following strings in the template:

$ASCII_TIME$


To the current time. Inserts the output of ascii-time(3).

$BUFFER_NAME$


To the buffer name. The name is capitalized, '.'s are replaced with '_' and any trailing "<##>" digits (used to make the buffer name unique) are removed.

$COMPANY_NAME$


To the value of %company-name, or if not defined to the value used for $USER_NAME$. %company-name is usually set up in the company setup file defined in User setup.

$USER_NAME$


To the value of the registry entry "/history/user-name", or if not defined to the value "<unknown>". The user name is usually set up in the User setup dialog.

$YEAR$


To the current year (4 digit number).

EXAMPLE

The following is taken from hkmake.emf and inserts the "makefile.etf" template if the buffer has been created.

define-macro fhook-make 
    ; if arg is 0 this is a new file so add template 
    !if &not @# 
        etfinsrt "makefile" 
    !endif 
    set-variable $buffer-hilight .hilight.make 
    -1 buffer-mode "tab"		; Normal tabs please !!! 
    1 buffer-mode "indent" 
    1 buffer-mode "time" 
!emacro 

NOTES

etfinsrt is a macro defined in etfinsrt.emf.

magic(2m) mode is always used to perform the the search/replace so the replace strings should be appropriate for magic.

SEE ALSO

$buffer-fhook(5), &find(4), ascii-time(3).

(c) Copyright JASSPA 1999
Last Modified: 1999/02/27
Generated On: 1999/12/01