Skip to content

Commit 70c34af

Browse files
necolasnecolas
committed
Language and comment style
* Make consistent use of tense in code comments. * Update the comment style to match a more common convention. * Remove an unintentional newline.
1 parent f29e03a commit 70c34af

File tree

1 file changed

+71
-72
lines changed

1 file changed

+71
-72
lines changed

‎normalize.css‎

Lines changed: 71 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@
44
HTML5 display definitions
55
========================================================================== */
66

7-
/*
8-
* Corrects `block` display not defined in IE 8/9.
7+
/**
8+
* Correct `block` display not defined in IE 8/9.
99
*/
1010

1111
article,
@@ -22,8 +22,8 @@ summary {
2222
display: block;
2323
}
2424

25-
/*
26-
* Corrects `inline-block` display not defined in IE 8/9.
25+
/**
26+
* Correct `inline-block` display not defined in IE 8/9.
2727
*/
2828

2929
audio,
@@ -32,8 +32,8 @@ video {
3232
display: inline-block;
3333
}
3434

35-
/*
36-
* Prevents modern browsers from displaying `audio` without controls.
35+
/**
36+
* Prevent modern browsers from displaying `audio` without controls.
3737
* Remove excess height in iOS 5 devices.
3838
*/
3939

@@ -42,8 +42,8 @@ audio:not([controls]) {
4242
height: 0;
4343
}
4444

45-
/*
46-
* Addresses styling for `hidden` attribute not present in IE 8/9.
45+
/**
46+
* Address styling not present in IE 8/9.
4747
*/
4848

