PHP_CodeSniffer
[ class tree: PHP_CodeSniffer ] [ index: PHP_CodeSniffer ] [ all elements ]

Class: PEAR_Sniffs_Commenting_FileCommentSniff

Source Location: /PHP_CodeSniffer-0.7.0/CodeSniffer/Standards/PEAR/Sniffs/Commenting/FileCommentSniff.php

Class Overview


Parses and verifies the doc comments for files.


Author(s):

Version:

  • Release: 0.7.0

Copyright:

  • 2006 Squiz Pty Ltd (ABN 77 084 670 600)

Variables

Methods


Child classes:

PEAR_Sniffs_Commenting_ClassCommentSniff
Parses and verifies the doc comments for classes.

Inherited Variables

Inherited Methods


Class Details

[line 45]
Parses and verifies the doc comments for files.

Verifies that :

  • A doc comment exists.
  • There is a blank newline after the short description.
  • There is a blank newline between the long and short description.
  • There is a blank newline between the long description and tags.
  • A PHP version is specified.
  • Check the order of the tags.
  • Check the indentation of each tag.
  • Check required and optional tags and the format of their content.



[ Top ]


Class Variables

$commentParser =  null

[line 53]

The header comment parser for the current file.
  • Access: protected

Type:   PHP_CodeSniffer_Comment_Parser_ClassCommentParser


[ Top ]

$currentFile =  null

[line 60]

The current PHP_CodeSniffer_File object we are processing.
  • Access: protected



[ Top ]



Method Detail

getIndentation   [line 410]

void getIndentation( string $tagName, PHP_CodeSniffer_CommentParser_DocElement $tagElement)

Get the indentation information of each tag.
  • Access: protected

Parameters:

string   $tagName   —  The name of the doc comment element.
PHP_CodeSniffer_CommentParser_DocElement   $tagElement   —  The doc comment element.

[ Top ]

process   [line 84]

void process( PHP_CodeSniffer_File $phpcsFile, int $stackPtr)

Processes this test, when one of its tokens is encountered.
  • Access: public

Overridden in child classes as:

PEAR_Sniffs_Commenting_ClassCommentSniff::process()
Processes this test, when one of its tokens is encountered.

Parameters:

PHP_CodeSniffer_File   $phpcsFile   —  The file being scanned.
int   $stackPtr   —  The position of the current token in the stack passed in $tokens.

[ Top ]

processAuthors   [line 507]

void processAuthors( int $commentStart)

Process the author tag(s) that this header comment has.

This function is different from other _process functions as $authors is an array of SingleElements, so we work out the errorPos for each element separately

  • Access: protected

Parameters:

int   $commentStart   —  The position in the stack where the comment started..

[ Top ]

processCategory   [line 434]

void processCategory( int $errorPos)

Process the category tag.
  • Access: protected

Parameters:

int   $errorPos   —  The line number where the error occurs.

[ Top ]

processCopyright   [line 541]

void processCopyright( int $errorPos)

Process the copyright tag.
  • Access: protected

Parameters:

int   $errorPos   —  The line number where the error occurs.

[ Top ]

processLicense   [line 581]

void processLicense( int $errorPos)

Process the license tag.
  • Access: protected

Parameters:

int   $errorPos   —  The line number where the error occurs.

[ Top ]

processPackage   [line 468]

void processPackage( int $errorPos)

Process the package tag.
  • Access: protected

Parameters:

int   $errorPos   —  The line number where the error occurs.

[ Top ]

processTags   [line 229]

void processTags( int $commentStart, int $commentEnd)

Processes each required or optional tag.
  • Access: protected

Parameters:

int   $commentStart   —  The position in the stack where the comment started.
int   $commentEnd   —  The position in the stack where the comment ended.

[ Top ]

processVersion   [line 603]

void processVersion( int $errorPos)

Process the version tag.
  • Access: protected

Overridden in child classes as:

PEAR_Sniffs_Commenting_ClassCommentSniff::processVersion()
Process the version tag.

Parameters:

int   $errorPos   —  The line number where the error occurs.

[ Top ]

register   [line 68]

array register( )

Returns an array of tokens this test wants to listen for.
  • Access: public

Overridden in child classes as:

PEAR_Sniffs_Commenting_ClassCommentSniff::register()
Returns an array of tokens this test wants to listen for.

[ Top ]


Documentation generated on Mon, 11 Mar 2019 15:06:34 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.