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.
This commit is contained in:
Nicolas Gallagher 2012-11-26 09:27:11 -08:00
parent f29e03ae8f
commit 70c34af15b

143
normalize.css vendored
View File

@ -4,8 +4,8 @@
HTML5 display definitions HTML5 display definitions
========================================================================== */ ========================================================================== */
/* /**
* Corrects `block` display not defined in IE 8/9. * Correct `block` display not defined in IE 8/9.
*/ */
article, article,
@ -22,8 +22,8 @@ summary {
display: block; display: block;
} }
/* /**
* Corrects `inline-block` display not defined in IE 8/9. * Correct `inline-block` display not defined in IE 8/9.
*/ */
audio, audio,
@ -32,8 +32,8 @@ video {
display: inline-block; display: inline-block;
} }
/* /**
* Prevents modern browsers from displaying `audio` without controls. * Prevent modern browsers from displaying `audio` without controls.
* Remove excess height in iOS 5 devices. * Remove excess height in iOS 5 devices.
*/ */
@ -42,8 +42,8 @@ audio:not([controls]) {
height: 0; height: 0;
} }
/* /**
* Addresses styling for `hidden` attribute not present in IE 8/9. * Address styling not present in IE 8/9.
*/ */
[hidden] { [hidden] {
@ -54,9 +54,9 @@ audio:not([controls]) {
Base Base
========================================================================== */ ========================================================================== */
/* /**
* 1. Sets default font family to sans-serif. * 1. Set default font family to sans-serif.
* 2. Prevents iOS text size adjust after orientation change, without disabling * 2. Prevent iOS text size adjust after orientation change, without disabling
* user zoom. * user zoom.
*/ */
@ -66,8 +66,8 @@ html {
-ms-text-size-adjust: 100%; /* 2 */ -ms-text-size-adjust: 100%; /* 2 */
} }
/* /**
* Removes default margin. * Remove default margin.
*/ */
body { body {
@ -78,16 +78,16 @@ body {
Links Links
========================================================================== */ ========================================================================== */
/* /**
* Addresses `outline` inconsistency between Chrome and other browsers. * Address `outline` inconsistency between Chrome and other browsers.
*/ */
a:focus { a:focus {
outline: thin dotted; outline: thin dotted;
} }
/* /**
* Improves readability when focused and also mouse hovered in all browsers. * Improve readability when focused and also mouse hovered in all browsers.
*/ */
a:active, a:active,
@ -99,25 +99,25 @@ a:hover {
Typography Typography
========================================================================== */ ========================================================================== */
/* /**
* Addresses `h1` font sizes within `section` and `article` in Firefox 4+, * Address variable `h1` font size within `section` and `article` contexts in
* Safari 5, and Chrome. * Firefox 4+, Safari 5, and Chrome.
*/ */
h1 { h1 {
font-size: 2em; font-size: 2em;
} }
/* /**
* Addresses styling not present in IE 8/9, Safari 5, and Chrome. * Address styling not present in IE 8/9, Safari 5, and Chrome.
*/ */
abbr[title] { abbr[title] {
border-bottom: 1px dotted; border-bottom: 1px dotted;
} }
/* /**
* Addresses style set to `bolder` in Firefox 4+, Safari 5, and Chrome. * Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome.
*/ */
b, b,
@ -125,16 +125,16 @@ strong {
font-weight: bold; font-weight: bold;
} }
/* /**
* Addresses styling not present in Safari 5 and Chrome. * Address styling not present in Safari 5 and Chrome.
*/ */
dfn { dfn {
font-style: italic; font-style: italic;
} }
/* /**
* Addresses styling not present in IE 8/9. * Address styling not present in IE 8/9.
*/ */
mark { mark {
@ -142,9 +142,8 @@ mark {
color: #000; color: #000;
} }
/**
/* * Correct font family set oddly in Safari 5 and Chrome.
* Corrects font family set oddly in Safari 5 and Chrome.
*/ */
code, code,
@ -155,8 +154,8 @@ samp {
font-size: 1em; font-size: 1em;
} }
/* /**
* Improves readability of pre-formatted text in all browsers. * Improve readability of pre-formatted text in all browsers.
*/ */
pre { pre {
@ -165,24 +164,24 @@ pre {
word-wrap: break-word; word-wrap: break-word;
} }
/* /**
* Sets consistent quote types. * Set consistent quote types.
*/ */
q { q {
quotes: "\201C" "\201D" "\2018" "\2019"; quotes: "\201C" "\201D" "\2018" "\2019";
} }
/* /**
* Addresses inconsistent and variable font size in all browsers. * Address inconsistent and variable font size in all browsers.
*/ */
small { small {
font-size: 80%; font-size: 80%;
} }
/* /**
* Prevents `sub` and `sup` affecting `line-height` in all browsers. * Prevent `sub` and `sup` affecting `line-height` in all browsers.
*/ */
sub, sub,
@ -205,16 +204,16 @@ sub {
Embedded content Embedded content
========================================================================== */ ========================================================================== */
/* /**
* Removes border when inside `a` element in IE 8/9. * Remove border when inside `a` element in IE 8/9.
*/ */
img { img {
border: 0; border: 0;
} }
/* /**
* Corrects overflow displayed oddly in IE 9. * Correct overflow displayed oddly in IE 9.
*/ */
svg:not(:root) { svg:not(:root) {
@ -225,8 +224,8 @@ svg:not(:root) {
Figures Figures
========================================================================== */ ========================================================================== */
/* /**
* Addresses margin not present in IE 8/9 and Safari 5. * Address margin not present in IE 8/9 and Safari 5.
*/ */
figure { figure {
@ -237,7 +236,7 @@ figure {
Forms Forms
========================================================================== */ ========================================================================== */
/* /**
* Define consistent border, margin, and padding. * Define consistent border, margin, and padding.
*/ */
@ -247,8 +246,8 @@ fieldset {
padding: 0.35em 0.625em 0.75em; padding: 0.35em 0.625em 0.75em;
} }
/* /**
* 1. Corrects color not being inherited in IE 8/9. * 1. Correct `color` not being inherited in IE 8/9.
* 2. Remove padding so people aren't caught out if they zero out fieldsets. * 2. Remove padding so people aren't caught out if they zero out fieldsets.
*/ */
@ -257,10 +256,10 @@ legend {
padding: 0; /* 2 */ padding: 0; /* 2 */
} }
/* /**
* 1. Corrects font family not being inherited in all browsers. * 1. Correct font family not being inherited in all browsers.
* 2. Corrects font size not being inherited in all browsers. * 2. Correct font size not being inherited in all browsers.
* 3. Addresses margins set differently in Firefox 4+, Safari 5, and Chrome * 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome.
*/ */
button, button,
@ -272,8 +271,8 @@ textarea {
margin: 0; /* 3 */ margin: 0; /* 3 */
} }
/* /**
* Addresses Firefox 4+ setting `line-height` on `input` using `!important` in * Address Firefox 4+ setting `line-height` on `input` using `!important` in
* the UA stylesheet. * the UA stylesheet.
*/ */
@ -282,11 +281,11 @@ input {
line-height: normal; line-height: normal;
} }
/* /**
* 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
* and `video` controls. * and `video` controls.
* 2. Corrects inability to style clickable `input` types in iOS. * 2. Correct inability to style clickable `input` types in iOS.
* 3. Improves usability and consistency of cursor style between image-type * 3. Improve usability and consistency of cursor style between image-type
* `input` and others. * `input` and others.
*/ */
@ -298,7 +297,7 @@ input[type="submit"] {
cursor: pointer; /* 3 */ cursor: pointer; /* 3 */
} }
/* /**
* Re-set default cursor for disabled elements. * Re-set default cursor for disabled elements.
*/ */
@ -307,9 +306,9 @@ input[disabled] {
cursor: default; cursor: default;
} }
/* /**
* 1. Addresses box sizing set to `content-box` in IE 8/9. * 1. Address box sizing set to `content-box` in IE 8/9.
* 2. Removes excess padding in IE 8/9. * 2. Remove excess padding in IE 8/9.
*/ */
input[type="checkbox"], input[type="checkbox"],
@ -318,9 +317,9 @@ input[type="radio"] {
padding: 0; /* 2 */ padding: 0; /* 2 */
} }
/* /**
* 1. Addresses `appearance` set to `searchfield` in Safari 5 and Chrome. * 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome.
* 2. Addresses `box-sizing` set to `border-box` in Safari 5 and Chrome * 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome
* (include `-moz` to future-proof). * (include `-moz` to future-proof).
*/ */
@ -331,8 +330,8 @@ input[type="search"] {
box-sizing: content-box; box-sizing: content-box;
} }
/* /**
* Removes inner padding and search cancel button in Safari 5 and Chrome * Remove inner padding and search cancel button in Safari 5 and Chrome
* on OS X. * on OS X.
*/ */
@ -341,8 +340,8 @@ input[type="search"]::-webkit-search-decoration {
-webkit-appearance: none; -webkit-appearance: none;
} }
/* /**
* Removes inner padding and border in Firefox 4+. * Remove inner padding and border in Firefox 4+.
*/ */
button::-moz-focus-inner, button::-moz-focus-inner,
@ -351,9 +350,9 @@ input::-moz-focus-inner {
padding: 0; padding: 0;
} }
/* /**
* 1. Removes default vertical scrollbar in IE 8/9. * 1. Remove default vertical scrollbar in IE 8/9.
* 2. Improves readability and alignment in all browsers. * 2. Improve readability and alignment in all browsers.
*/ */
textarea { textarea {
@ -365,7 +364,7 @@ textarea {
Tables Tables
========================================================================== */ ========================================================================== */
/* /**
* Remove most spacing between table cells. * Remove most spacing between table cells.
*/ */