previous up contents next
Left: Order of material in Up: Style sheet for DATR Right: Opening declarations

File header

  Use the following format:

% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
%                                                                           %
% File:            estonia1.dtr                                             %
% Purpose:         morphophonemics of Estonian in the style of Chomsky 1952 %
% Author:          Gerald Gazdar, 1 September 1994                          %
% Email:           geraldg@sussex.ac.uk                                %
% Address:         Sussex University, Brighton BN1 9QH, UK            %
% Documentation:   estonia1.doc and paper cited below                       %
% Related files:   estonia2.dtr, latvian1.dtr                               %
% Version:         2.01                                                     %
%                                                                           %
%      Copyright (c) University of Sussex 1994.  All rights reserved.       %
%                                                                           %
% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %

Rationale: in addition to providing useful information about the file and its author, the header can be used as a formal database entry that allows sets of dtr (and other) files to be indexed, catalogued and sorted. The choice of format is pretty arbitrary for the first purpose but choice of the same format is crucial for the second. The File, Purpose, Author and Version lines should be considered obligatory, the rest optional. For the purposes of indexing programs, the Purpose line needs to be self-contained, but you can always add further lines for human readers:

% Purpose:         morphophonemics of Estonian in the style of Chomsky 1952 %
%                  in which it is shown that Estonian and Japanese are      %
%                  alphabetic variants of the same language.                %

The date following the author's name is intended to be the date the file was first made publicly available. If you want to note the date of the most recent revision, then this can be done on the Version line:

% Version:         2.01 (25th December 1994)                                %

The Version number X.YY relates to the version of the file, the X part being for major revisions, and the YY part for minor revisions. The version number is distinct from any automatically included RCS Id number found at the end of the file - the latter relates only to the edition of the DATR archive from which the dtr file was taken.

Although the Address line is not currently used by the program that indexes dtr files, it will make life easier if you can fit all of your address onto the line, rather than continuing below.

If your file is one of many (estonia1.dtr, estonia2.dtr, estonia3.dtr, estonia4.dtr, estonia5.dtr, ..) then you may want to use regular expressions in the Related files line:

% Related files:   estonia*.dtr, latvian*.dtr                               %

Whether you include a copyright line is entirely up to you. For all practical purposes, the existing archive of dtr files, like the existing implementations, is treated as ``academic public domain'', i.e., can be freely copied, used and modified for the purposes of teaching and research provided that any use properly credits the original author of the material. If you don't want your file to be circulated in the way other dtr files are, then make sure you put something like:

% NOT FOR PUBLIC CIRCULATION !!

at the top of the file.

---------------------------------------------------------

previous up contents next
Left: Order of material in Up: Style sheet for DATR Right: Opening declarations
Copyright © Roger Evans, Gerald Gazdar & Bill Keller, Tuesday 10 November 1998