RFC Docblock

[SerafimArts]

About

Add docblock syntax.

• Discussion: [RFC] GraphQL Schema Definition Language (SDL) graphql/graphql-spec#90

Example

# This is description
# of type Something
type Something {
    # This is optional description of "helloWorld" field
    helloWorld: String
}

[SerafimArts]

Very hard to implement it

Problem

hoaproject/Compiler#74

Hotfix

Add preg_replace with (?:(?:\A|\n)\h*#[^\n]*)+\n\h*\b regexp and add preporcessing to transpile (transform) the comments skipped section into a format for docstring #11

Affects

Error will contain message like "Unexpected token T_MULTILINE_STRING on line XXX" if there is an error related to parsing the source code, but requires "Unexpected token T_DOCBLOCK on line XXX".

[SerafimArts]

Not relevant