public inbox for linux-man@vger.kernel.org
 help / color / mirror / Atom feed
* No NOTES section in snprintf(3)
@ 2023-09-27 11:19 Дилян Палаузов
  2023-09-27 12:35 ` Alejandro Colomar
  0 siblings, 1 reply; 2+ messages in thread
From: Дилян Палаузов @ 2023-09-27 11:19 UTC (permalink / raw)
  To: linux-man

Hello,

the manual page of snprintf() — 
https://man7.org/linux/man-pages/man3/snprintf.3.html contains:

DESCRIPTION …  See NOTES.
RETURN VALUE … (See also below under NOTES.)

There are no “NOTES” in that manual page.

The manual page likely means CAVEATS instead of NOTES (or vice versa), 
as there is a CAVEATS section.


Moreover https://man7.org/mtk/contact.html contains “NOTE: to make a 
man-pages bug report, email linux-man@vger.kernel.org.”  where 
“man-pages bug report” is a hyperlink to 
https://www.kernel.org/doc/man-pages/reporting_bugs.html .

That page https://www.kernel.org/doc/man-pages/reporting_bugs.html does 
not exist.

Kind regards
   Dilyan

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: No NOTES section in snprintf(3)
  2023-09-27 11:19 No NOTES section in snprintf(3) Дилян Палаузов
@ 2023-09-27 12:35 ` Alejandro Colomar
  0 siblings, 0 replies; 2+ messages in thread
From: Alejandro Colomar @ 2023-09-27 12:35 UTC (permalink / raw)
  To: Дилян Палаузов
  Cc: linux-man

[-- Attachment #1: Type: text/plain, Size: 1469 bytes --]

Hi Дилян,

On Wed, Sep 27, 2023 at 01:19:11PM +0200, Дилян Палаузов wrote:
> Hello,
> 
> the manual page of snprintf() —
> https://man7.org/linux/man-pages/man3/snprintf.3.html contains:
> 
> DESCRIPTION …  See NOTES.
> RETURN VALUE … (See also below under NOTES.)
> 
> There are no “NOTES” in that manual page.
> 
> The manual page likely means CAVEATS instead of NOTES (or vice versa), as
> there is a CAVEATS section.

Yep, the section was renamed to CAVEATS in
4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")

I've fixed that:
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/?h=contrib>

Thanks for the report!

> 
> 
> Moreover https://man7.org/mtk/contact.html contains “NOTE: to make a
> man-pages bug report, email linux-man@vger.kernel.org.”  where “man-pages
> bug report” is a hyperlink to
> https://www.kernel.org/doc/man-pages/reporting_bugs.html .
> 
> That page https://www.kernel.org/doc/man-pages/reporting_bugs.html does not
> exist.

Please report the broken link to Michael Kerrisk <mtk@man7.org>, and ask
him to link to
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING>
instead.

Do _not_ CC linux-man@ in that mail, please.

I've been reducing duplicate stuff in the website and keeping the
information only in the git repository.

Thanks,
Alex

> 
> Kind regards
>   Dilyan

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2023-09-27 12:35 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-09-27 11:19 No NOTES section in snprintf(3) Дилян Палаузов
2023-09-27 12:35 ` Alejandro Colomar

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox