From 365b831e6f290c733da6879dae871dada343a1eb Mon Sep 17 00:00:00 2001
From: John Ericson <git@JohnEricson.me>
Date: Fri, 26 Jan 2024 23:11:31 -0500
Subject: [PATCH] Minor formatting tweaks

---
 src/libexpr/parser-state.hh | 25 ++++++++++++++++---------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/src/libexpr/parser-state.hh b/src/libexpr/parser-state.hh
index a5b932ae8..0a9f076dc 100644
--- a/src/libexpr/parser-state.hh
+++ b/src/libexpr/parser-state.hh
@@ -1,19 +1,25 @@
 #pragma once
+///@file
 
 #include "eval.hh"
 
 namespace nix {
 
-// using C a struct allows us to avoid having to define the special
-// members that using string_view here would implicitly delete.
-struct StringToken {
-  const char * p;
-  size_t l;
-  bool hasIndentation;
-  operator std::string_view() const { return {p, l}; }
+/**
+ * @note Storing a C-style `char *` and `size_t` allows us to avoid
+ * having to define the special members that using string_view here
+ * would implicitly delete.
+ */
+struct StringToken
+{
+    const char * p;
+    size_t l;
+    bool hasIndentation;
+    operator std::string_view() const { return {p, l}; }
 };
 
-struct ParserLocation {
+struct ParserLocation
+{
     int first_line, first_column;
     int last_line, last_column;
 
@@ -36,7 +42,8 @@ struct ParserLocation {
     }
 };
 
-struct ParserState {
+struct ParserState
+{
     SymbolTable & symbols;
     PosTable & positions;
     Expr * result;