Return-Path: Delivered-To: apmail-harmony-commits-archive@www.apache.org Received: (qmail 11157 invoked from network); 1 Mar 2007 14:23:14 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 1 Mar 2007 14:23:14 -0000 Received: (qmail 92354 invoked by uid 500); 1 Mar 2007 14:23:20 -0000 Delivered-To: apmail-harmony-commits-archive@harmony.apache.org Received: (qmail 92332 invoked by uid 500); 1 Mar 2007 14:23:20 -0000 Mailing-List: contact commits-help@harmony.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@harmony.apache.org Delivered-To: mailing list commits@harmony.apache.org Received: (qmail 92304 invoked by uid 99); 1 Mar 2007 14:23:20 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 01 Mar 2007 06:23:20 -0800 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO brutus.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 01 Mar 2007 06:23:11 -0800 Received: from brutus (localhost [127.0.0.1]) by brutus.apache.org (Postfix) with ESMTP id E49BE714290 for ; Thu, 1 Mar 2007 06:22:50 -0800 (PST) Message-ID: <12857185.1172758970931.JavaMail.jira@brutus> Date: Thu, 1 Mar 2007 06:22:50 -0800 (PST) From: "Svetlana Konovalova (JIRA)" To: commits@harmony.apache.org Subject: [jira] Commented: (HARMONY-3277) [drlvm]scarce comments in Thread manager external interface headers In-Reply-To: <18950118.1172758850875.JavaMail.jira@brutus> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org [ https://issues.apache.org/jira/browse/HARMONY-3277?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12476949 ] Svetlana Konovalova commented on HARMONY-3277: ---------------------------------------------- Here are suggestions on how to improve code comments of the Thread manager component so that Doxygen parses them correctly. GENERAL NOTE: I do respect the authors of all these headers and I do understand how proud they are to see their names in the comments! :) But, since it's the open source, I'd like to ask you to remove the authors' names from the files content. Thanks in advance and sorry about that! include/open/jthread.h - Add missing functions descriptions include/open/ti_thread.h - Add missing functions descriptions include/open/hycomp.h -Add detailed description -Add brief description [@file] - Add missing functions descriptions include/open/hythread.h -Add detailed description -Add brief description [@file] - Document functions include/open/hythread_ext.h -Add missing functions descriptions -Use appropriate formatting to make comments VISIBLE include/open/thread_helpers.h -Add detailed description - Document functions > [drlvm]scarce comments in Thread manager external interface headers > -------------------------------------------------------------------- > > Key: HARMONY-3277 > URL: https://issues.apache.org/jira/browse/HARMONY-3277 > Project: Harmony > Issue Type: Bug > Components: DRLVM > Reporter: Svetlana Konovalova > > Many files lack ample and well-formatted comments; need to get easily readable, complete and useful reference for DRLVM Interface Reference and Java class library reference; the code commenting BKMs (http://wiki.apache.org/harmony/Code_Commenting) can be useful. Specific suggestions on improving Doxygen output are below. -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online.