Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:66282 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 16472 invoked from network); 27 Feb 2013 17:37:10 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 27 Feb 2013 17:37:10 -0000 Authentication-Results: pb1.pair.com header.from=steve@mrclay.org; sender-id=unknown Authentication-Results: pb1.pair.com smtp.mail=steve@mrclay.org; spf=permerror; sender-id=unknown Received-SPF: error (pb1.pair.com: domain mrclay.org from 50.22.11.19 cause and error) X-PHP-List-Original-Sender: steve@mrclay.org X-Host-Fingerprint: 50.22.11.19 bedford.accountservergroup.com Received: from [50.22.11.19] ([50.22.11.19:58811] helo=bedford.accountservergroup.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id B6/E2-33355-5444E215 for ; Wed, 27 Feb 2013 12:37:09 -0500 Received: from n128-227-189-85.xlate.ufl.edu ([128.227.189.85]:56334 helo=Distance-Ed-Sclay.local) by bedford.accountservergroup.com with esmtpsa (TLSv1:DHE-RSA-AES256-SHA:256) (Exim 4.80) (envelope-from ) id 1UAkwE-000Agx-Cl for internals@lists.php.net; Wed, 27 Feb 2013 11:37:06 -0600 Message-ID: <512E4441.7000401@mrclay.org> Date: Wed, 27 Feb 2013 12:37:05 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:17.0) Gecko/20130216 Thunderbird/17.0.3 MIME-Version: 1.0 To: PHP Internals References: <512E2161.8060000@mrclay.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - bedford.accountservergroup.com X-AntiAbuse: Original Domain - lists.php.net X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - mrclay.org Subject: Re: [PHP-DEV] I would like to write an RFC for the addition of an internal keyword From: steve@mrclay.org (Steve Clay) On 2/27/13 10:22 AM, Sebastian Krebs wrote: > 2013/2/27 Steve Clay >> phpDoc already supports "@access private" for items to be left out of >> public documentation. An IDE could be configured to have these items appear >> greyed or not to appear in autocomplete lists. > a) You misuse the "private visibility" here: "@access private" comes from > old PHP4-days, where the DocComment must know the visibility, because the > method itself didn't Sure, but phpDocumentor1 currently uses @access to control documentation output (the description doesn't mention access/visibility at all and "protected" does nothing). http://manual.phpdoc.org/HTMLSmartyConverter/default/phpDocumentor/tutorial_tags.access.pkg.html For phpDoc2 the OP should also check out these: http://www.phpdoc.org/docs/latest/for-users/phpdoc/tags/internal.html http://www.phpdoc.org/docs/latest/for-users/phpdoc/tags/api.html http://www.phpdoc.org/docs/latest/for-users/phpdoc/tags/ignore.html Steve Clay -- http://www.mrclay.org/