tristan/exercises
1
0
Fork 0
mirror of https://codeberg.org/ziglings/exercises.git synced 2024-12-26 01:20:30 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

build: fix doc-comments

Browse source 
Some functions and custom build steps incorrectly used a normal comment.
Use a doc-comment instead.

Additionally, use a present tense verb to describe the action of a
function or custom build step.
This commit is contained in:
Manlio Perillo 2023-05-08 08:56:35 +02:00
parent dd5df9f7cc
commit 9de89f6d60
1 changed files with 9 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
build.zig
View file

@ -568,13 +568,13 @@ const ZiglingStep = struct {
} }
}; };
// Clear the entire line and move the cursor to column zero. /// Clears the entire line and move the cursor to column zero.
// Used for clearing the compiler and build_runner progress messages. /// Used for clearing the compiler and build_runner progress messages.
fn resetLine() void { fn resetLine() void {
if (use_color_escapes) print("{s}", .{"\x1b[2K\r"}); if (use_color_escapes) print("{s}", .{"\x1b[2K\r"});
} }
/// Remove trailing whitespace for each line in buf, also ensuring that there /// Removes trailing whitespace for each line in buf, also ensuring that there
/// are no trailing LF characters at the end. /// are no trailing LF characters at the end.
pub fn trimLines(allocator: std.mem.Allocator, buf: []const u8) ![]const u8 { pub fn trimLines(allocator: std.mem.Allocator, buf: []const u8) ![]const u8 {
var list = try std.ArrayList(u8).initCapacity(allocator, buf.len); var list = try std.ArrayList(u8).initCapacity(allocator, buf.len);
@ -594,7 +594,7 @@ pub fn trimLines(allocator: std.mem.Allocator, buf: []const u8) ![]const u8 {
return std.mem.trimRight(u8, result, "\n"); return std.mem.trimRight(u8, result, "\n");
} }
// Print a message to stderr. /// Prints a message to stderr.
const PrintStep = struct { const PrintStep = struct {
step: Step, step: Step,
message: []const u8, message: []const u8,
@ -621,7 +621,7 @@ const PrintStep = struct {
} }
}; };
// Skip an exercise. /// Skips an exercise.
const SkipStep = struct { const SkipStep = struct {
step: Step, step: Step,
exercise: Exercise, exercise: Exercise,
@ -650,10 +650,10 @@ const SkipStep = struct {
} }
}; };
// Check that each exercise number, excluding the last, forms the sequence /// Checks that each exercise number, excluding the last, forms the sequence
// `[1, exercise.len)`. /// `[1, exercise.len)`.
// ///
// Additionally check that the output field lines doesn't have trailing whitespace. /// Additionally check that the output field lines doesn't have trailing whitespace.
fn validate_exercises() bool { fn validate_exercises() bool {
// Don't use the "multi-object for loop" syntax, in order to avoid a syntax // Don't use the "multi-object for loop" syntax, in order to avoid a syntax
// error with old Zig compilers. // error with old Zig compilers.