Lugaru's Epsilon
Programmer's
Editor 14.04

Context:
Epsilon User's Manual and Reference
   Commands by Topic
      Buffers and Files
         Buffers
         Files
            . . .
            Saving Files
            Backup Files
            File Name Templates
            Line Translation
            DOS/OEM Character Set Support
            . . .
         File Variables
            Directory-wide File Variables
            Vi/Vim File Variables
         . . .

Previous   Up    Next
Backup Files  Commands by Topic   Line Translation


Epsilon User's Manual and Reference > Commands by Topic > Buffers and Files > Files >

File Name Templates

Epsilon uses file name templates to construct one file name from another, such as constructing the name of a backup file from the original file name. Epsilon also uses these to construct command lines, for example in the various compile-?-cmd variables that the compile-buffer command uses, or with the % sequence in .mnu files.

Epsilon copies the template text, substituting pieces of the original file name when it encounters codes in the template, according to the table. The sequence %r substitutes a relative pathname to the original file name, if the file is within the current directory or its subdirectories, or an absolute pathname otherwise.

The sequence %h substitutes the host name, if the original file name is in URL format, otherwise nothing. The sequence %c substitutes the name of Epsilon's customization directory (see The Customization Directory).

The sequence %x substitutes the full pathname of the directory containing the Epsilon executable. The sequence %X substitutes the same full pathname, but this time after converting all Windows long file names making up the path to their equivalent short name aliases, if any. For example, if the Epsilon executable was in the directory c:\Program Files\Eps14\bin\, %x would use exactly that pathname, while %X might yield c:\Progra~1\Eps14\bin\. Under Unix, %X is the same as %x. Either always ends with a path separator character like / or \.

     Example 1  Example 2
       
 Code  Part  c:\dos\read.me  /usr/bin
 %p  Path  c:\dos\  /usr/
 %b  Base  read  bin
 %e  Extension  .me  (None)
 %f  Full name  c:\dos\read.me  /usr/bin
 %r  Relative path  dos\read.me  /usr/bin
   (assuming current    
   directory is  c:\  /usr/mark )
 %h  Host name of URL    
 %c  Customization dir  ...\Lugaru\Epsilon  /home/mark/.epsilon
 %x  Executable path  c:\Program Files\Eps14\bin\  /opt/epsilon14.04/bin/
 %X  Alias to path  c:\Progra~1\Eps14\bin\  /opt/epsilon14.04/bin/

If any other character follows %, Epsilon puts that character into the resulting file name. You can use this, for example, to include an actual % character in the result by putting %% in the template.



Previous   Up    Next
Backup Files  Commands by Topic   Line Translation


Lugaru Epsilon Programmer's Editor 14.04 manual. Copyright (C) 1984, 2021 by Lugaru Software Ltd. All rights reserved.