From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id 72A413858D38 for ; Mon, 18 Sep 2023 03:40:15 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 72A413858D38 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1695008415; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=t5fsZsWY/aXLFkBuJr2uLWkFs9JTCev2SndA8E6z6oM=; b=MHpahumzcAbGAh2EBjsGQNjQLTJYaEjygn0kcj7I7PlUYPxf3umk40o77TdcfPsdriBBAh 69hC+QvDbIqXZrlL67fm/tRRSSV40bnTgXhQ/vP29ICV4NXGmUkaS1zBTGDLlr/1YAKHFO IqX8tQsJYbebuXsrYSz+DiNdmr8ADD0= Received: from mail-qv1-f72.google.com (mail-qv1-f72.google.com [209.85.219.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-433-bbGoJRunOqiNqKmRKiF5Ng-1; Sun, 17 Sep 2023 23:40:13 -0400 X-MC-Unique: bbGoJRunOqiNqKmRKiF5Ng-1 Received: by mail-qv1-f72.google.com with SMTP id 6a1803df08f44-6564515eca8so25102746d6.3 for ; Sun, 17 Sep 2023 20:40:13 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695008413; x=1695613213; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=t5fsZsWY/aXLFkBuJr2uLWkFs9JTCev2SndA8E6z6oM=; b=BbFbxolDGETXfPAI6L0jVfbmFpCPJf3Fh3+/KB1mVKZ1DyTJU5qb4iboTFXYWf51aI EdhGM1G3YHtp8Setmp6CYZZGHcv535vXQGqvI9tYKqc8hhRb3aA6wBJNIAhcEfBLHiGv 213oBotuITdWfi5zjc5nJo8FjDof/ArAnjFY1IPOmf61EBYCXto5wjSGSYuZ2X4tHk7V dmVtWiGk2r2/80A6iKXQuk6p3tLXDdnrabwIrTle1BMxbIgSLDeCE3Z/+oopOjIBTBfF Wjx2E2+kxzqfx4ku9/cM2j8n/Y7iQu7cQqqd4EZMGho29hj/DJQjqjM3V8ttiC73ZknA N56g== X-Gm-Message-State: AOJu0YznZIyPgHe+LtrNvYfaBt9nJq84Yoyz3X8a5P5i1aTSWhuDfT4E 3p+6UNvGRpGRnFJEKynQYqsxdCSAKIunIyfbUlbpc1LS4KxwLcA8lTpqYho5MGZE1yGZEw6JZDs STESGp4YJaTK4Ua/FhcwHGULx0nzIlACVQvulOdhh9ion6p5TkrEAA+KSTJz2xbIol4RQcp6akw == X-Received: by 2002:a0c:ab48:0:b0:655:d260:42b8 with SMTP id i8-20020a0cab48000000b00655d26042b8mr6903589qvb.19.1695008413112; Sun, 17 Sep 2023 20:40:13 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHWCLtvz7X+uiV1wHnQc3IEj+4m9AMWHQlrGAG+mkrGM/rLXlAdQB7BhMGNY5iq2UuVLUpOfg== X-Received: by 2002:a0c:ab48:0:b0:655:d260:42b8 with SMTP id i8-20020a0cab48000000b00655d26042b8mr6903580qvb.19.1695008412753; Sun, 17 Sep 2023 20:40:12 -0700 (PDT) Received: from jason.com (130-44-146-16.s12558.c3-0.arl-cbr1.sbo-arl.ma.cable.rcncustomer.com. [130.44.146.16]) by smtp.gmail.com with ESMTPSA id i11-20020a0cf10b000000b00655d6d31470sm1618083qvl.43.2023.09.17.20.40.11 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Sep 2023 20:40:11 -0700 (PDT) From: Jason Merrill To: gcc-patches@gcc.gnu.org Subject: [pushed] doc: GTY((cache)) documentation tweak Date: Sun, 17 Sep 2023 23:40:08 -0400 Message-Id: <20230918034008.3671734-1-jason@redhat.com> X-Mailer: git-send-email 2.39.3 MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="US-ASCII"; x-default=true X-Spam-Status: No, score=-12.5 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: Applying to trunk as obvious (explaining existing behavior). -- 8< -- gcc/ChangeLog: * doc/gty.texi: Add discussion of cache vs. deletable. --- gcc/doc/gty.texi | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/gcc/doc/gty.texi b/gcc/doc/gty.texi index 15f9fa07405..1dfe4652644 100644 --- a/gcc/doc/gty.texi +++ b/gcc/doc/gty.texi @@ -306,6 +306,13 @@ called on that variable between the mark and sweep phases of garbage collection. The gt_clear_cache function is free to mark blocks as used, or to clear pointers in the variable. +In a hash table, the @samp{gt_cleare_cache} function discards entries +if the key is not marked, or marks the value if the key is marked. + +Note that caches should generally use @code{deletable} instead; +@code{cache} is only preferable if the value is impractical to +recompute from the key when needed. + @findex deletable @item deletable base-commit: 68845f7c4d58186cc0a5b09f7511f3c0a8f07e88 -- 2.39.3