Skip to content

Commit

Permalink
standard: Add initial section with more context and REUSE
Browse files Browse the repository at this point in the history
  • Loading branch information
infinisil committed Mar 14, 2024
1 parent e1d8151 commit 80b5ecb
Showing 1 changed file with 14 additions and 1 deletion.
15 changes: 14 additions & 1 deletion standard.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,16 @@
<!-- © 2024 piegames <[email protected]>
- © 2024 Silvan Mosberger <[email protected]>
-
- SPDX-License-Identifier: MPL-2.0
-->

# Standard Nix format

This document describes the standard Nix format, as first established [by RFC 166](https://github.com/NixOS/rfcs/blob/master/rfcs/0166-nix-formatting.md#standard-nix-format).

Controversial changes to this document must go through another RFC.
It is up to the Nix formatting team to decide when an RFC is necessary.

## Terms and definitions:

- **Brackets:** `[]`
Expand Down Expand Up @@ -54,7 +67,7 @@
- **Absorbable Terms:**
Attribute sets, lists, and multiline `''` strings are called absorbable terms. Parenthesized absorbable terms are absorbable terms again too.

## Initial standard Nix format
## General

- The formatter should be as "pure" as possible, i.e. different input formats of the "same" code (same AST with comments) should result in the same output format.
- The formatter may take the input formatting into account in some cases in order to preserve multi-line syntax elements (which would otherwise have been contracted by the rules).
Expand Down

0 comments on commit 80b5ecb

Please sign in to comment.