diff --git a/src/sdl2/pixels.rs b/src/sdl2/pixels.rs
index 765782197f..5cca5a0e50 100644
--- a/src/sdl2/pixels.rs
+++ b/src/sdl2/pixels.rs
@@ -10,7 +10,9 @@ pub struct Palette {
 
 impl Palette {
     #[inline]
-    /// Creates a new, uninitialized palette
+    /// Create a palette structure with the specified number of color entries.
+    ///
+    /// The palette entries are initialized to white.
     #[doc(alias = "SDL_AllocPalette")]
     pub fn new(mut capacity: usize) -> Result<Self, String> {
         use crate::common::*;