From: Geoffrey Keating <geoffk@apple.com>
Date: Fri, 28 May 2004 21:41:42 +0000 (+0000)
Subject: * stringpool.c: Add comments to PCH saving/restoring routines.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=4bb4ae964aaf3ef1dd86d2b595a022a9961aee5b;p=gcc.git

* stringpool.c: Add comments to PCH saving/restoring routines.

From-SVN: r82380
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 4f7f078579d..1fa48e1d06e 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2004-05-28  Geoffrey Keating  <geoffk@apple.com>
+
+	* stringpool.c: Add comments to PCH saving/restoring routines.
+
 2004-05-28  Andrew Pinski  <pinskia@physics.uc.edu>
 
 	* c-common.c (c_estimate_num_insns_1): Kill.
diff --git a/gcc/stringpool.c b/gcc/stringpool.c
index 3592d4e36a4..781518b9f7d 100644
--- a/gcc/stringpool.c
+++ b/gcc/stringpool.c
@@ -146,7 +146,7 @@ stringpool_statistics (void)
 {
   ht_dump_statistics (ident_hash);
 }
-
+
 /* Mark an identifier for GC.  */
 
 static int
@@ -193,9 +193,12 @@ gt_pch_n_S (const void *x)
 {
   gt_pch_note_object ((void *)x, (void *)x, &gt_pch_p_S);
 }
-
+
 /* Handle saving and restoring the string pool for PCH.  */
 
+/* SPD is saved in the PCH file and holds the information needed
+   to restore the string pool.  */
+
 struct string_pool_data GTY(())
 {
   tree * GTY((length ("%h.nslots"))) entries;
@@ -205,6 +208,9 @@ struct string_pool_data GTY(())
 
 static GTY(()) struct string_pool_data * spd;
 
+/* Copy HP into the corresponding entry in HT2, and then clear
+   the cpplib parts of HP.  */
+
 static int
 ht_copy_and_clear (cpp_reader *r ATTRIBUTE_UNUSED, hashnode hp, const void *ht2_p)
 {
@@ -227,8 +233,15 @@ ht_copy_and_clear (cpp_reader *r ATTRIBUTE_UNUSED, hashnode hp, const void *ht2_
   return 1;
 }
 
+/* The hash table as it was before gt_pch_save_stringpool was called.  */
+
 static struct ht *saved_ident_hash;
 
+/* The hash table contains pointers to the cpp_hashnode inside the
+   lang_identifier.  The PCH machinery can't handle pointers that refer
+   to the inside of an object, so to save the hash table for PCH the
+   pointers are adjusted and stored in the variable SPD.  */
+
 void
 gt_pch_save_stringpool (void)
 {
@@ -249,6 +262,9 @@ gt_pch_save_stringpool (void)
   ht_forall (ident_hash, ht_copy_and_clear, saved_ident_hash);
 }
 
+/* Return the stringpool to its state before gt_pch_save_stringpool
+   was called.  */
+
 void
 gt_pch_fixup_stringpool (void)
 {
@@ -257,6 +273,9 @@ gt_pch_fixup_stringpool (void)
   saved_ident_hash = 0;
 }
 
+/* A PCH file has been restored, which loaded SPD; fill the real hash table
+   with adjusted pointers from SPD.  */
+
 void
 gt_pch_restore_stringpool (void)
 {