From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f169.google.com (mail-pf1-f169.google.com [209.85.210.169]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4B5C0364959 for ; Tue, 21 Jul 2026 18:43:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.169 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784659437; cv=none; b=Kh+7TxL7lkynrBt57MkHgZ36NCG+U1rQeWb045FfmK3xuphqGotAaynW+0we3kIOBHcVW5IvN3iY6MtGSG7maG+OEZGHVwr7aKyVWddJaI0R95mQrnQruXd21EO3VLFw5Ma8K37hF2ie62L7G/YvKYReo4ZDRl8kasgNS3ld+vw= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784659437; c=relaxed/simple; bh=2X+gemRbhVzS10YIiVdGi1RCYD1jaegwvIrd8xI4WGM=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=XAUUDbjIn5LM0P80Tp6xkqeORoPWHSR6phrU7cAniK4WW1oV+ahatv4F+TcUgdEBaQE9D+U6LMFkRYY9J636qZErkViUhnPz2L8kL3b44SGrgXGy3SJqs82Ldr+QP46eR1GurzJ8jI64nDQBWa5g7acX3+DNnyOq0XIGZYXLA3A= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=bNXbiP4z; arc=none smtp.client-ip=209.85.210.169 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="bNXbiP4z" Received: by mail-pf1-f169.google.com with SMTP id d2e1a72fcca58-8486672f03cso11671637b3a.0 for ; Tue, 21 Jul 2026 11:43:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1784659435; x=1785264235; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=gZ1R52FLh7zPxa/FB3IxbEKOJb4azpn+fb3xIAf3SG0=; b=bNXbiP4zY8Tmku0+wvi6RygUfbzssnIfkcgPPnRXg3wnDatUD707OeKaeDs7bgDJbK KOhHHhwJn6YMCKdY02Cj+mwXZTeoZAyOU2O6XPIZbByE11Cv7rMP3SpfoantbRlIsdL1 3NHPIDyQUQ3vf121pbhwqVvqZnXkKkRikYdmfu5oQxzsjW4vtTUPFwBezytzIbORtUg7 eR+IE1DxNt2pkhEw1D3md0hA6wIulbxlX/kGwRefjXl3VhPHq9HSWjW9gH33mtoB5dtn WfU3geXZ5NElJVzmXEM9xrAkm4BgJl81OMiimwTeSkqwmE/YVNEzdwORrvR7ak/LtWbD eShA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1784659435; x=1785264235; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=gZ1R52FLh7zPxa/FB3IxbEKOJb4azpn+fb3xIAf3SG0=; b=HJeuEBKSnN6Vw4WEbtrYyFIh6X3Dhu3BWTYYs2JxYJgZCNxrkPXhhy60lZNVMyEByv 0/2aROE/hL8wz4Y5AFCIBxgwYRxiVtHMH3FgsF9aGi03glNNfO2gZrupiNG5aBEUKC3A zOKDWU5BABMG7FDKki1pTNu7csyb7BheJb+EG2J8UCryV2OL/FZ/Z8lJcH7yPXjfSrHD /fCTnpgVntN56y1mB9U9yxBcT8cHIBFARunOaD7/o2bI4acxry/EednCve1CLXvV+sGt OhW790oGQsPrEea5LT1xLUG72Mmf8lcLMVOuJnPr7EnnMJCDXge0KyeevkHN7Mon2eCG MKiQ== X-Forwarded-Encrypted: i=1; AHgh+RoPhDxK8UD936LlNYIbCAdwD3wi10msQ93Coy0GpPMzzjDmtiJituRNM4QuinKyC7jqTMypF/G2/Zcz4Xk=@vger.kernel.org X-Gm-Message-State: AOJu0YwpO0n9Hnn4Vm0Zy1rOEpHEZe5CzT9BYKnAc7Pc3PW7aLTh4o0C YdqP4cBRUApfVTa59lN6N6TVGrXDvcdl5I7oMulwvSPnQ7ggFSKG40Mi X-Gm-Gg: AR+sD11EPTCHGGaRCzTLNi4VCS5VcKc+V4/GkzEK4g2GGSv0vxxCOtfY83H7HGFaAlB XdM6zb97ipylYypndrmfP9Zyeyeqw6J01PVqSmasqBQSvLiYgTf7rBgtQPvSAGVhSKRT41f1Kbf opYlVySYrgz62bEi4omV2slP+cFUwf165WUWYQrFBSQkJAW3NFYaU0VOCRDjdbVUUSS2qWJTq/o vfVopzAnDNaOz/TejajzAQYvDElwMl9M87q2w5gvEDWhbyDQFY+V9/jHG3cyI8Fo/zuIv2haaR1 2p7xyhN+yUMGBrItZUwERVV66cKNDji+2AnkP60nnH1yogvxczBC5Bfe+Kmj3PiuaRC6Y16GDsh XJg9YxXpTAKyxXSCBQ0x4y1vNn+IaMI0m8h0enUmq4QO/z+iIGlGSMyjfjIMsGRG7tO70tYYMm9 MZ0wC+5ozADuapW4FgEuBNrgo41yx/NUk1JKbnWOJv3ao= X-Received: by 2002:a05:6a00:240b:b0:848:2f7a:2e58 with SMTP id d2e1a72fcca58-84c294ed503mr19156469b3a.71.1784659435441; Tue, 21 Jul 2026 11:43:55 -0700 (PDT) Received: from colten.. (61-227-26-231.dynamic-ip.hinet.net. [61.227.26.231]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-84e175ce455sm138056b3a.48.2026.07.21.11.43.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 21 Jul 2026 11:43:55 -0700 (PDT) From: Jyun-An Chen To: Kuan-Wei Chiu Cc: Jyun-An Chen , Jonathan Corbet , Shuah Khan , linux-kernel@vger.kernel.org (open list:MIN HEAP), linux-doc@vger.kernel.org (open list:DOCUMENTATION) Subject: [PATCH v3] Documentation/core-api: min_heap: remove documented but unimplemented min_heap_empty() Date: Tue, 21 Jul 2026 18:43:34 +0000 Message-ID: <20260721184334.143152-1-jun930436@gmail.com> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit min_heap_empty()/min_heap_empty_inline() are documented as part of the Min Heap API, but no such functions or macros exist in include/linux/min_heap.h or lib/min_heap.c. Remove the stale description instead of adding unused API surface. Signed-off-by: Jyun-An Chen Acked-by: Kuan-Wei Chiu --- Changes since v2: - Fixed subject line. Documentation/core-api/min_heap.rst | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/Documentation/core-api/min_heap.rst b/Documentation/core-api/min_heap.rst index 9f57766581df..919dcf1bdec7 100644 --- a/Documentation/core-api/min_heap.rst +++ b/Documentation/core-api/min_heap.rst @@ -240,19 +240,6 @@ This macro returns `true` if the heap is full, otherwise `false`. **Inline Version:** min_heap_full_inline(heap) -- **min_heap_empty(heap)**: Checks whether the heap is empty. - Complexity: **O(1)**. - -.. code-block:: c - - bool empty = min_heap_empty(heap); - -- `heap`: A pointer to the min-heap to check. - -This macro returns `true` if the heap is empty, otherwise `false`. - -**Inline Version:** min_heap_empty_inline(heap) - Example Usage ============= -- 2.43.0