c3(9)

SYNOPSIS

C3 - C3 programming language

FILES

hkc3.emf - C3 programming language hook definition
c3.eaf - C3 programming language abbreviation file
c3.etf - C3 programming language template file

EXTENSIONS

.c3 - C3

DESCRIPTION

The c3 file type templates share much with the c(9) template definitions, utilising the electric 'C' features for automatic layout of text.

General Editing


On creating a new file, a new header is automatically included into the file. time(2m) is by default enabled, allowing the modification time-stamp to be maintained in the header.

Hilighting


The hilighting features allow commands, variables, logical, preprocessor definitions, comments, strings and characters of the language to be differentiated and rendered in different colors.

Auto Layout


The C-Mode indent(2) performs automatic layout of the text.

restyle-region(3) and restyle-buffer(3) are available to reformat (re-layout) selected sections of the buffer, or the whole buffer, respectively.

Comments may be formatted using esc o, which reformats the comments according to the current fill paragraph. If a comment commences with /***... then the comment is automatically formatted to a box.

Folding and Information Hiding


Generic folding is enabled within the C3 file. The folds occur about functions defined with the fn keyword and a closing curly brace both at the beginning of a line. collapse-all(3) (un)folds all regions in the file, collapse-current(3) (un)folds the current region.

Navigation via Item List


The C3 mode offers beside folding as well support for displaying an outline of the functions of the C3 file for easy navigation using the item-list(3) command.

Abbreviations


The installation comes with a default abbreviation file for C3 file editing which can be used by writing short abbreviations like "for", "if", "ef" (else if), "doc" (documentation) or "fn" - and then pressing the key-binding for the expand-abbrev-handle(3) command. The list of abbreviations can be used interactively in the GUI version of MicroEmacs using the abbrev-list(3) command.

Working Environment


compile(3) may be invoked to rebuild the source, the user is prompted to save any files.

Short Cuts


The short cut keys used within the buffer are:-

C-c C-c - Comment out the current line.
C-c C-d - Uncomment the current line.
C-c C-e - Comment to the end of the line with stars (*).
A-C-i - Restyle the current region.
esc q - Format a comment.
esc o - Format a comment.
f2 - (Un)fold the current region.
C-f2 - (Un)fold all regions.
f6 - List items.
esc f6 - Close item list,

NOTES

The hilighting or the addition of new item list matches is typically extended using a file myc3.emf

SEE ALSO

abbrev-list(3), c(9), collapse-all(3), collapse-current(3), compile(3), expand-abbrev-handle(3), item-list(3), restyle-buffer(3), restyle-region(3), time(2m).

Supported File Types

(c) Copyright JASSPA 2025
Last Modified: 2025/08/28
Generated On: 2025/09/29