insert-file(2)

NAME

insert-file - Insert file into current buffer

SYNOPSIS

n insert-file "file-name" [ upper-offset lower-offset byte-length ] (C-x C-i) 

DESCRIPTION

insert-file inserts the named file file-name into the current buffer at the beginning of the current line. The buffer mark is set to the start of the insertion and the cursor is moved to the end. If the file-name is a directory then a directory listing is inserted into the buffer.

The numeric argument n is used to modify the default behavior of the command, where the bits are defined as follows:

0x02


If this bit is set the current buffer's file permissions and modification time are set to those of the file being inserted.

0x04


If this bit is set then a partial insert is performed based on skipping the first (upper-offset << 32) + lower-offset bytes and inserting the next byte-length bytes. If byte-length is negative then the same is done except moving from the end of the file. Partial insert is only supported for regular files on a local disk.

SEE ALSO

find-bfile(3), find-file(2), insert-file-name(2), page-bfile(3), page-file(3), set-mark(2), view-file(2).

Ref: insert-file(2) File: m2cmd073.2 Date: 2023/02/21

(c) Copyright JASSPA 2026