Inherits from NSObject
Declared in GBCommentComponentsProvider.h
GBCommentComponentsProvider.m

Overview

Provides comment keywords and helpers for the rest of the application.

The main responsibility of the class is to determine if a string contains special section definition. In addition, they also return section parameters. This encapsulates keywords and sections handling and simplifies the rest of the application.

Tasks

Initialization & disposal

Lists definitions

  • orderedListRegex Returns the regex used for matching ordered lists with capture 1 containing lists indent and capture 2 string value.
  • orderedListMatchRegex Returns the regex used for testing whether a string matches an ordered lists.
  • unorderedListRegex Returns the regex used for matching unordered lists with capture 1 containing list indent and capture 2 string value.
  • unorderedListMatchRegex Returns the regex used for testing whether a string matches an unordered list.

Sections definitions

  • warningSectionRegex Returns the regex used for matching warning section with capture 1 containing description.
  • bugSectionRegex Returns the regex used for matching bug section with capture 1 containing description.
  • exampleSectionRegex Returns the regex used for matching example section with capture 1 containing example text.
  • exampleLinesRegex Returns the regex used for matching example lines with capture 1 containing example lines texts.

Method specific definitions

  • methodGroupRegex Returns the regex used for matching method groups with capture 1 containing section name.
  • argumentsMatchingRegex Returns the regex used for matching different method parameter descriptions within the paragraph.
  • nextArgumentRegex Returns the regex used for finding next method parameter description within the paragraph.
  • parameterDescriptionRegex Returns the regex used for matching method parameter description with capture 1 containing parameter name and capture 2 description.
  • returnDescriptionRegex Returns the regex used for matching method return description with capture 1 containing description.
  • exceptionDescriptionRegex Returns the regex used for matching method exception description with capture 1 containing exception name and capture 2 description.
  • crossReferenceRegex Returns the regex used for matching cross reference directive with capture 1 containing link.

Common definitions

  • remoteMemberCrossReferenceRegex Returns the regex used for matching (possible) remote member cross references with capture 1 containing object name and capture 2 member name.
  • localMemberCrossReferenceRegex Returns the regex used for matching (possible) local member cross reference with capture 1 containing member name.
  • objectCrossReferenceRegex Returns the regex used for matching (possible) object cross reference with capture 1 containing object name.
  • urlCrossReferenceRegex Returns the regex used for matching URL cross reference with caption 1 contining the URL itself.

Extension Methods

  • + provider Returns a new autoreleased GBCommentComponentsProvider instance.
  • orderedListRegex Returns the regex used for matching ordered lists with capture 1 containing lists indent and capture 2 string value.
  • orderedListMatchRegex Returns the regex used for testing whether a string matches an ordered lists.
  • unorderedListRegex Returns the regex used for matching unordered lists with capture 1 containing list indent and capture 2 string value.
  • unorderedListMatchRegex Returns the regex used for testing whether a string matches an unordered list.
  • warningSectionRegex Returns the regex used for matching warning section with capture 1 containing description.
  • bugSectionRegex Returns the regex used for matching bug section with capture 1 containing description.
  • exampleSectionRegex Returns the regex used for matching example section with capture 1 containing example text.
  • exampleLinesRegex Returns the regex used for matching example lines with capture 1 containing example lines texts.
  • methodGroupRegex Returns the regex used for matching method groups with capture 1 containing section name.
  • argumentsMatchingRegex Returns the regex used for matching different method parameter descriptions within the paragraph.
  • nextArgumentRegex Returns the regex used for finding next method parameter description within the paragraph.
  • parameterDescriptionRegex Returns the regex used for matching method parameter description with capture 1 containing parameter name and capture 2 description.
  • returnDescriptionRegex Returns the regex used for matching method return description with capture 1 containing description.
  • exceptionDescriptionRegex Returns the regex used for matching method exception description with capture 1 containing exception name and capture 2 description.
  • crossReferenceRegex Returns the regex used for matching cross reference directive with capture 1 containing link.
  • remoteMemberCrossReferenceRegex Returns the regex used for matching (possible) remote member cross references with capture 1 containing object name and capture 2 member name.
  • localMemberCrossReferenceRegex Returns the regex used for matching (possible) local member cross reference with capture 1 containing member name.
  • objectCrossReferenceRegex Returns the regex used for matching (possible) object cross reference with capture 1 containing object name.
  • urlCrossReferenceRegex Returns the regex used for matching URL cross reference with caption 1 contining the URL itself.

