From c999f0b04c526a85d061a7461c0e4211e94f9fb7 Mon Sep 17 00:00:00 2001 From: Eric Biggers Date: Sat, 9 Sep 2023 11:30:45 -0700 Subject: Adjust nested lists to prevent gofmt from flattening them The latest version of gofmt flattens the nested lists in comments in crypto.go and filesystem.go. According to https://go.dev/doc/comment#mistakes, "Go doc comments do not support nested lists". However, that page also mentions that a workaround is to use different list markers for each level. Do that. --- crypto/crypto.go | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'crypto') diff --git a/crypto/crypto.go b/crypto/crypto.go index 1f64b38..edc4ed7 100644 --- a/crypto/crypto.go +++ b/crypto/crypto.go @@ -18,11 +18,11 @@ */ // Package crypto manages all the cryptography for fscrypt. This includes: -// - Key management (key.go) +// 1. Key management (key.go) // - Securely holding keys in memory // - Making recovery keys -// - Randomness (rand.go) -// - Cryptographic algorithms (crypto.go) +// 2. Randomness (rand.go) +// 3. Cryptographic algorithms (crypto.go) // - encryption (AES256-CTR) // - authentication (SHA256-based HMAC) // - key stretching (SHA256-based HKDF) -- cgit v1.2.3