Received: by 2002:ab2:1149:0:b0:1f3:1f8c:d0c6 with SMTP id z9csp1593529lqz; Mon, 1 Apr 2024 10:47:19 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCXbcNOFMyZjCzzOHCazR2R9lm2Ye9AXKhx0vxaihl0J14HJsEUmyUXDN4aKNF9dJHRqpjqlxuyXquscsDccNrsHUh7HS9rEBR6kec9yhQ== X-Google-Smtp-Source: AGHT+IE4i6fUKCM8OeXEn8Kup9nNaJH9LC/IbRcRIuVPKqUmsVZVtLY1d9rvr4GQHaqw3TCN6Ult X-Received: by 2002:a05:6214:1101:b0:696:7b17:4428 with SMTP id e1-20020a056214110100b006967b174428mr14973430qvs.29.1711993639213; Mon, 01 Apr 2024 10:47:19 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1711993639; cv=pass; d=google.com; s=arc-20160816; b=izmc5HZj+qp0Kb563OgAPw9CsNwfRvmSK2GtxuwBvwUl3LBUH8xg5Y1wxqS9INo8AB nsef1QNNLjrNgBeYSWSeXWYrx8feJuq6ay2mQUHrrFfXAwSD8UoOY9zYevYJSgdccsVr 3H7G7A/oVW4aNUABdhp4vZv2OJAd8bQNmtKZ2TmgN2eH9uyWuLKbUvT8WMVFSWKLsx5w LX6MsUW4BfCW/H9oifeCNRl464/6MtL8G1YCSdSSK50XNYyjE+YIFYLP2psSgtujlsAP euNkuVmB/vlUwSgh6bsUfVGe1oKzzUe9LPL6vFIWEX9h4kAwaJoDP85LhwpndjAPx5K2 2xCA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:list-unsubscribe:list-subscribe :list-id:precedence:dkim-signature; bh=HK1u6SkkL43OAT84jN1D+VjNCICU3PY99BO7+1mDvhw=; fh=LGW9gFqO8+IlgXLut2QLOOXD5//WCNh2G+uAI+2JLnY=; b=KQSENkGOtyNU8a+gCiJpkjz6AYOkf7X03q0lRTx5UO6koHQ0F2z9paQSZcyHf+Yd4W jLoWb8xXKM+QX1MzsMFLCyRZxj93qE9xFyAV3oevIl+VJrQv6iKhKxHRXv5auqz2YPQQ oeO0myk0F+SlsB673IxmwsqnDJhDB+61Fco2ENBd4d4tMGreSFLVQlIi8O9dlu0CJVtt aTQnV8VrroGMbV4zUQ6ntPSxHzK5xedrFVRtMXQ89IpUiONAFEg0MSLOPUHWd6wUJE/Z S3aJBs3IBWm9LP5rlCJyIS4gABQ3tc1WLLlKCGpL3Av+8IhQn6ZIQ2+y8Fq5T71xJFhw rtpw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=f1dwGYF9; arc=pass (i=1 spf=pass spfdomain=google.com dkim=pass dkdomain=google.com dmarc=pass fromdomain=google.com); spf=pass (google.com: domain of linux-kernel+bounces-126920-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-126920-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id iy3-20020a0562140f6300b006915b8b77c0si12359930qvb.0.2024.04.01.10.47.19 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 01 Apr 2024 10:47:19 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-126920-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=f1dwGYF9; arc=pass (i=1 spf=pass spfdomain=google.com dkim=pass dkdomain=google.com dmarc=pass fromdomain=google.com); spf=pass (google.com: domain of linux-kernel+bounces-126920-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-126920-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id EAFF11C2143B for ; Mon, 1 Apr 2024 17:47:18 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 691804D5A1; Mon, 1 Apr 2024 17:47:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="f1dwGYF9" Received: from mail-wm1-f46.google.com (mail-wm1-f46.google.com [209.85.128.46]) (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 0D1021DFE3 for ; Mon, 1 Apr 2024 17:47:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.46 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1711993632; cv=none; b=rnzVOWvu+9CjAoQPT24BNig9Qkk6x5A1qSuPvK7/wBBk/imXxLBBYRmqROavA3KTxyZfVAJ2a/Z+yzznJc8YJPuLEaGGEyPxv9d57I5oe8fEEYnYboLrzp0H6Cpzo/lAJHfRu7ScXXKzlKY0M3h8sgF7qoBSc5/JvcVp4c8Xx0E= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1711993632; c=relaxed/simple; bh=HK1u6SkkL43OAT84jN1D+VjNCICU3PY99BO7+1mDvhw=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=XTouJ+wmOXzkwwjlSYBdEyfVH4C+yxocp8sc7Joyf+QSa0NSljTHANHGGus7X+6OUcXQedxx9df9IdiBKK/vyS5n0OBqTjT+kfWZatpzUS/rjQGOituC6wfDJxZM8GP6C1I1xBepFZouy3LWeW8OxKDpCFHjDCo22E4/R0gzzHw= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=f1dwGYF9; arc=none smtp.client-ip=209.85.128.46 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=google.com Received: by mail-wm1-f46.google.com with SMTP id 5b1f17b1804b1-4156ae9db55so58785e9.1 for ; Mon, 01 Apr 2024 10:47:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1711993629; x=1712598429; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=HK1u6SkkL43OAT84jN1D+VjNCICU3PY99BO7+1mDvhw=; b=f1dwGYF9giyl0dLAX+jkYuSAeDvSNQXtxrFPIFPFxTnXR8aBSgpEZZG4GbmBCvUIh2 1JA1Gp3RorqXdJJmj8Dq0LQ5O/tSiwtp9y4nC3TQ6DODKeoKfg0FbGiVEuhdOq/ifUln tZ67Pp02BfPabrKGGvREmncO/SfbfoVoQKLQXTzxxtAFNLRpJi68jJWxg5OniFKMy9uP vbg4L2kN0NgJfj4CulwfpQ+fRhOgXxB71OipD+oNzniMFWMIOmPyCbRe29mc0Pg8aO+p Epy0YjKkMkcXz04wAPYdyHWzRG1Lvc8mf3f1MXacA9PVstUWb0vn5cARobTmWnrMUzac 043g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1711993629; x=1712598429; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=HK1u6SkkL43OAT84jN1D+VjNCICU3PY99BO7+1mDvhw=; b=e1MI/WraKpCdBHu8E1FStjBC31JeX8XCuqxdflsXKk81FSKFcKMMx3DQyd4lqNu+ES BMSsYMGLKs5mPajcjW1Qf7rAl6E0qKCTOM7ADl3Wk7AnbVzQKRnsmSWiIsit+QHZLhaV ZhS4ML5dupVgmKr9WubjqCOidY8l3kaklBSwnNe7L/wojoig5x/KfRUkNMlCbQWi9vWh 4NEVHlr0kMhpFQQbnXTCYAjq2DFZA4txIK9ci2zPyb8E96ju0/tm0x7IX4zlrNhsrh0W vc4H3MVHEL5GJaSdbvtBqakkgy+hesjpNHW/4H3D9MtvblmMDjvu9Y5IrqAaDW02Hg2x ZgiQ== X-Gm-Message-State: AOJu0YxYVltwp/ifKOQGBqbbL6zNvwYXVDC3hshkldOD4kSAPcwXP5Mi Cm5TRI7W79c47M+j+IQnCwtil/oowKBypfEajOKNpyCPYmagq6MYAxaSFYtnkC6yYLolcaXLwgE Z2yQWVTn2zGL/+YYi3SHcoJ2VBMVVqzWMti4= X-Received: by 2002:a05:600c:4f85:b0:415:666e:9431 with SMTP id n5-20020a05600c4f8500b00415666e9431mr156180wmq.6.1711993629277; Mon, 01 Apr 2024 10:47:09 -0700 (PDT) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20240331172652.14086-1-rdunlap@infradead.org> <20240331172652.14086-2-rdunlap@infradead.org> In-Reply-To: <20240331172652.14086-2-rdunlap@infradead.org> From: John Stultz Date: Mon, 1 Apr 2024 10:46:56 -0700 Message-ID: Subject: Re: [PATCH 1/6] time/timecounter: fix inline documentation To: Randy Dunlap Cc: linux-kernel@vger.kernel.org, Anna-Maria Behnsen , Frederic Weisbecker , Thomas Gleixner , Stephen Boyd , Ingo Molnar Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Sun, Mar 31, 2024 at 10:27=E2=80=AFAM Randy Dunlap wrote: > > Fix kernel-doc warnings, text punctuation, and a kernel-doc marker > (change '%' to '&' to indicate a struct). > > timecounter.h:72: warning: No description found for return value of 'cycl= ecounter_cyc2ns' > timecounter.h:85: warning: Function parameter or member 'tc' not describe= d in 'timecounter_adjtime' > timecounter.h:111: warning: No description found for return value of 'tim= ecounter_read' > timecounter.h:128: warning: No description found for return value of 'tim= ecounter_cyc2time' > > Signed-off-by: Randy Dunlap Acked-by: John Stultz