Class Methods

provider

Returns a new autoreleased GBCommentComponentsProvider instance.

+ (id)provider

Declared In

GBCommentComponentsProvider.h

Properties

argumentsMatchingRegex

Returns the regex used for matching different method parameter descriptions within the paragraph.

@property (readonly) NSString *argumentsMatchingRegex

Declared In

GBCommentComponentsProvider.h

bugSectionRegex

Returns the regex used for matching bug section with capture 1 containing description.

@property (readonly) NSString *bugSectionRegex

Declared In

GBCommentComponentsProvider.h

crossReferenceRegex

Returns the regex used for matching cross reference directive with capture 1 containing link.

@property (readonly) NSString *crossReferenceRegex

Declared In

GBCommentComponentsProvider.h

exampleLinesRegex

Returns the regex used for matching example lines with capture 1 containing example lines texts.

@property (readonly) NSString *exampleLinesRegex

Declared In

GBCommentComponentsProvider.h

exampleSectionRegex

Returns the regex used for matching example section with capture 1 containing example text.

@property (readonly) NSString *exampleSectionRegex

Declared In

GBCommentComponentsProvider.h

exceptionDescriptionRegex

Returns the regex used for matching method exception description with capture 1 containing exception name and capture 2 description.

@property (readonly) NSString *exceptionDescriptionRegex

Declared In

GBCommentComponentsProvider.h

localMemberCrossReferenceRegex

Returns the regex used for matching (possible) local member cross reference with capture 1 containing member name.

@property (readonly) NSString *localMemberCrossReferenceRegex

Declared In

GBCommentComponentsProvider.h

methodGroupRegex

Returns the regex used for matching method groups with capture 1 containing section name.

@property (readonly) NSString *methodGroupRegex

Declared In

GBCommentComponentsProvider.h

nextArgumentRegex

Returns the regex used for finding next method parameter description within the paragraph.

@property (readonly) NSString *nextArgumentRegex

Declared In

GBCommentComponentsProvider.h

objectCrossReferenceRegex

Returns the regex used for matching (possible) object cross reference with capture 1 containing object name.

@property (readonly) NSString *objectCrossReferenceRegex

Declared In

GBCommentComponentsProvider.h

orderedListMatchRegex

Returns the regex used for testing whether a string matches an ordered lists.

@property (readonly) NSString *orderedListMatchRegex

Declared In

GBCommentComponentsProvider.h

orderedListRegex

Returns the regex used for matching ordered lists with capture 1 containing lists indent and capture 2 string value.

@property (readonly) NSString *orderedListRegex

Declared In

GBCommentComponentsProvider.h

parameterDescriptionRegex

Returns the regex used for matching method parameter description with capture 1 containing parameter name and capture 2 description.

@property (readonly) NSString *parameterDescriptionRegex

Declared In

GBCommentComponentsProvider.h

remoteMemberCrossReferenceRegex

Returns the regex used for matching (possible) remote member cross references with capture 1 containing object name and capture 2 member name.

@property (readonly) NSString *remoteMemberCrossReferenceRegex

Declared In

GBCommentComponentsProvider.h

returnDescriptionRegex

Returns the regex used for matching method return description with capture 1 containing description.

@property (readonly) NSString *returnDescriptionRegex

Declared In

GBCommentComponentsProvider.h

unorderedListMatchRegex

Returns the regex used for testing whether a string matches an unordered list.

@property (readonly) NSString *unorderedListMatchRegex

Declared In

GBCommentComponentsProvider.h

unorderedListRegex

Returns the regex used for matching unordered lists with capture 1 containing list indent and capture 2 string value.

@property (readonly) NSString *unorderedListRegex

Declared In

GBCommentComponentsProvider.h

urlCrossReferenceRegex

Returns the regex used for matching URL cross reference with caption 1 contining the URL itself.

@property (readonly) NSString *urlCrossReferenceRegex

Declared In

GBCommentComponentsProvider.h

warningSectionRegex

Returns the regex used for matching warning section with capture 1 containing description.

@property (readonly) NSString *warningSectionRegex

Declared In

GBCommentComponentsProvider.h