From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with archive (Exim 4.43) id 1HuB9i-00064t-GD for mharc-grub-devel@gnu.org; Fri, 01 Jun 2007 13:43:18 -0400 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HuB9g-00064N-Em for grub-devel@gnu.org; Fri, 01 Jun 2007 13:43:16 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HuB9e-00063a-QY for grub-devel@gnu.org; Fri, 01 Jun 2007 13:43:16 -0400 Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HuB9e-00063U-LJ for grub-devel@gnu.org; Fri, 01 Jun 2007 13:43:14 -0400 Received: from 245.red-80-24-127.staticip.rima-tde.net ([80.24.127.245] helo=manazas.ensanjose.net) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1HuB9d-0005TB-Ei for grub-devel@gnu.org; Fri, 01 Jun 2007 13:43:14 -0400 Received: from localhost (manazas.ensanjose.net [127.0.0.1]) by manazas.ensanjose.net (Postfix) with ESMTP id 1AA52D444D for ; Fri, 1 Jun 2007 19:43:06 +0200 (CEST) Received: from manazas.ensanjose.net ([127.0.0.1]) by localhost (manazas.ensanjose.net [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 02676-05 for ; Fri, 1 Jun 2007 19:43:06 +0200 (CEST) Received: from [192.168.1.5] (67.Red-83-34-180.dynamicIP.rima-tde.net [83.34.180.67]) by manazas.ensanjose.net (Postfix) with ESMTP id 37CB5D32AE for ; Fri, 1 Jun 2007 19:43:03 +0200 (CEST) Message-ID: <4665F505.3050703@raulete.net> Date: Wed, 06 Jun 2007 01:43:01 +0200 From: adrian15 User-Agent: Mozilla Thunderbird 1.0.7 (Windows/20050923) X-Accept-Language: en-us, en MIME-Version: 1.0 To: grub-devel@gnu.org Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-detected-kernel: Linux 2.4-2.6 Subject: gcs doubt #1 X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: The development of GRUB 2 List-Id: The development of GRUB 2 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 01 Jun 2007 17:43:16 -0000 In the GNU Coding Standards they say in: 5.2 Commenting Your Work Please put a comment on each function saying what the function does, what sorts of arguments it gets, and what the possible values of arguments mean and are used for. Is it ok that the search.c and test.c (commands/ folder) do not have any of these comments at all? You do not comment them at all? You comment them in another place? Maybe it's ok with the help description that it is set when you register a command? Maybe this is a bug and should be fixed? adrian15