Variable: time-stamp-inserts-lines

time-stamp-inserts-lines is a variable defined in time-stamp.el.gz.

Value

nil

Documentation

Whether M-x time-stamp (time-stamp) can change the number of lines in a file.

When time-stamp-format contains newline characters, the intent is ambiguous: does the author want to update a single multi-line time stamp, or create a repeated time stamp by inserting new lines? This variable controls the interpretation.

If nil, time-stamp tries not to change the number of lines in the buffer and treats the format as one single, multi-line time stamp. The time-stamp-end must start N lines after the end of time-stamp-start, where N is the number of newlines in time-stamp-format.

If this variable is non-nil, time-stamp is willing to add lines to the buffer. The end pattern must start somewhere in the remainder of the same line where the start pattern ends. This behavior lets a file accumulate repeated time stamps.

In the most common case that time-stamp-format contains no newlines, this variable has no effect; the end of the start and the start of the end are always on the same line.

These variables are best changed with file-local variables. If you were to change time-stamp-start, time-stamp-end or time-stamp-inserts-lines in your init file, you would be incompatible with other people's files.

Probably introduced at or before Emacs version 21.1.

Source Code

;; Defined in /usr/src/emacs/lisp/time-stamp.el.gz
;;;###autoload(put 'time-stamp-end 'safe-local-variable #'stringp)


(defvar time-stamp-inserts-lines nil    ;Do not change!
  "Whether \\[time-stamp] can change the number of lines in a file.
When `time-stamp-format' contains newline characters, the intent
is ambiguous: does the author want to update a single multi-line
time stamp, or create a repeated time stamp by inserting new lines?
This variable controls the interpretation.

If nil, `time-stamp' tries not to change the number of lines in the
buffer and treats the format as one single, multi-line time stamp.
The `time-stamp-end' must start N lines after the end of
`time-stamp-start', where N is the number of newlines in
`time-stamp-format'.

If this variable is non-nil, `time-stamp' is willing to add lines
to the buffer.  The end pattern must start somewhere in the
remainder of the same line where the start pattern ends.
This behavior lets a file accumulate repeated time stamps.

In the most common case that `time-stamp-format' contains no
newlines, this variable has no effect; the end of the start
and the start of the end are always on the same line.

These variables are best changed with file-local variables.
If you were to change `time-stamp-start', `time-stamp-end' or
`time-stamp-inserts-lines' in your init file, you would be
incompatible with other people's files.")