@@ -708,7 +708,7 @@ Earmuffs (a pair of asterisk bookending var names) is a naming convention in
708
708
many LISPs used to denote _special vars_. Most commonly in Clojure this is
709
709
used to denote _dynamic_ vars, i.e. ones that can change depending on
710
710
dynamic scope. The earmuffs act as a warning that "here be dragons"
711
- and to never assume the state of the var. Remember, this is a _convention_ , not a
711
+ and to never assume the state of the var. Remember, this is a convention , not a
712
712
rule.
713
713
714
714
Core Clojure examples include `\*out*` and `\*in*` which represent the standard in
@@ -761,7 +761,7 @@ asynchronous code from the code base.
761
761
762
762
== `<symbol>?` - Predicate Suffix
763
763
764
- Putting `?` at the end of a symbol is a _naming convention_ common across
764
+ Putting `?` at the end of a symbol is a naming convention common across
765
765
many languages that support special characters in their symbol names. It is
766
766
used to indicate that the thing is a predicate, i.e. that it _poses a question_.
767
767
For example, imagine using an API that dealt with buffer manipulation:
@@ -783,7 +783,7 @@ symbol naming in Clojure allows us to express intent more symbolically.
783
783
(buffers/empty? my-buffer)
784
784
false
785
785
----
786
- This is simply a recommended _convention_ , not a requirement.
786
+ This is simply a recommended convention , not a requirement.
787
787
788
788
* https://github.com/bbatsov/clojure-style-guide#naming[Clojure Style Guide]
789
789
@@ -808,7 +808,7 @@ user=> @my-stateful-thing
808
808
1
809
809
----
810
810
811
- This is simply a recommended _convention_ and not a requirement.
811
+ This is simply a recommended convention and not a requirement.
812
812
813
813
Note that the exclamation mark is often pronounced as bang.
814
814
@@ -817,7 +817,7 @@ Note that the exclamation mark is often pronounced as bang.
817
817
== `_` - Unused argument
818
818
819
819
When you see the underscore character used as function arguments or in a `let` binding,
820
- `_ ` is a common _naming convention_ to indicate you won't be using this argument.
820
+ `pass:[_] ` is a common naming convention to indicate you won't be using this argument.
821
821
822
822
This is an example using the `add-watch` function that can be used to add
823
823
callback style behaviour when atoms change value. Imagine, given an atom, we
0 commit comments