Improve comments, fix dates, add header

Author: gperciva

COPYRIGHT

@@ -1,8 +1,8 @@
 The included code and documentation ("scrypt") is distributed under the
 following terms:
 
-Copyright 2005-2023 Colin Percival.  All rights reserved.
-Copyright 2011-2023 Tarsnap Backup Inc.  All rights reserved.
+Copyright 2005-2025 Colin Percival.  All rights reserved.
+Copyright 2011-2025 Tarsnap Backup Inc.  All rights reserved.
 Copyright 2014 Sean Kelly.  All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

libcperciva/cpusupport/Build/cpusupport-ARM-AES.c

@@ -1,3 +1,5 @@
+#include <stdint.h>
+
 #ifdef __ARM_NEON
 #include <arm_neon.h>
 #endif
@@ -11,10 +13,12 @@ main(void)
 	uint32x4_t lanes = {0};
 	uint8_t arr[16] = {0};
 
+	/* Check AES. */
 	data = vld1q_u8(arr);
 	output = vaeseq_u8(data, key);
 	(void)output; /* UNUSED */
 
+	/* Check _u32: some compilers only support the _u8 variant. */
 	lanes = vdupq_laneq_u32(lanes, 0);
 
 	/* Success! */

libcperciva/cpusupport/cpusupport_x86_aesni.c

@@ -26,5 +26,7 @@ CPUSUPPORT_FEATURE_DECL(x86, aesni)
 
 unsupported:
 #endif
+
+	/* Not supported. */
 	return (0);
 }

libcperciva/cpusupport/cpusupport_x86_rdrand.c

@@ -26,5 +26,7 @@ CPUSUPPORT_FEATURE_DECL(x86, rdrand)
 
 unsupported:
 #endif
+
+	/* Not supported. */
 	return (0);
 }

libcperciva/cpusupport/cpusupport_x86_shani.c

@@ -31,5 +31,7 @@ CPUSUPPORT_FEATURE_DECL(x86, shani)
 
 unsupported:
 #endif
+
+	/* Not supported. */
 	return (0);
 }

libcperciva/cpusupport/cpusupport_x86_sse2.c

@@ -26,5 +26,7 @@ CPUSUPPORT_FEATURE_DECL(x86, sse2)
 
 unsupported:
 #endif
+
+	/* Not supported. */
 	return (0);
 }

libcperciva/cpusupport/cpusupport_x86_ssse3.c

@@ -26,5 +26,7 @@ CPUSUPPORT_FEATURE_DECL(x86, ssse3)
 
 unsupported:
 #endif
+
+	/* Not supported. */
 	return (0);
 }

libcperciva/util/align_ptr.h

@@ -44,6 +44,8 @@ align_ptr(uint8_t * arr, size_t alignment)
 	 */
 	offset = (uintptr_t)(&arr[0]) % alignment;
 	offset = (alignment - offset) % alignment;
+
+	/* Return the aligned pointer. */
 	return ((void *)&arr[offset]);
 }