docs(tvix/eval): Use correct syntax for module doc comments

Change-Id: I35741856f34b86a538f226a8eaf8806edede60ec
Reviewed-on: https://cl.tvl.fyi/c/depot/+/6207
Reviewed-by: grfn <grfn@gws.fyi>
Tested-by: BuildkiteCI
This commit is contained in:
Vincent Ambo 2022-08-14 03:08:11 +03:00 committed by tazjin
parent 11ea7b82d8
commit 8d45fbadea
4 changed files with 12 additions and 13 deletions

View file

@ -1,10 +1,10 @@
/// This module implements Nix attribute sets. They have flexible
/// backing implementations, as they are used in very versatile
/// use-cases that are all exposed the same way in the language
/// surface.
///
/// Due to this, construction and management of attribute sets has
/// some peculiarities that are encapsulated within this module.
//! This module implements Nix attribute sets. They have flexible
//! backing implementations, as they are used in very versatile
//! use-cases that are all exposed the same way in the language
//! surface.
//!
//! Due to this, construction and management of attribute sets has
//! some peculiarities that are encapsulated within this module.
use std::collections::btree_map;
use std::collections::BTreeMap;
use std::fmt::Display;

View file

@ -1,4 +1,4 @@
/// This module implements Nix lists.
//! This module implements Nix lists.
use std::fmt::Display;
use super::Value;

View file

@ -1,10 +1,9 @@
//! This module implements Nix language strings and their different
//! backing implementations.
use smol_str::SmolStr;
use std::hash::Hash;
use std::{borrow::Cow, fmt::Display};
/// This module implements Nix language strings and their different
/// backing implementations.
#[derive(Clone, Debug)]
enum StringRepr {
Smol(SmolStr),

View file

@ -1,5 +1,5 @@
/// Warnings are emitted in cases where code passed to Tvix exhibits
/// problems that the user could address.
//! Implements warnings that are emitted in cases where code passed to
//! Tvix exhibits problems that the user could address.
#[derive(Debug)]
pub enum WarningKind {