Paragraphs

== Name ==
=== Restrictions ===
Each paragraph name has the following restrictions:
* Must '''not''' contain any [[keywords]] (However, [[operators]] and [[literals]] are okay)
* Must '''not''' contain any [[punctuation]]
* Must begin with one non-[[whitespace]], non-[[literal]] character
* Must end with one non-whitespace character character

=== Freedoms ===
Each paragraph name also has the following freedoms:
* There is no hard limit on the length
* May have any whitespace character in them
* May contain [[operators]] that do not share a name with keywords
* May contain [[literals]], as long as they are not at the beginning of the name
* May contain apostrophes, as they are not [[punctuation]]
* Encoded in [[Wikipedia:UTF-8|UTF-8]]

=== Examples ===
Here are some examples of '''good''' paragraph names:
* {{codeblock|{{code|paragraph|how to fly}}}}
** Paragraph names can have spaces in them.

* {{codeblock|{{code|paragraph|something simple}}}}
** Paragraph names don't have to start with "how to".

* {{codeblock|{{code|paragraph|how to sing Applejack's Drinking Song}}}}
** Even though {{code|apostrophe|'}} is used to declare [[characters|character]] literals, it is used in the middle of a name, so it is okay.

* {{codeblock|{{code|paragraph|when to tell True Facts}}}}
** Even though {{code|literal|true}} is a literal, FiM++ is '''case-sensitive''', so {{code|not a literal|True}} is valid for paragraph naming.

* {{codeblock|{{code|paragraph|why Cloud 9 is the best hotel in Cloudsdale}}}}
** Even though {{code|literal|9}} is a number literal, it is not at the beginning of the paragraph name



Here are some examples of '''bad''' paragraph names:
* {{codeblock|{{code|paragraph|why {{codeerror|I learned}}}}}}
** {{code|keyword|I learned}} is a keyword, so this will not compile.

* {{codeblock|{{code|paragraph|how to {{codeerror|multiply}}}}}}
** "{{code|operator|multiply}}" is an operator, so this will not compile.

* {{codeblock|{{code|paragraph|about Applejack}}{{code|punctuation|,}}{{code|whitespace|&nbsp;}}{{codeerror|Rarity{{code|punctuation|,}}{{code|whitespace|&nbsp;}}{{code|keyword|and}}{{code|whitespace|&nbsp;}}Rainbow Dash}}}}
** compiler thinks "{{code|punctuation|,}}" is the end of the paragraph name "{{code|paragraph|about Applejack}}", and doesn't know what to do with the rest

* {{codeblock|{{code|paragraph|about Friendship}}{{code|whitespace|&nbsp;}}{{codeerror|and{{code|whitespace|&nbsp;}}Magic}}}}
** "{{code|keyword|and}}" 'is an operator and keyword.

* {{codeblock|{{code|literal|'s}}{{codeerror|arcasm}}{{code|literal|' }}{{codeerror|uses quotes}}}}
** {{code|apostrophe|'}} is used to start a character literal (such as {{code|literal|'a'}}, so the compiler sees this as an unclosed character literal.

* {{codeblock|{{code|literal|{{codeerror|99}}}}{{code|whitespace|&nbsp;}}{{codeerror|ways to get salted}}}}
** {{code|literal|99}} is ''always'' a literal, so it cannot be the beginning of a paragraph name. Additionally, the compiler doesn't know how to handle the rest of the line.