Commit 3a397795be1c0219a3a0d96082ee7d4eeddbfa7a | zig

author	Isaac Freund <mail@isaacfreund.com> 2020-05-02 23:28:44+02:00
committer	Isaac Freund <mail@isaacfreund.com> 2020-05-02 23:28:44+02:00
log	3a397795be1c0219a3a0d96082ee7d4eeddbfa7a
tree	ca153cf8828778b4ec8782b7d2ea3fa83af6c0b1
parent	03a7124543a52f7904090516e572b71b893c7ba2
signature	Commit is signed but in an unrecognized format.

1 files changed, 8 insertions(+), 0 deletions(-)

doc/langref.html.in+8

 @@ -9990,6 +9990,13 @@ coding style.
       conventions.
       </p>
       <p>
+      File names fall into two categories: types and namespaces. If the file
+      (implicity a struct) has top level fields, it should be named like any
+      other struct with fields using {#syntax#}TitleCase{#endsyntax#}. Otherwise,
+      it should use {#syntax#}snake_case{#endsyntax#}. Directory names should be
+      {#syntax#}snake_case{#endsyntax#}.
+      </p>
+      <p>
       These are general rules of thumb; if it makes sense to do something different,
       do what makes sense. For example, if there is an established convention such as
       {#syntax#}ENOENT{#endsyntax#}, follow the established convention.
 @@ -9998,6 +10005,7 @@ coding style.
       {#header_open|Examples#}
       {#code_begin|syntax#}
 const namespace_name = @import("dir_name/file_name.zig");
+const TypeName = @import("dir_name/TypeName.zig");
 var global_var: i32 = undefined;
 const const_name = 42;
 const primitive_type_alias = f32;