File comment and php doc comment block example

file-comment.php

    /**
     * Short description for file.
     *
     * Long description for file (if any)...
     *
     * PHP version 7
     *
     * LICENSE: This source file is subject to version 3.01 of the PHP license
     * that is available through the world-wide-web at the following URI:
     * http://www.php.net/license/3_01.txt.  If you did not receive a copy of
     * the PHP License and are unable to obtain it through the web, please
     * send a note to [email protected] so we can mail you a copy immediately.
     *
     * @category CategoryName
     *
     * @author    Original Author <[email protected]>
     * @copyright 1997-2005 The PHP Group
     * @license   http://www.php.net/license/3_01.txt  PHP License 3.01
     *
     * @version SVN: $Id$
     *
     * @see        http://pear.php.net/package/PackageName
     * @see        NetOther, Net_Sample::Net_Sample()
     * @since      File available since Release 1.2.0
     * @deprecated File deprecated in Release 2.0.0
     */