Homepage Project

File Properties

Description
Known Problems
Download
Version history

Description

Store file local variables without changing the file's contents. Add the variable's symbol to `file-properties-list', and the variable will be automatically saved and restored. Candidates would be:

In addition, overlays can be stored too (see `file-properties-overlays').

By default, the file-properties of file /there/here/this.txt will be stored in /there/here/.props/this.txt (see `file-properties-subdir'). This variable can be tweaked, so that properties for files in unwriteable directories are stored in ~/.props/filename. This means you can store file local variables for files for which you don't have writing permisson. A third stratey is to mark files with unique IDs -- see `file-properties-define-unique-id'.

Installation: Put (require 'file-properties) (file-properties-install) into your startup/user init file.

Commands

`file-properties-add', `file-properties-remove'
Add and remove a variable to or from the file's property list.
`file-properties-overlay-add', `file-properties-overlay-remove'
Add and remove overlays containing a specific symbol.
`file-properties-add-special', `file-properties-remove-special'
Add or remove a mode setting function or a hook function.
`file-properties-write'
Write the property file.
`file-properties-install', `file-properties-deinstall'
Add and remove file-properties.el specific hooks.
`file-properties-define-unique-id'
Insert a unique ID for the current buffer. From then on, this ID will be used for storing file properties under `file-properties-uniquedir'.

Variables

`file-properties-list'
A list of file-properties that should be stored in the property file.
`file-properties-overlays'
A list of symbols or plists identifying overlays that should be stored.
`file-properties-overlay-ignored-properties'
Ignore these properties when dumping overlays.
`file-properties-categories'
Definition of "special" properties.
`file-properties-file'
A buffer local variable defining the properties file -- relative to the current buffer's/file's location. Use this to force the use of a non-standard properties file.

Known Problems

-- just to be sure.

Download

Requirements: tellib

v1.3: file-properties.el.gz

Version history

  1. Renamed "properties" to "file-properties"; directory properties; `file-properties-dirty-flag'; catch errors, when `file-properties-read' fails; `file-properties-get-file-desc', `file-properties-verify-file-desc'; `file-properties-do-nothing'; `file-properties-define-unique-id'.
  2. Save some modes and hooks too -- see `file-properties-add-special'.
  3. Save and restore some overlays; better control over where to save properties files (see `file-properties-location')
  4. Initial release


(c) 2003 Thomas Link (last updated Mar 20 2003) home top