From 70c34af15bdeeec3bdf8f3a8fc8912080f38fb3c Mon Sep 17 00:00:00 2001 From: Nicolas Gallagher Date: Mon, 26 Nov 2012 09:27:11 -0800 Subject: [PATCH] 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. --- normalize.css | 143 +++++++++++++++++++++++++------------------------- 1 file changed, 71 insertions(+), 72 deletions(-) diff --git a/normalize.css b/normalize.css index 57b5d26..418cd11 100644 --- a/normalize.css +++ b/normalize.css @@ -4,8 +4,8 @@ HTML5 display definitions ========================================================================== */ -/* - * Corrects `block` display not defined in IE 8/9. +/** + * Correct `block` display not defined in IE 8/9. */ article, @@ -22,8 +22,8 @@ summary { display: block; } -/* - * Corrects `inline-block` display not defined in IE 8/9. +/** + * Correct `inline-block` display not defined in IE 8/9. */ audio, @@ -32,8 +32,8 @@ video { 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. */ @@ -42,8 +42,8 @@ audio:not([controls]) { height: 0; } -/* - * Addresses styling for `hidden` attribute not present in IE 8/9. +/** + * Address styling not present in IE 8/9. */ [hidden] { @@ -54,9 +54,9 @@ audio:not([controls]) { Base ========================================================================== */ -/* - * 1. Sets default font family to sans-serif. - * 2. Prevents iOS text size adjust after orientation change, without disabling +/** + * 1. Set default font family to sans-serif. + * 2. Prevent iOS text size adjust after orientation change, without disabling * user zoom. */ @@ -66,8 +66,8 @@ html { -ms-text-size-adjust: 100%; /* 2 */ } -/* - * Removes default margin. +/** + * Remove default margin. */ body { @@ -78,16 +78,16 @@ body { Links ========================================================================== */ -/* - * Addresses `outline` inconsistency between Chrome and other browsers. +/** + * Address `outline` inconsistency between Chrome and other browsers. */ a:focus { 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, @@ -99,25 +99,25 @@ a:hover { Typography ========================================================================== */ -/* - * Addresses `h1` font sizes within `section` and `article` in Firefox 4+, - * Safari 5, and Chrome. +/** + * Address variable `h1` font size within `section` and `article` contexts in + * Firefox 4+, Safari 5, and Chrome. */ h1 { 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] { 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, @@ -125,16 +125,16 @@ strong { font-weight: bold; } -/* - * Addresses styling not present in Safari 5 and Chrome. +/** + * Address styling not present in Safari 5 and Chrome. */ dfn { font-style: italic; } -/* - * Addresses styling not present in IE 8/9. +/** + * Address styling not present in IE 8/9. */ mark { @@ -142,9 +142,8 @@ mark { color: #000; } - -/* - * Corrects font family set oddly in Safari 5 and Chrome. +/** + * Correct font family set oddly in Safari 5 and Chrome. */ code, @@ -155,8 +154,8 @@ samp { font-size: 1em; } -/* - * Improves readability of pre-formatted text in all browsers. +/** + * Improve readability of pre-formatted text in all browsers. */ pre { @@ -165,24 +164,24 @@ pre { word-wrap: break-word; } -/* - * Sets consistent quote types. +/** + * Set consistent quote types. */ q { quotes: "\201C" "\201D" "\2018" "\2019"; } -/* - * Addresses inconsistent and variable font size in all browsers. +/** + * Address inconsistent and variable font size in all browsers. */ small { font-size: 80%; } -/* - * Prevents `sub` and `sup` affecting `line-height` in all browsers. +/** + * Prevent `sub` and `sup` affecting `line-height` in all browsers. */ sub, @@ -205,16 +204,16 @@ sub { Embedded content ========================================================================== */ -/* - * Removes border when inside `a` element in IE 8/9. +/** + * Remove border when inside `a` element in IE 8/9. */ img { border: 0; } -/* - * Corrects overflow displayed oddly in IE 9. +/** + * Correct overflow displayed oddly in IE 9. */ svg:not(:root) { @@ -225,8 +224,8 @@ svg:not(:root) { Figures ========================================================================== */ -/* - * Addresses margin not present in IE 8/9 and Safari 5. +/** + * Address margin not present in IE 8/9 and Safari 5. */ figure { @@ -237,7 +236,7 @@ figure { Forms ========================================================================== */ -/* +/** * Define consistent border, margin, and padding. */ @@ -247,8 +246,8 @@ fieldset { 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. */ @@ -257,10 +256,10 @@ legend { padding: 0; /* 2 */ } -/* - * 1. Corrects font family not being inherited in all browsers. - * 2. Corrects font size not being inherited in all browsers. - * 3. Addresses margins set differently in Firefox 4+, Safari 5, and Chrome +/** + * 1. Correct font family not being inherited in all browsers. + * 2. Correct font size not being inherited in all browsers. + * 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome. */ button, @@ -272,8 +271,8 @@ textarea { 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. */ @@ -282,11 +281,11 @@ input { line-height: normal; } -/* +/** * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` * and `video` controls. - * 2. Corrects inability to style clickable `input` types in iOS. - * 3. Improves usability and consistency of cursor style between image-type + * 2. Correct inability to style clickable `input` types in iOS. + * 3. Improve usability and consistency of cursor style between image-type * `input` and others. */ @@ -298,7 +297,7 @@ input[type="submit"] { cursor: pointer; /* 3 */ } -/* +/** * Re-set default cursor for disabled elements. */ @@ -307,9 +306,9 @@ input[disabled] { cursor: default; } -/* - * 1. Addresses box sizing set to `content-box` in IE 8/9. - * 2. Removes excess padding in IE 8/9. +/** + * 1. Address box sizing set to `content-box` in IE 8/9. + * 2. Remove excess padding in IE 8/9. */ input[type="checkbox"], @@ -318,9 +317,9 @@ input[type="radio"] { padding: 0; /* 2 */ } -/* - * 1. Addresses `appearance` set to `searchfield` in Safari 5 and Chrome. - * 2. Addresses `box-sizing` set to `border-box` in Safari 5 and Chrome +/** + * 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome. + * 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome * (include `-moz` to future-proof). */ @@ -331,8 +330,8 @@ input[type="search"] { 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. */ @@ -341,8 +340,8 @@ input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; } -/* - * Removes inner padding and border in Firefox 4+. +/** + * Remove inner padding and border in Firefox 4+. */ button::-moz-focus-inner, @@ -351,9 +350,9 @@ input::-moz-focus-inner { padding: 0; } -/* - * 1. Removes default vertical scrollbar in IE 8/9. - * 2. Improves readability and alignment in all browsers. +/** + * 1. Remove default vertical scrollbar in IE 8/9. + * 2. Improve readability and alignment in all browsers. */ textarea { @@ -365,7 +364,7 @@ textarea { Tables ========================================================================== */ -/* +/** * Remove most spacing between table cells. */