Add comments

pageserver/src/aux_file.rs

@@ -54,6 +54,7 @@ const AUX_DIR_PG_UNKNOWN: u8 = 0xFF;
 /// * pg_logical/replorigin_checkpoint -> 0x0103
 /// * pg_logical/others -> 0x01FF
 /// * pg_replslot/ -> 0x0201
+/// * pg_stat/pgstat.stat -> 0x0301
 /// * others -> 0xFFFF
 ///
 /// If you add new AUX files to this function, please also add a test case to `test_encoding_portable`.

pageserver/src/basebackup.rs

@@ -258,6 +258,8 @@ where
     async fn send_tarball(mut self) -> Result<(), BasebackupError> {
         // TODO include checksum
 
+        // On normal Postgres shutdown, shutdown checkpoint should be performed and correspondent
+        // WAL record should be the last record in the WAL.
         let normal_shutdown = if let Ok(checkpoint_bytes) =
             self.timeline.get_checkpoint(self.lsn, self.ctx).await
         {