From dev-return-34192-apmail-directory-dev-archive=directory.apache.org@directory.apache.org Mon Jun 07 09:54:27 2010 Return-Path: Delivered-To: apmail-directory-dev-archive@www.apache.org Received: (qmail 71306 invoked from network); 7 Jun 2010 09:54:27 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 7 Jun 2010 09:54:27 -0000 Received: (qmail 62218 invoked by uid 500); 7 Jun 2010 09:54:27 -0000 Delivered-To: apmail-directory-dev-archive@directory.apache.org Received: (qmail 62167 invoked by uid 500); 7 Jun 2010 09:54:25 -0000 Mailing-List: contact dev-help@directory.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Apache Directory Developers List" Delivered-To: mailing list dev@directory.apache.org Received: (qmail 62145 invoked by uid 99); 7 Jun 2010 09:54:24 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 07 Jun 2010 09:54:24 +0000 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests=FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of elecharny@gmail.com designates 74.125.82.50 as permitted sender) Received: from [74.125.82.50] (HELO mail-ww0-f50.google.com) (74.125.82.50) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 07 Jun 2010 09:54:16 +0000 Received: by wwb17 with SMTP id 17so2807242wwb.37 for ; Mon, 07 Jun 2010 02:53:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:reply-to :user-agent:mime-version:to:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=TYADs9BMjLIxalb5YYUdPfIattDTAOpxBPmFlD+pMSU=; b=rxVjQSSfu2KTFzn8A0/vZvb00yQ0X0Hxh9Wcxm2QNtZFeBPo1sEWUa2djvgdLQ5pqG Pc3apIHvG/KkPIzxGRMN4/q+zTioOK98SU5mvOJrBpBxauN1LAdBudEs8z3PPZ11u2BA rl6bU/7qR31p7O4cA8iltcWNlBySawSaUhyvo= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:reply-to:user-agent:mime-version:to:subject :references:in-reply-to:content-type:content-transfer-encoding; b=ndzS42uGfhAf+N0Mg2PO1T6iWH2YMUhE3yk63u6xQ50J4cXztGKoIVRHKNoCj6lGKJ zgKIFBuX7e2G9QsHlJ49ATFghl6ebJiCiumz8Jx86Ow80Oq1CrM2PgZhrnm2oBmCvqqY KNb06ducy4uOBPxuAK/FsC4ObWJC3yemZtkqc= Received: by 10.227.145.14 with SMTP id b14mr13928519wbv.93.1275904436384; Mon, 07 Jun 2010 02:53:56 -0700 (PDT) Received: from emmanuel-lecharnys-MacBook-Pro.local (lon92-10-78-226-4-211.fbx.proxad.net [78.226.4.211]) by mx.google.com with ESMTPS id n31sm36525796wba.9.2010.06.07.02.53.55 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 07 Jun 2010 02:53:55 -0700 (PDT) Message-ID: <4C0CC1DF.5050607@gmail.com> Date: Mon, 07 Jun 2010 11:54:39 +0200 From: Emmanuel Lecharny Reply-To: elecharny@apache.org User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.1.9) Gecko/20100317 Thunderbird/3.0.4 MIME-Version: 1.0 To: Apache Directory Developers List Subject: Re: Javadocs fixing/creating References: <4C0CA7F7.5090204@otego.com> <4C0CAD0E.7050806@gmail.com> <4C0CB532.7000504@apache.org> In-Reply-To: <4C0CB532.7000504@apache.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit X-Virus-Checked: Checked by ClamAV on apache.org On 6/7/10 11:00 AM, Felix Knecht wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > >> Yes, sure, we can use this guy. But I would rather expect that we >> manually add the missing Javadoc, assuming that the generated reports >> tell us which ones are missing. >> >> My fear is that we consider a missing header as a non issue, as the mavn >> plugin will 'fix it'... >> >> Also it may create some burden as you will have some more file to commit. >> > We can add just the configuration to the pom.xml/build section like > > org.apache.maven.plugins > maven-javadoc-plugin > > <a > href="mailto:dev@directory.apache.org\">Apache Directory > Project</a> > author,param,return,throws > private > true > > > > This will not be executed when running a simple mvn clean install. One > still will need to run mvn javadoc:fix from CLI, but you don't need to > have all the relevant properties to set. > +1 for this. -- Regards, Cordialement, Emmanuel Lécharny www.nextury.com