Linux-man Archive on lore.kernel.org
 help / color / Atom feed
* cfree
@ 2020-06-23 15:10 Jonny Grant
  2020-06-23 15:26 ` cfree Ponnuvel Palaniyappan
  2020-06-24  8:09 ` cfree Michael Kerrisk (man-pages)
  0 siblings, 2 replies; 5+ messages in thread
From: Jonny Grant @ 2020-06-23 15:10 UTC (permalink / raw)
  To: linux-man, Michael Kerrisk

Hello
Is it time to remove this old man page? it's two years since it was removed from glibc

2017-08-02: glibc 2.26 released

https://man7.org/linux/man-pages/man3/cfree.3.html

Thank you, Jonny

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

* Re: cfree
  2020-06-23 15:10 cfree Jonny Grant
@ 2020-06-23 15:26 ` Ponnuvel Palaniyappan
  2020-06-24  8:09 ` cfree Michael Kerrisk (man-pages)
  1 sibling, 0 replies; 5+ messages in thread
From: Ponnuvel Palaniyappan @ 2020-06-23 15:26 UTC (permalink / raw)
  To: Jonny Grant; +Cc: linux-man, Michael Kerrisk

In case it's deemed necessary to keep it, I think the sentence
"Starting with version 2.26, it has been removed from glibc." from the
DESCRIPTION section can be removed because:
    0. It's already been noted under VERSIONS
    1. DESCRIPTION is probably not the best place for this info in any case

Thanks,
Ponnuvel

On Tue, Jun 23, 2020 at 4:11 PM Jonny Grant <jg@jguk.org> wrote:
>
> Hello
> Is it time to remove this old man page? it's two years since it was removed from glibc
>
> 2017-08-02: glibc 2.26 released
>
> https://man7.org/linux/man-pages/man3/cfree.3.html
>
> Thank you, Jonny



-- 
Regards,
Ponnuvel P

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

* Re: cfree
  2020-06-23 15:10 cfree Jonny Grant
  2020-06-23 15:26 ` cfree Ponnuvel Palaniyappan
@ 2020-06-24  8:09 ` Michael Kerrisk (man-pages)
  2020-06-24 14:46   ` cfree Jonny Grant
  1 sibling, 1 reply; 5+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-06-24  8:09 UTC (permalink / raw)
  To: Jonny Grant; +Cc: linux-man

On Tue, 23 Jun 2020 at 17:10, Jonny Grant <jg@jguk.org> wrote:
>
> Hello
> Is it time to remove this old man page? it's two years since it was removed from glibc
>
> 2017-08-02: glibc 2.26 released
>
> https://man7.org/linux/man-pages/man3/cfree.3.html

The general philosophy is to maintain historical info in man-pages,
since new manual pages may be installed on an old system. Also, people
may need to look at old code, and understand what it does.

Thanks,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

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

* Re: cfree
  2020-06-24  8:09 ` cfree Michael Kerrisk (man-pages)
@ 2020-06-24 14:46   ` Jonny Grant
  2020-06-25  7:12     ` cfree Michael Kerrisk (man-pages)
  0 siblings, 1 reply; 5+ messages in thread
From: Jonny Grant @ 2020-06-24 14:46 UTC (permalink / raw)
  To: mtk.manpages; +Cc: linux-man



On 24/06/2020 09:09, Michael Kerrisk (man-pages) wrote:
> On Tue, 23 Jun 2020 at 17:10, Jonny Grant <jg@jguk.org> wrote:
>>
>> Hello
>> Is it time to remove this old man page? it's two years since it was removed from glibc
>>
>> 2017-08-02: glibc 2.26 released
>>
>> https://man7.org/linux/man-pages/man3/cfree.3.html
> 
> The general philosophy is to maintain historical info in man-pages,
> since new manual pages may be installed on an old system. Also, people
> may need to look at old code, and understand what it does.

Fair enough.

Although I would imagine anyone trying to use a function called cfree() would already understand they should use free()

Could the key point that cfree() is deprecated and removed be highlighted at the top of the man page?

I'd be temped to just have :-


DEPRECATED
       This function should not be used, it was non-standard and removed in glibc version 2.26 2017-08-02.

NAME
       cfree - free allocated memory


Regards
Jonny

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

* Re: cfree
  2020-06-24 14:46   ` cfree Jonny Grant
@ 2020-06-25  7:12     ` Michael Kerrisk (man-pages)
  0 siblings, 0 replies; 5+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-06-25  7:12 UTC (permalink / raw)
  To: Jonny Grant; +Cc: linux-man

On Wed, 24 Jun 2020 at 16:46, Jonny Grant <jg@jguk.org> wrote:
>
>
>
> On 24/06/2020 09:09, Michael Kerrisk (man-pages) wrote:
> > On Tue, 23 Jun 2020 at 17:10, Jonny Grant <jg@jguk.org> wrote:
> >>
> >> Hello
> >> Is it time to remove this old man page? it's two years since it was removed from glibc
> >>
> >> 2017-08-02: glibc 2.26 released
> >>
> >> https://man7.org/linux/man-pages/man3/cfree.3.html
> >
> > The general philosophy is to maintain historical info in man-pages,
> > since new manual pages may be installed on an old system. Also, people
> > may need to look at old code, and understand what it does.
>
> Fair enough.
>
> Although I would imagine anyone trying to use a function called cfree() would already understand they should use free()
>
> Could the key point that cfree() is deprecated and removed be highlighted at the top of the man page?
>
> I'd be temped to just have :-
>
>
> DEPRECATED
>        This function should not be used, it was non-standard and removed in glibc version 2.26 2017-08-02.
>
> NAME
>        cfree - free allocated memory

I think the existing first sentence of DESCRIPTION suffices.

Thanks,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

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

end of thread, back to index

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-06-23 15:10 cfree Jonny Grant
2020-06-23 15:26 ` cfree Ponnuvel Palaniyappan
2020-06-24  8:09 ` cfree Michael Kerrisk (man-pages)
2020-06-24 14:46   ` cfree Jonny Grant
2020-06-25  7:12     ` cfree Michael Kerrisk (man-pages)

Linux-man Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-man/0 linux-man/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-man linux-man/ https://lore.kernel.org/linux-man \
		linux-man@vger.kernel.org
	public-inbox-index linux-man

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-man


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git