4949
[hidden] {
@@ -54,9 +54,9 @@ audio:not([controls]) {
5454
Base
5555
========================================================================== */
5656

57-
/*
58-
* 1. Sets default font family to sans-serif.
59-
* 2. Prevents iOS text size adjust after orientation change, without disabling
57+
/**
58+
* 1. Set default font family to sans-serif.
59+
* 2. Prevent iOS text size adjust after orientation change, without disabling
6060
* user zoom.
6161
*/
6262

@@ -66,8 +66,8 @@ html {
6666
-ms-text-size-adjust: 100%; /* 2 */
6767
}
6868

69-
/*
70-
* Removes default margin.
69+
/**
70+
* Remove default margin.
7171
*/
7272

7373
body {
@@ -78,16 +78,16 @@ body {
7878
Links
7979
========================================================================== */
8080

81-
/*
82-
* Addresses `outline` inconsistency between Chrome and other browsers.
81+
/**
82+
* Address `outline` inconsistency between Chrome and other browsers.
8383
*/
8484

8585
a:focus {
8686
outline: thin dotted;
8787
}
8888

89-
/*
90-
* Improves readability when focused and also mouse hovered in all browsers.
89+
/**
90+
* Improve readability when focused and also mouse hovered in all browsers.
9191
*/
9292

9393
a:active,
@@ -99,52 +99,51 @@ a:hover {
9999
Typography
100100
========================================================================== */
101101

102-
/*
103-
* Addresses `h1` font sizes within `section` and `article` in Firefox 4+,
104-
* Safari 5, and Chrome.
102+
/**
103+
* Address variable `h1` font size within `section` and `article` contexts in
104+
* Firefox 4+, Safari 5, and Chrome.
105105
*/
106106

107107
h1 {
108108
font-size: 2em;
109109
}
110110

111-
/*
112-
* Addresses styling not present in IE 8/9, Safari 5, and Chrome.
111+
/**
112+
* Address styling not present in IE 8/9, Safari 5, and Chrome.
113113
*/
114114

115115
abbr[title] {
116116
border-bottom: 1px dotted;
117117
}
118118

119-
/*
120-
* Addresses style set to `bolder` in Firefox 4+, Safari 5, and Chrome.
119+
/**
120+
* Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome.
121121
*/
122122

123123
b,
124124
strong {
125125
font-weight: bold;
126126
}
127127

128-
/*
129-
* Addresses styling not present in Safari 5 and Chrome.
128+
/**
129+
* Address styling not present in Safari 5 and Chrome.
130130
*/
131131

132132
dfn {
133133
font-style: italic;
134134
}
135135

136-
/*
137-
* Addresses styling not present in IE 8/9.
136+
/**
137+
* Address styling not present in IE 8/9.
138138
*/
139139

140140
mark {
141141
background: #ff0;
142142
color: #000;
143143
}
144144

145-
146-
/*
147-
* Corrects font family set oddly in Safari 5 and Chrome.
145+
/**
146+
* Correct font family set oddly in Safari 5 and Chrome.
148147
*/
149148

150149
code,
@@ -155,8 +154,8 @@ samp {
155154
font-size: 1em;
156155
}
157156

158-
/*
159-
* Improves readability of pre-formatted text in all browsers.
157+
/**
158+
* Improve readability of pre-formatted text in all browsers.
160159
*/
161160

162161
pre {
@@ -165,24 +164,24 @@ pre {
165164
word-wrap: break-word;
166165
}
167166

168-
/*
169-
* Sets consistent quote types.
167+
/**
168+
* Set consistent quote types.
170169
*/
171170

172171
q {
173172
quotes: "\201C" "\201D" "\2018" "\2019";
174173
}
175174

176-
/*
177-
* Addresses inconsistent and variable font size in all browsers.
175+
/**
176+
* Address inconsistent and variable font size in all browsers.
178177
*/
179178

180179
small {
181180
font-size: 80%;
182181
}
183182

184-
/*
185-
* Prevents `sub` and `sup` affecting `line-height` in all browsers.
183+
/**
184+
* Prevent `sub` and `sup` affecting `line-height` in all browsers.
186185
*/
187186

188187
sub,
@@ -205,16 +204,16 @@ sub {
205204
Embedded content
206205
========================================================================== */
207206

208-
/*
209-
* Removes border when inside `a` element in IE 8/9.
207+
/**
208+
* Remove border when inside `a` element in IE 8/9.
210209
*/
211210

212211
img {
213212
border: 0;
214213
}
215214

216-
/*
217-
* Corrects overflow displayed oddly in IE 9.
215+
/**
216+
* Correct overflow displayed oddly in IE 9.
218217
*/
219218

220219
svg:not(:root) {
@@ -225,8 +224,8 @@ svg:not(:root) {
225224
Figures
226225
========================================================================== */
227226

228-
/*
229-
* Addresses margin not present in IE 8/9 and Safari 5.
227+
/**
228+
* Address margin not present in IE 8/9 and Safari 5.
230229
*/
231230

232231
figure {
@@ -237,7 +236,7 @@ figure {
237236
Forms
238237
========================================================================== */
239238

240-
/*
239+
/**
241240
* Define consistent border, margin, and padding.
242241
*/
243242

@@ -247,8 +246,8 @@ fieldset {
247246
padding: 0.35em 0.625em 0.75em;
248247
}
249248

250-
/*
251-
* 1. Corrects color not being inherited in IE 8/9.
249+
/**
250+
* 1. Correct `color` not being inherited in IE 8/9.
252251
* 2. Remove padding so people aren't caught out if they zero out fieldsets.
253252
*/
254253

@@ -257,10 +256,10 @@ legend {
257256
padding: 0; /* 2 */
258257
}
259258

260-
/*
261-
* 1. Corrects font family not being inherited in all browsers.
262-
* 2. Corrects font size not being inherited in all browsers.
263-
* 3. Addresses margins set differently in Firefox 4+, Safari 5, and Chrome
259+
/**
260+
* 1. Correct font family not being inherited in all browsers.
261+
* 2. Correct font size not being inherited in all browsers.
262+
* 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome.
264263
*/
265264

266265
button,
@@ -272,8 +271,8 @@ textarea {
272271
margin: 0; /* 3 */
273272
}
274273

275-
/*
276-
* Addresses Firefox 4+ setting `line-height` on `input` using `!important` in
274+
/**
275+
* Address Firefox 4+ setting `line-height` on `input` using `!important` in
277276
* the UA stylesheet.
278277
*/
279278

@@ -282,11 +281,11 @@ input {
282281
line-height: normal;
283282
}
284283

285-
/*
284+
/**
286285
* 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
287286
* and `video` controls.
288-
* 2. Corrects inability to style clickable `input` types in iOS.
289-
* 3. Improves usability and consistency of cursor style between image-type
287+
* 2. Correct inability to style clickable `input` types in iOS.
288+
* 3. Improve usability and consistency of cursor style between image-type
290289
* `input` and others.
291290
*/
292291

@@ -298,7 +297,7 @@ input[type="submit"] {
298297
cursor: pointer; /* 3 */
299298
}
300299

301-
/*
300+
/**
302301
* Re-set default cursor for disabled elements.
303302
*/
304303

@@ -307,9 +306,9 @@ input[disabled] {
307306
cursor: default;
308307
}
309308

310-
/*
311-
* 1. Addresses box sizing set to `content-box` in IE 8/9.
312-
* 2. Removes excess padding in IE 8/9.
309+
/**
310+
* 1. Address box sizing set to `content-box` in IE 8/9.
311+
* 2. Remove excess padding in IE 8/9.
313312
*/
314313

315314
input[type="checkbox"],
@@ -318,9 +317,9 @@ input[type="radio"] {
318317
padding: 0; /* 2 */
319318
}
320319

321-
/*
322-
* 1. Addresses `appearance` set to `searchfield` in Safari 5 and Chrome.
323-
* 2. Addresses `box-sizing` set to `border-box` in Safari 5 and Chrome
320+
/**
321+
* 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome.
322+
* 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome
324323
* (include `-moz` to future-proof).
325324
*/
326325

@@ -331,8 +330,8 @@ input[type="search"] {
331330
box-sizing: content-box;
332331
}
333332

334-
/*
335-
* Removes inner padding and search cancel button in Safari 5 and Chrome
333+
/**
334+
* Remove inner padding and search cancel button in Safari 5 and Chrome
336335
* on OS X.
337336
*/
338337

@@ -341,8 +340,8 @@ input[type="search"]::-webkit-search-decoration {
341340
-webkit-appearance: none;
342341
}
343342

344-
/*
345-
* Removes inner padding and border in Firefox 4+.
343+
/**
344+
* Remove inner padding and border in Firefox 4+.
346345
*/
347346

348347
button::-moz-focus-inner,
@@ -351,9 +350,9 @@ input::-moz-focus-inner {
351350
padding: 0;
352351
}
353352

354-
/*
355-
* 1. Removes default vertical scrollbar in IE 8/9.
356-
* 2. Improves readability and alignment in all browsers.
353+
/**
354+
* 1. Remove default vertical scrollbar in IE 8/9.
355+
* 2. Improve readability and alignment in all browsers.
357356
*/
358357

359358
textarea {
@@ -365,7 +364,7 @@ textarea {
365364
Tables
366365
========================================================================== */
367366

368-
/*
367+
/**
369368
* Remove most spacing between table cells.
370369
*/
371370

0 commit comments

Comments
 (0)