From 19c436ab20ff1749455ef1606b0884387cb21f5e Mon Sep 17 00:00:00 2001 From: Dominik Picheta Date: Wed, 15 Mar 2017 21:48:46 +0100 Subject: Update nep1 to show type keyword on its own line --- doc/nep1.rst | 28 ++++++++++++++++------------ 1 file changed, 16 insertions(+), 12 deletions(-) (limited to 'doc') diff --git a/doc/nep1.rst b/doc/nep1.rst index 11fd58dd4..a2d7ab3f3 100644 --- a/doc/nep1.rst +++ b/doc/nep1.rst @@ -81,7 +81,8 @@ changed in the future. var aVariable = "Meep" - type FooBar = object + type + FooBar = object For constants coming from a C/C++ wrapper, ALL_UPPERCASE are allowed, but ugly. (Why shout CONSTANT? Constants do no harm, variables do!) @@ -99,25 +100,28 @@ changed in the future. - Exception and Error types should have the "Error" suffix. .. code-block:: nim - type UnluckyError = object of Exception + type + UnluckyError = object of Exception - Unless marked with the `{.pure.}` pragma, members of enums should have an identifying prefix, such as an abbreviation of the enum's name. .. code-block:: nim - type PathComponent = enum - pcDir - pcLinkToDir - pcFile - pcLinkToFile + type + PathComponent = enum + pcDir + pcLinkToDir + pcFile + pcLinkToFile - Non-pure enum values should use camelCase whereas pure enum values should use PascalCase. .. code-block:: nim - type PathComponent {.pure.} = enum - Dir - LinkToDir - File - LinkToFile + type + PathComponent {.pure.} = enum + Dir + LinkToDir + File + LinkToFile - In the age of HTTP, HTML, FTP, TCP, IP, UTF, WWW it is foolish to pretend these are somewhat special words requiring all uppercase. Instead tread them as what they are: Real words. So it's ``parseUrl`` rather than ``parseURL``, ``checkHttpHeader`` instead of ``checkHTTPHeader`` etc. -- cgit 1.4.1-2-gfad0