Home » Mailing list archives » linux-kernel » 2008 » May » 30

Re: [RFC] [PATCH 1/2] cpusets: restructure the function update_cpumask() and update_nodemask()

!MAILaRCHIVE_VOTE_RePLACE
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
[view in full thread]
From: Alan Cox <alan@...>
To: Paul Jackson <pj@...>
Cc: Randy Dunlap <rdunlap@...>, <miaox@...>, <akpm@...>, <linux-kernel@...>, <menage@...>
Subject: Re: [RFC] [PATCH 1/2] cpusets: restructure the function update_cpumask() and update_nodemask()
Date: Friday, May 30, 2008 - 5:46 am

> I have never seen or heard of a document using the "/**" kernel-doc

People wanting to generate things like function lists.


And I'll join that by stubbonly NAKing such an approach. We want
consistent clear formats for documentation extraction. Simply getting
people to use the kerneldoc format materially improves the documentation
quality, so please don't set bad examples ;)

Alan

--
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
Messages in current thread:
[RFC] [PATCH 1/2] cpusets: restructure the function update_c..., Miao Xie, (Thu May 29, 3:07 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Thu May 29, 4:16 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Miao Xie, (Thu May 29, 9:51 pm)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Thu May 29, 9:53 pm)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Miao Xie, (Thu May 29, 10:16 pm)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Thu May 29, 10:22 pm)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Randy Dunlap, (Thu May 29, 11:30 pm)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Thu May 29, 11:57 pm)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Randy Dunlap, (Fri May 30, 12:27 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Fri May 30, 2:25 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Randy Dunlap, (Fri May 30, 11:39 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Fri May 30, 12:07 pm)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Randy Dunlap, (Fri May 30, 11:32 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Alan Cox, (Fri May 30, 5:46 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Fri May 30, 11:22 am)
Re: [RFC] [PATCH 1/2] cpusets: restructure the function upda..., Paul Jackson, (Fri May 30, 1:24 am)