minor doc changes

Signed-off-by: Ceki Gulcu <ceki@qos.ch>
This commit is contained in:
Ceki Gulcu 2022-01-02 23:30:41 +01:00
parent 62a265d3c5
commit 0e8713e1eb
5 changed files with 524 additions and 33 deletions

View File

@ -0,0 +1,471 @@
html {
padding:0px;
margin:0px;
}
body {
background-color: #fff;
font-family: Verdana, Arial, SunSans-Regular, Sans-Serif;
color: #000;
padding:0px;
margin:0px;
font-size: small;
}
#job img { border:1px solid #DDDDDD; }
#job:hover img { border:1px solid #8888EE; }
p, h2, pre {
margin: 0px;
padding-top: 5px;
padding-bottom: 5px;
/*padding-left: 1ex;*/
/*padding: 5px 20px 5px 20px; */
}
p.rm {
padding-top: 0px;
padding-bottom: 0px;
}
a {
color: #4183c4;
/*font-size: smaller;*/
background-color:transparent;
text-decoration: none;
}
#container {
margin-left: auto;
margin-right: auto;
max-width: 90em;
}
#content a:hover {
text-decoration: underline;
}
.source {
border-top: 1px solid #DDDDDD;
border-bottom: 1px solid #DDDDDD;
background:#f5f5f5;
font-family: Courier, "MS Courier New", Prestige, Everson Monocourrier, monospace;
padding-bottom: 0.5ex;
padding-top: 0.5ex;
padding-left: 1ex;
margin-left: 0ex;
margin-top: 0.5ex;
margin-bottom: 0.5ex;
white-space: pre;
-webkit-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
}
pre {
background-color:transparent;
font-family: Monaco, Andale Mono, Courier New, monospace;
}
.alignright {
margin-top: 0;
text-align: right;
font-size: 10px;
}
h1, h2, h3, h4 {
color: #333;
}
h2 {
padding-top:10px;
background-color: transparent;
font-weight: 900;
font-size: x-large;
}
h3 {
padding-top: 5px;
background-color: transparent;
font-weight: normal;
font-size: large;
}
h4 {
padding-top:5px;
background-color: transparent;
font-weight: normal;
font-size: large;
}
table.footer {
width: 100%;
}
.footer {
text-align: right;
color: #564b47;
background-color: #fff;
padding:0px;
border-top: 1px solid #CCCCCC;
margin-top: 3ex;
font-size: smaller;
}
strong {
/*font-size: 13px;*/
font-weight: bold;
}
/* positioning-layers static and absolute */
#breadcrumbs {
padding: 3px 10px 3px 10px;
margin: 0px 4px 0px 4px;
font-size: small;
border: 1px solid #CCCCCC;
/*border-bottom: 1px solid #aaa;
/* background-color: #ccc; lime;
border-color: #663300;*/
background-color: #ffd0a0;
/*max-width: 77em;*/
}
#left {
//position: fixed;
//left: 0px;
float: left;
width: 15em;
margin: 4px 0px 0px 4px;
padding: 0px;
font-size: 80%;
background-color: #ffffff;
}
.menuGroup {
border: 1px solid #cccccc;
background-color: #fff8e8;
color: #564b47;
border: 1px solid #cccccc;
-webkit-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
}
.menuGroup a {
display: block;
width: 95.5%;
margin: 0px;
padding: 2px;
border: solid 1px #fff8e8;
color: #0066cc;
text-decoration: none;
}
.menuGroup a:hover {
border: solid 1px #FFFFFF;
background-color: #3333CC;
color: #ffffff;
-webkit-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
}
.pub {
text-align: center;
}
#left .pub a:hover {
background-color: transparent;
border: solid 0px #FFFFFF;
}
#left a:hover, #right a:hover {
border: solid 1px #FFFFFF;
background-color: #3333CC;
color: #ffffff;
-webkit-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
}
#left div.jobadd {
font-size: 160%;
color: #fff;
margin: 0px;
padding: 1ex;
text-align: center;
-webkit-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
background-image: -ms-linear-gradient(bottom right, #FFBB55 0%, #FF8822 100%);
background-image: -moz-linear-gradient(bottom right, #FFBB55 0%, #FF8822 100%);
background-image: -o-linear-gradient(bottom right, #FFBB55 0%, #FF8822 100%);
background-image: -webkit-gradient(linear, right bottom, left top, color-stop(0, #FFBB55), color-stop(1, #FF8822));
background-image: -webkit-linear-gradient(bottom right, #FFBB55 0%, #FF8822 100%);
background-image: linear-gradient(to top left, #FFBB55 0%, #FF8822 100%);
}
#left div.jobadd a, div.jobadd a:hover {
background-color: transparent;
color: #fff;
border-width: 0px;
}
#right {
//position: absolute;
//right: 0px;
float: right;
width: 14em;
color: #564b47;
margin: 4px 4px 0px 0px;
padding: 0px;
background-color: #ffffff;
border: 1px solid #cccccc;
font-size: 80%;
}
p.menu_header {
margin: 0px;
padding: 2px;
font-weight: normal;
background-color: #ffd0a0;
border-top: solid 1px #CCCCCC;
border-bottom: solid 1px #CCCCCC;
}
#content {
margin: 0px 12em 0px 16em;
padding: 0px 2em 0px 0px;
background-color: #ffffff;
}
#content img {
border:none;
margin-left: auto;
margin-right: auto;
display: block;
}
.author {
text-align: left;
font-weight: bold;
}
.definition {
padding-left: 5px;
padding-right: 5px;
margin: 5px 50px 5px 50px;
text-align: justify;
background-color: #E6E64C;
}
.deftitle {
font-weight: bold;
}
.big {
font-size: 130%;
}
.green {
color: green;
}
.blue {
color: blue;
}
.red {
color: red;
}
.bold {
font-weight: bold;
}
.redBold {
color: red;
font-weight: bold;
}
.greenBold {
color: green;
font-weight: bold;
}
code {
font-family: Courier, monospace;
}
.option {
border: 1px solid black;
font-family: Arial, sans-serif;
}
.highlight {
width: 18em;
float: right;
display: inline;
font-size: 110%;
border: 2px solid #711;
-webkit-border-radius: 4px;
-moz-border-radius: 4px;
border-radius: 4px;
background:#FFE0B0;
padding-top: 1ex;
padding-left: 1ex;
padding-right: 1ex;
padding-bottom: 1ex;
margin-left: 1em;
margin-right: 0em;
margin-bottom: 1ex;
}
.survey {
font-weight: bolder;
font-size: larger;
border:1px solid #cccccc;
background:#FFCC99;
padding-left: 1ex;
padding-right: 1ex;
}
/* ========== body table ============ */
table.bodyTable {
padding: 0px;
margin-left: -2px;
margin-right: -2px;
}
table.bodyTable th {
color: white;
background-color: #bbb;
font-weight: bold;
}
table.bodyTable td {
padding-left: 0.5ex;
padding-bottom: 0.5ex;
}
/* apply to tr elements of tables which are both bodytable and dark */
table[class="bodyTable dark"] tr {
background-color: #ddd;
}
/* apply to tr elements of tables which are both bodytable and dark */
table[class="bodyTable properties"] tr {
vertical-align: top;
}
table.bodyTable tr.a {
background-color: #ddd;
}
table.bodyTable tr.b {
background-color: #eee;
}
table.bodyTable tr.alt {
background-color: #eee;
}
.striped tr:nth-child(odd) td {
background-color: #f9f9f9;
}
.striped td {
background-color: #f0f0f0;
}
/* EOF =============== bodyTable =============== */
.label {
padding: 1px 3px 2px;
font-size: 9.75px;
font-weight: bold;
color: #ffffff;
text-transform: uppercase;
white-space: nowrap;
background-color: #bfbfbf;
-webkit-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
}
.label.notice {
background-color: #62cffc;
}
/* ------------------------------------ */
dt.separator {
border-top: 2px solid #888888;
color: #333;
padding-bottom: 1ex;
padding-top: 1ex;
font-weight: bold;
}
dd {
margin-top: 1ex;
margin-bottom: 1ex;
}
/* ------------------------------------ */
.anchor { display:none; }
h1 .anchor:before {content:url(anchor24.png);}
h2 .anchor:before {content:url(anchor20.png);}
h3 .anchor:before {content:url(anchor16.png);}
h4 .anchor:before {content:url(anchor12.png);}
td .anchor:before {content:url(anchor12.png);}
dt .anchor:before {content:url(anchor12.png);}
h1:hover .anchor { margin-left: -24px; }
h2:hover .anchor { margin-left: -20px; }
h3:hover .anchor { margin-left: -16px; }
h4:hover .anchor { margin-left: -12px; }
td:hover .anchor { margin-left: -12px; }
dt:hover .anchor { margin-left: -12px; }
h1:hover .anchor,
h2:hover .anchor,
h3:hover .anchor,
h4:hover .anchor,
td:hover .anchor,
dt:hover .anchor {
display: inline-block;
text-decoration: none;
}
/* ------------ twitter button ------- */
.twitter_button {
vertical-align: text-bottom;
padding-top: 3px;
padding-right: 16px;
float: left;
height: 18px;
text-shadow: 0 1px 0 rgba(255, 255, 255, 0.5);
white-space: nowrap;
background-color: white;
background-image: -moz-linear-gradient(top, #ffffff, #dedede);
background-image: -webkit-gradient(linear, left top, left bottom, from(#ffffff), to(#dedede));
background-image: -ms-linear-gradient(top, #ffffff, #dedede);
background-image: linear-gradient(top, #ffffff, #dedede);
background-image: -o-linear-gradient(top, #ffffff, #dedede);
border: #CCC solid 1px;
-webkit-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
}

View File

@ -210,6 +210,22 @@ span.asGroovy:hover {
}
/* ------------------------------------ */
dt.separator {
border-top: 2px solid #888888;
color: #333;
padding-bottom: 1ex;
padding-top: 1ex;
font-weight: bold;
}
/*
dd {
margin-top: 1ex;
margin-bottom: 1ex;
}
*/
/* ------------------------------------ */
.anchor { display:none; }

View File

@ -202,7 +202,7 @@
<h2>Generalities</h2>
<dl>
<dt class="doAnchor" name="what_is">What is SLF4J?</dt>
<dt class="doAnchor separator" name="what_is">What is SLF4J?</dt>
<dd>
<p>SLF4J is a simple facade for logging systems allowing the
end-user to plug-in the desired logging system at deployment
@ -210,7 +210,7 @@
</p>
</dd>
<dt class="doAnchor" name="when">When should SLF4J be used?</dt>
<dt class="doAnchor separator" name="when">When should SLF4J be used?</dt>
<dd>
<p>In short, libraries and other embedded components should
@ -255,7 +255,7 @@
</dd>
<dt class="doAnchor" name="yet_another_facade">Is SLF4J yet
<dt class="doAnchor separator" name="yet_another_facade">Is SLF4J yet
another logging facade?</dt>
<dd>
@ -269,7 +269,7 @@
</dd>
<dt class="doAnchor" name="why_new_project">If SLF4J fixes JCL,
<dt class="doAnchor separator" name="why_new_project">If SLF4J fixes JCL,
then why wasn't the fix made in JCL instead of creating a new
project?
</dt>
@ -300,7 +300,7 @@
</dd>
<dt class="doAnchor" name="need_to_recompile">When using SLF4J, do
<dt class="doAnchor separator" name="need_to_recompile">When using SLF4J, do
I have to recompile my application to switch to a different
logging system?
</dt>
@ -323,7 +323,7 @@
</dd>
<dt class="doAnchor" name="requirements">What are SLF4J's
<dt class="doAnchor separator" name="requirements">What are SLF4J's
requirements?
</dt>
@ -371,7 +371,7 @@
</dd>
<!-- ==================================================== -->
<dt class="doAnchor" name="changesInVersion200">
<dt class="doAnchor separator" name="changesInVersion200">
What has changed in SLF4J version 2.0.0?
</dt>
@ -454,7 +454,7 @@
<!-- ==================================================== -->
<!-- entry has order dependees -->
<dt class="doAnchor" name="compatibility">Are SLF4J versions
<dt class="doAnchor separator" name="compatibility">Are SLF4J versions
backward compatible?
</dt>
@ -491,7 +491,7 @@
<!-- ==================================================== -->
<dt class="doAnchor" name="IllegalAccessError">I am getting
<dt class="doAnchor separator" name="IllegalAccessError">I am getting
<code>IllegalAccessError</code> exceptions when using SLF4J. Why
is that?
</dt>
@ -543,7 +543,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
<!-- ==================================================== -->
<dt class="doAnchor" name="license">Why is SLF4J licensed under
<dt class="doAnchor separator" name="license">Why is SLF4J licensed under
X11 type license instead of the Apache Software License?
</dt>
@ -561,7 +561,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
</dd>
<!-- ==================================================== -->
<dt class="doAnchor" name="where_is_binding">Where can I get a
<dt class="doAnchor separator" name="where_is_binding">Where can I get a
particular SLF4J provider/binding?
</dt>
@ -589,7 +589,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
</dd>
<dt class="doAnchor" name="configure_logging">Should my library
<dt class="doAnchor separator" name="configure_logging">Should my library
attempt to configure logging?
</dt>
@ -610,7 +610,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
<!-- ======================================================= -->
<dt class="doAnchor" name="optional_dependency">In order to reduce
<dt class="doAnchor separator" name="optional_dependency">In order to reduce
the number of dependencies of our software we would like to make
SLF4J an optional dependency. Is that a good idea?
</dt>
@ -702,7 +702,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
<!-- ======================================================= -->
<dt class="doAnchor" name="maven2">What about Maven transitive
<dt class="doAnchor separator" name="maven2">What about Maven transitive
dependencies?
</dt>
@ -749,7 +749,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
</dd>
<!-- ====================================================== -->
<dt class="doAnchor" name="excludingJCL">How do I exclude
<dt class="doAnchor separator" name="excludingJCL">How do I exclude
commons-logging as a Maven dependency?
</dt>
@ -872,7 +872,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
</dd>
<dt class="doAnchor" name="jmpsModuleNames">What are the JPMS
<dt class="doAnchor separator" name="jmpsModuleNames">What are the JPMS
module names of the various SLF4J artificats?
</dt>
@ -928,7 +928,7 @@ org.slf4j.impl.StaticLoggerBinder.SINGLETON from class org.slf4j.LoggerFactory
<dl>
<dt class="doAnchor" name="string_or_object">Why don't the
<dt class="doAnchor separator" name="string_or_object">Why don't the
printing methods in the Logger interface accept message of type
Object, but only messages of type String?
</dt>
@ -985,7 +985,7 @@ debug(String msg, Throwable t);</pre>
<!-- ====================================================== -->
<dt class="doAnchor" name="exception_message">Can I log an
<dt class="doAnchor separator" name="exception_message">Can I log an
exception without an accompanying message?
</dt>
@ -1043,7 +1043,7 @@ debug(String msg, Throwable t);</pre>
<!-- ====================================================== -->
<dt class="doAnchor" name="logging_performance">What is the
<dt class="doAnchor separator" name="logging_performance">What is the
fastest way of (not) logging?
</dt>
@ -1190,7 +1190,7 @@ logger.debug("The new entry is {}.", entry);</pre>
<!-- ================================================= -->
<dt class="doAnchor" name="string_contents">How can I log the
<dt class="doAnchor separator" name="string_contents">How can I log the
string contents of a single (possibly complex) object?</dt>
<dd>
@ -1220,7 +1220,7 @@ logger.debug("The new entry is {}.", entry);</pre>
<!-- ================================================= -->
<dt class="doAnchor" name="fatal">Why doesn't the
<dt class="doAnchor separator" name="fatal">Why doesn't the
<code>org.slf4j.Logger</code> interface have methods for the FATAL
level?
</dt>
@ -1282,7 +1282,7 @@ class Bar {
</dd>
<!-- ======================================================= -->
<dt class="doAnchor" name="trace">Why was the TRACE level
<dt class="doAnchor separator" name="trace">Why was the TRACE level
introduced only in SLF4J version 1.4.0?</dt>
<dd>
@ -1327,7 +1327,7 @@ class Bar {
</dd>
<!-- ================================================= -->
<dt class="doAnchor" name="i18n">Does the SLF4J logging API
<dt class="doAnchor separator" name="i18n">Does the SLF4J logging API
support I18N (internationalization)?
</dt>
@ -1343,7 +1343,7 @@ class Bar {
<!-- ================================================= -->
<dt class="doAnchor" name="noLoggerFactory">Is it possible to
<dt class="doAnchor separator" name="noLoggerFactory">Is it possible to
retrieve loggers without going through the static methods in
<code>LoggerFactory</code>?
</dt>
@ -1376,7 +1376,7 @@ class Bar {
<!-- ================================================= -->
<dt class="doAnchor" name="paramException">In the presence of an
<dt class="doAnchor separator" name="paramException">In the presence of an
exception/throwable, is it possible to parameterize a logging
statement?</dt>
@ -1420,7 +1420,7 @@ try {
<!-- ============================================================= -->
<dt class="doAnchor" name="slf4j_compatible">How do I make my
<dt class="doAnchor separator" name="slf4j_compatible">How do I make my
logging framework SLF4J compatible?
</dt>
@ -1479,7 +1479,7 @@ try {
<!-- ============================================================= -->
<dt class="doAnchor" name="marker_interface">How can my logging
<dt class="doAnchor separator" name="marker_interface">How can my logging
system add support for the <code>Marker</code> interface?
</dt>
<dd>
@ -1513,7 +1513,7 @@ try {
<!-- ============================================================= -->
<dt class="doAnchor" name="version_checks">How does SLF4J's
<dt class="doAnchor separator" name="version_checks">How does SLF4J's
version check mechanism work?
</dt>
@ -1570,7 +1570,7 @@ try {
<dl>
<!-- ============================================================= -->
<dt class="doAnchor" name="declared_static">Should Logger members
<dt class="doAnchor separator" name="declared_static">Should Logger members
of a class be declared as static?
</dt>
<dd>
@ -1735,7 +1735,7 @@ try {
<!-- ============================================================= -->
<dl>
<dt class="doAnchor" name="declaration_pattern">Is there a
<dt class="doAnchor separator" name="declaration_pattern">Is there a
recommended idiom for declaring a logger in a class?
</dt>

View File

@ -28,7 +28,8 @@
<div id="content">
<h1>Comments on the log4shell(CVE-2021-44228) vulnerability</h1>
<!-- h1 takes too much space -->
<h2>Comments on the log4shell(CVE-2021-44228) vulnerability</h2>
<h3>Preamble</h3>
@ -273,7 +274,7 @@
<td>Total</td>
<td>API </td>
<td>-</td>
<td>45,174 </td>
<td>75,431 </td>
<td>100%</td>
</tr>
@ -337,6 +338,9 @@
href="https://github.com/lunasec-io/lunasec/blob/master/docs/blog/2021-12-09-log4j-zero-day.md">lunasec-io/lunasec</a></li>
<li><a href="https://snyk.io/blog/when-is-a-cve-not-a-cve/">Security in context: When is a CVE not a CVE?</a></li>
<li><a href="https://dev.to/yawaramin/the-human-toll-of-log4j-maintenance-35ap">The
human toll of log4j maintenance</a></li>
</ol>
</div>
</body>

View File

@ -22,7 +22,7 @@
function addBlockDetected() {
jQuery("#right").append('<p class="big">If using SLF4J saves you hours of work, please whitelist this site in your \
add blocker.</p>');
ad blocker.</p>');
}
document.write(' <script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-7471410671306824" \