Re: [slf4j-user] SLF4J library using an image

2011-08-18 Thread Ceki Gülcü
I'd like to thank you all for your feedback and contributions on these 
illustrations.

--
Ceki
___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-15 Thread Ceki Gülcü


Quite a coincidence that your DNS entry was disabled today. Anyway, 
thank you for the updated illustration. After placing all stacks on a 
single line as you have suggested (see [1]), I've integrated the 
resulting illustration into manual.html.


[1] http://goo.gl/Uie0H

On 15/08/2011 9:01 PM, Erik van Oosten wrote:


Of course this must exactly be the day that no-ip took my DNS entry down
(see
http://day-to-day-stuff.blogspot.com/2011/08/version-99-dns-off-line.html).

Reposted here:
http://www.grons.nl/concrete-bindings-eoo.odg
http://www.grons.nl/concrete-bindings-eoo.png

BTW, I don't care so much for arrows or not. Its just that they are
usually not used in this software stacks.

Kind regards,
Erik.


Op 15-08-11 10:15, Erik van Oosten schreef:

Hello Ceki,

I've added some color and removed the adaption layer from the
'unbound' case. What do you think?

http://no-commons-logging.zapto.org/concrete-bindings-eoo.odg
http://no-commons-logging.zapto.org/concrete-bindings-eoo.png

I think that displaying these stacks horizontally would improve the
presentation somewhat more. It emphasizes what a mess you have when
you include commons-logging in the mix :)

Regards,
Erik.







--
QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, 
is looking to hire talented software developers. For further details, 
see http://logback.qos.ch/job.html

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-15 Thread Erik van Oosten


Of course this must exactly be the day that no-ip took my DNS entry down 
(see 
http://day-to-day-stuff.blogspot.com/2011/08/version-99-dns-off-line.html).


Reposted here:
http://www.grons.nl/concrete-bindings-eoo.odg
http://www.grons.nl/concrete-bindings-eoo.png

BTW, I don't care so much for arrows or not. Its just that they are 
usually not used in this software stacks.


Kind regards,
Erik.


Op 15-08-11 10:15, Erik van Oosten schreef:

Hello Ceki,

I've added some color and removed the adaption layer from the 
'unbound' case. What do you think?


http://no-commons-logging.zapto.org/concrete-bindings-eoo.odg
http://no-commons-logging.zapto.org/concrete-bindings-eoo.png

I think that displaying these stacks horizontally would improve the 
presentation somewhat more. It emphasizes what a mess you have when 
you include commons-logging in the mix :)


Regards,
 Erik.


Op 14-08-11 22:56, Ceki Gülcü schreef:

Hi all,

I've updated the illustrations taking into account your comments. The
updated files are located at:

  http://slf4j.org/images/concrete-bindings.odg
  http://slf4j.org/images/concrete-bindings.png

  http://slf4j.org/images/legacy.odg
  http://slf4j.org/images/legacy.png


The audience for these illustrations are users with little or no prior
understanding of or exposure to SLF4J. More concretely, with the help
of these illustrations, new users should hopefully stop placing
multiple binding artifacts on the class path at the same time.

IMO, the arrows convey useful information with respect to direction of
invocations albeit perhaps in a stylistically inelegant way.

Anyway, your suggestions for further improvements most welcome. In
particular regarding the unification of the stacked and arrowed styles
(if possible).

Cheers,


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user



--
Erik van Oosten
http://www.day-to-day-stuff.blogspot.com/

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user

Re: [slf4j-user] SLF4J library using an image

2011-08-15 Thread Erik van Oosten

Hello Ceki,

I've added some color and removed the adaption layer from the 'unbound' 
case. What do you think?


http://no-commons-logging.zapto.org/concrete-bindings-eoo.odg
http://no-commons-logging.zapto.org/concrete-bindings-eoo.png

I think that displaying these stacks horizontally would improve the 
presentation somewhat more. It emphasizes what a mess you have when you 
include commons-logging in the mix :)


Regards,
 Erik.


Op 14-08-11 22:56, Ceki Gülcü schreef:

Hi all,

I've updated the illustrations taking into account your comments. The
updated files are located at:

  http://slf4j.org/images/concrete-bindings.odg
  http://slf4j.org/images/concrete-bindings.png

  http://slf4j.org/images/legacy.odg
  http://slf4j.org/images/legacy.png


The audience for these illustrations are users with little or no prior
understanding of or exposure to SLF4J. More concretely, with the help
of these illustrations, new users should hopefully stop placing
multiple binding artifacts on the class path at the same time.

IMO, the arrows convey useful information with respect to direction of
invocations albeit perhaps in a stylistically inelegant way.

Anyway, your suggestions for further improvements most welcome. In
particular regarding the unification of the stacked and arrowed styles
(if possible).

Cheers,


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-14 Thread Thorsten Möller

Am 14.08.2011 um 22:56 schrieb Ceki Gülcü:

> Hi all,
> 
> I've updated the illustrations taking into account your comments.
With the additional description of the arrows in the legend it looks good to 
me. One more thing which just came to my mind: I would prefer "Adaptation 
layer" and "Underlying logging framework" boxes in another (slightly different) 
color in order to visually distinguish the three different layers: API, 
Adaptation, Underlying logging framework. You could even adjust the different 
variants in concrete-bindings.png to have all the same vertical hight so that 
it is visually stressed that for some there is no adaptation layer while for 
others there is no underlying logging framework layer.

Thorsten









> The
> updated files are located at:
> 
>  http://slf4j.org/images/concrete-bindings.odg
>  http://slf4j.org/images/concrete-bindings.png
> 
>  http://slf4j.org/images/legacy.odg
>  http://slf4j.org/images/legacy.png
> 
> 
> The audience for these illustrations are users with little or no prior
> understanding of or exposure to SLF4J. More concretely, with the help
> of these illustrations, new users should hopefully stop placing
> multiple binding artifacts on the class path at the same time.
> 
> IMO, the arrows convey useful information with respect to direction of
> invocations albeit perhaps in a stylistically inelegant way.
> 
> Anyway, your suggestions for further improvements most welcome. In
> particular regarding the unification of the stacked and arrowed styles
> (if possible).
> 
> Cheers,
> -- 
> QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is 
> looking to hire talented software developers. For further details, see 
> http://logback.qos.ch/job.html
> ___
> slf4j-user mailing list
> slf4j-user@qos.ch
> http://qos.ch/mailman/listinfo/slf4j-user

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-14 Thread Rusty Wright

Looks good.  I like the arrows.

To reiterate my question about writing a library, in my maven pom.xml 
for my library, I should only declare a compile/runtime dependency on 
slf4j-api.jar (that is, no scope, just  the groupId, artifactId, and 
version for slf4j-api), and in my docs explain that if their application 
is using commons logging that they should also add slf4j-jcl.jar to 
their classpath/dependencies, or if they're logging directly with log4j 
then they should add slf4j-log412.jar to their classpath/dependencies, 
or if they're logging directly with java.util.logging then they should 
add slf4j-jdk14.jar to their classpath/dependencies?



On 2011-08-14 13:56, Ceki Gülcü wrote:

Hi all,

I've updated the illustrations taking into account your comments. The
updated files are located at:

  http://slf4j.org/images/concrete-bindings.odg
  http://slf4j.org/images/concrete-bindings.png

  http://slf4j.org/images/legacy.odg
  http://slf4j.org/images/legacy.png


The audience for these illustrations are users with little or no prior
understanding of or exposure to SLF4J. More concretely, with the help
of these illustrations, new users should hopefully stop placing
multiple binding artifacts on the class path at the same time.

IMO, the arrows convey useful information with respect to direction of
invocations albeit perhaps in a stylistically inelegant way.

Anyway, your suggestions for further improvements most welcome. In
particular regarding the unification of the stacked and arrowed styles
(if possible).

Cheers,

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-14 Thread Ceki Gülcü

Hi all,

I've updated the illustrations taking into account your comments. The
updated files are located at:

  http://slf4j.org/images/concrete-bindings.odg
  http://slf4j.org/images/concrete-bindings.png

  http://slf4j.org/images/legacy.odg
  http://slf4j.org/images/legacy.png


The audience for these illustrations are users with little or no prior
understanding of or exposure to SLF4J. More concretely, with the help
of these illustrations, new users should hopefully stop placing
multiple binding artifacts on the class path at the same time.

IMO, the arrows convey useful information with respect to direction of
invocations albeit perhaps in a stylistically inelegant way.

Anyway, your suggestions for further improvements most welcome. In
particular regarding the unification of the stacked and arrowed styles
(if possible).

Cheers,
--
QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, 
is looking to hire talented software developers. For further details, 
see http://logback.qos.ch/job.html

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-14 Thread Thorsten Möller

Am 14.08.2011 um 17:33 schrieb Erik van Oosten:

> Small correction: the 'original' version is David's (jakartaman).

uups, sorry ;-)

Thorsten


> 
> For the rest I agree.
> 
> Regards,
>Erik.
> 
> 
> Op 14-08-11 13:35, Thorsten Möller schreef:
>> Am 13.08.2011 um 22:17 schrieb jakartaman:
>> 
>>> Now someone needs to take a decision!!11!!
>> Well, just my opinion: both make sense to me. Erik's original version 
>> clearly and tersely describes the (gradual) transition from a logging 
>> framework other than SLF4J up to the point where just SLF4J backed by 
>> Logback is used. And I presume depicting this transition was Erik's 
>> intention.
>> 
>> Ceki's version appeared more comprehensive to me in depicting all the 
>> combinations in which SLF4J can be deployed. Honestly, however, I was 
>> interrupted a bit by the arrows since their semantics is not intuitive and 
>> was also not explained in the legend. To me they are not really necessary 
>> and I would prefer the typical layered way of depicting it using vertically 
>> stacked boxes.
>> 
>> To conclude, both are reasonable to the projects documentation, just at 
>> different places: Erik's could be used for supporting one way (the preferred 
>> way?) of (gradually) moving from another logging framework to "pure" SLF4J 
>> logging; Ceki's could be used to support all the different deployment 
>> combinations.
>> 
>> Thorsten
>> 
>> 
>> 
>> 
>>> :-)
>>> 
>>> On 08/13/2011 10:51 AM, Rusty Wright wrote:
 I definitely like http://slf4j.org/images/concrete-bindings.png
 
 Straightforward and clear.
 
 On 2011-08-12 12:32, Ceki Gülcü wrote:
> I've taken yet another crack at this:
> 
> http://slf4j.org/images/concrete-bindings.odg
> http://slf4j.org/images/concrete-bindings.png
> 
> http://slf4j.org/images/legacy.odg
> http://slf4j.org/images/legacy.png
> 
> The idea is to illustrate concrete binding setups using lots of arrows. 
> :-)
> 
> On 12/08/2011 9:04 AM, Erik van Oosten wrote:
>> Hi David,
>> 
>> I liked the clearness of your images as the result of using no arrows
>> and different colors for each function. I did have troubles with the
>> text, the font size is a tad small for me.
>> 
>> The second image does not show that commons-logging attempts to find a
>> logging implementation such as log4j, nor that is specially wired in the
>> classpath of many servlet containers. Not sure how to do visualize that
>> though.
>> 
>> Regards,
>> Erik.
> 
 ___
 slf4j-user mailing list
 slf4j-user@qos.ch
 http://qos.ch/mailman/listinfo/slf4j-user
>>> ___
>>> slf4j-user mailing list
>>> slf4j-user@qos.ch
>>> http://qos.ch/mailman/listinfo/slf4j-user
>> ___
>> slf4j-user mailing list
>> slf4j-user@qos.ch
>> http://qos.ch/mailman/listinfo/slf4j-user
> 
> 
> -- 
> Erik van Oosten
> http://www.day-to-day-stuff.blogspot.com/
> 
> ___
> slf4j-user mailing list
> slf4j-user@qos.ch
> http://qos.ch/mailman/listinfo/slf4j-user

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-14 Thread Erik van Oosten

Small correction: the 'original' version is David's (jakartaman).

For the rest I agree.

Regards,
Erik.


Op 14-08-11 13:35, Thorsten Möller schreef:

Am 13.08.2011 um 22:17 schrieb jakartaman:


Now someone needs to take a decision!!11!!

Well, just my opinion: both make sense to me. Erik's original version clearly 
and tersely describes the (gradual) transition from a logging framework other 
than SLF4J up to the point where just SLF4J backed by Logback is used. And I 
presume depicting this transition was Erik's intention.

Ceki's version appeared more comprehensive to me in depicting all the 
combinations in which SLF4J can be deployed. Honestly, however, I was 
interrupted a bit by the arrows since their semantics is not intuitive and was 
also not explained in the legend. To me they are not really necessary and I 
would prefer the typical layered way of depicting it using vertically stacked 
boxes.

To conclude, both are reasonable to the projects documentation, just at different places: 
Erik's could be used for supporting one way (the preferred way?) of (gradually) moving 
from another logging framework to "pure" SLF4J logging; Ceki's could be used to 
support all the different deployment combinations.

Thorsten





:-)

On 08/13/2011 10:51 AM, Rusty Wright wrote:

I definitely like http://slf4j.org/images/concrete-bindings.png

Straightforward and clear.

On 2011-08-12 12:32, Ceki Gülcü wrote:

I've taken yet another crack at this:

http://slf4j.org/images/concrete-bindings.odg
http://slf4j.org/images/concrete-bindings.png

http://slf4j.org/images/legacy.odg
http://slf4j.org/images/legacy.png

The idea is to illustrate concrete binding setups using lots of arrows. :-)

On 12/08/2011 9:04 AM, Erik van Oosten wrote:

Hi David,

I liked the clearness of your images as the result of using no arrows
and different colors for each function. I did have troubles with the
text, the font size is a tad small for me.

The second image does not show that commons-logging attempts to find a
logging implementation such as log4j, nor that is specially wired in the
classpath of many servlet containers. Not sure how to do visualize that
though.

Regards,
Erik.



___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user



--
Erik van Oosten
http://www.day-to-day-stuff.blogspot.com/

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user

Re: [slf4j-user] SLF4J library using an image

2011-08-14 Thread Thorsten Möller

Am 13.08.2011 um 22:17 schrieb jakartaman:

> Now someone needs to take a decision!!11!!

Well, just my opinion: both make sense to me. Erik's original version clearly 
and tersely describes the (gradual) transition from a logging framework other 
than SLF4J up to the point where just SLF4J backed by Logback is used. And I 
presume depicting this transition was Erik's intention.

Ceki's version appeared more comprehensive to me in depicting all the 
combinations in which SLF4J can be deployed. Honestly, however, I was 
interrupted a bit by the arrows since their semantics is not intuitive and was 
also not explained in the legend. To me they are not really necessary and I 
would prefer the typical layered way of depicting it using vertically stacked 
boxes.

To conclude, both are reasonable to the projects documentation, just at 
different places: Erik's could be used for supporting one way (the preferred 
way?) of (gradually) moving from another logging framework to "pure" SLF4J 
logging; Ceki's could be used to support all the different deployment 
combinations.

Thorsten




> 
> :-)
> 
> On 08/13/2011 10:51 AM, Rusty Wright wrote:
>> I definitely like http://slf4j.org/images/concrete-bindings.png
>> 
>> Straightforward and clear.
>> 
>> On 2011-08-12 12:32, Ceki Gülcü wrote:
>>> I've taken yet another crack at this:
>>> 
>>> http://slf4j.org/images/concrete-bindings.odg
>>> http://slf4j.org/images/concrete-bindings.png
>>> 
>>> http://slf4j.org/images/legacy.odg
>>> http://slf4j.org/images/legacy.png
>>> 
>>> The idea is to illustrate concrete binding setups using lots of arrows. :-)
>>> 
>>> On 12/08/2011 9:04 AM, Erik van Oosten wrote:
 Hi David,
 
 I liked the clearness of your images as the result of using no arrows
 and different colors for each function. I did have troubles with the
 text, the font size is a tad small for me.
 
 The second image does not show that commons-logging attempts to find a
 logging implementation such as log4j, nor that is specially wired in the
 classpath of many servlet containers. Not sure how to do visualize that
 though.
 
 Regards,
 Erik.
>>> 
>>> 
>> ___
>> slf4j-user mailing list
>> slf4j-user@qos.ch
>> http://qos.ch/mailman/listinfo/slf4j-user
> 
> ___
> slf4j-user mailing list
> slf4j-user@qos.ch
> http://qos.ch/mailman/listinfo/slf4j-user

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-13 Thread jakartaman

Now someone needs to take a decision!!11!!

:-)

On 08/13/2011 10:51 AM, Rusty Wright wrote:

I definitely like http://slf4j.org/images/concrete-bindings.png

Straightforward and clear.

On 2011-08-12 12:32, Ceki Gülcü wrote:

I've taken yet another crack at this:

http://slf4j.org/images/concrete-bindings.odg
http://slf4j.org/images/concrete-bindings.png

http://slf4j.org/images/legacy.odg
http://slf4j.org/images/legacy.png

The idea is to illustrate concrete binding setups using lots of 
arrows. :-)


On 12/08/2011 9:04 AM, Erik van Oosten wrote:

Hi David,

I liked the clearness of your images as the result of using no arrows
and different colors for each function. I did have troubles with the
text, the font size is a tad small for me.

The second image does not show that commons-logging attempts to find a
logging implementation such as log4j, nor that is specially wired in 
the

classpath of many servlet containers. Not sure how to do visualize that
though.

Regards,
Erik.




___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-13 Thread Rusty Wright

I definitely like http://slf4j.org/images/concrete-bindings.png

Straightforward and clear.

On 2011-08-12 12:32, Ceki Gülcü wrote:

I've taken yet another crack at this:

http://slf4j.org/images/concrete-bindings.odg
http://slf4j.org/images/concrete-bindings.png

http://slf4j.org/images/legacy.odg
http://slf4j.org/images/legacy.png

The idea is to illustrate concrete binding setups using lots of 
arrows. :-)


On 12/08/2011 9:04 AM, Erik van Oosten wrote:

Hi David,

I liked the clearness of your images as the result of using no arrows
and different colors for each function. I did have troubles with the
text, the font size is a tad small for me.

The second image does not show that commons-logging attempts to find a
logging implementation such as log4j, nor that is specially wired in the
classpath of many servlet containers. Not sure how to do visualize that
though.

Regards,
Erik.




___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-13 Thread Rusty Wright
Ok, thanks.  I'm working on a library in my spare time and hadn't 
thought about this before and this diagram made me think about it.



On 2011-08-11 16:27, Ceki Gülcü wrote:


Hi Rusty,

Letting the end user choose the underlying logging framework is the 
reason SLF4J exists in the first place. If you specify the actual 
binding in the pom file of your library, users can no longer choose 
the logging library which negates SLF4J's purpose.


The instructions on dependencies should be part of the SLF4J docs so 
that authors of libraries can reference them. Such instructions are 
currently missing. Perhaps that was the point of your post...


Cheers,

On 12/08/2011 1:14 AM, Rusty Wright wrote:

Suppose I'm developing a library that will be used in another person's
project and my library uses slf4j. And I don't know what logging
framework they use. Should my distribution include slf4j-log412.jar and
slf4j-jdk14.jar (or, better, specify both of them as a dependency in my
maven pom.xml)? Or should I include instructions that they'll need to
download and use either of those jars, depending on which logging
framework they're using?

Here's what's in my pom.xml at the moment (for logging); the test scope
is what keeps the underlying logging framework I'm using (logback) from
being a runtime/compile dependency:



org.slf4j
slf4j-api

${version.slf4j}



commons-logging
commons-logging





1.1.1

provided



commons-logging
commons-logging-api





1.1

provided






org.slf4j
jcl-over-slf4j

${version.slf4j}

test






org.slf4j
log4j-over-slf4j

${version.slf4j}

test






org.slf4j
jul-to-slf4j

${version.slf4j}

test



ch.qos.logback
logback-classic

${version.logback}

test



On 2011-08-11 13:36, Ceki Gülcü wrote:

Hi again,

Here is another more comprehensive attempt. It's hard for me to say
how much of an improvement these are.

Comments welcome.
--
Ceki






___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-12 Thread Ceki Gülcü

I've taken yet another crack at this:

http://slf4j.org/images/concrete-bindings.odg
http://slf4j.org/images/concrete-bindings.png

http://slf4j.org/images/legacy.odg
http://slf4j.org/images/legacy.png

The idea is to illustrate concrete binding setups using lots of arrows. :-)

On 12/08/2011 9:04 AM, Erik van Oosten wrote:

Hi David,

I liked the clearness of your images as the result of using no arrows
and different colors for each function. I did have troubles with the
text, the font size is a tad small for me.

The second image does not show that commons-logging attempts to find a
logging implementation such as log4j, nor that is specially wired in the
classpath of many servlet containers. Not sure how to do visualize that
though.

Regards,
Erik.



--
QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, 
is looking to hire talented software developers. For further details, 
see http://logback.qos.ch/job.html

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-12 Thread Erik van Oosten

Hi David,

I liked the clearness of your images as the result of using no arrows 
and different colors for each function. I did have troubles with the 
text, the font size is a tad small for me.


The second image does not show that commons-logging attempts to find a 
logging implementation such as log4j, nor that is specially wired in the 
classpath of many servlet containers. Not sure how to do visualize that 
though.


Regards,
Erik.



Op 11-08-11 00:10, jakartaman wrote:

Hi Ceki,

Here is the new version:

http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.odg
http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.png
http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.tif

Best regards,

-- David

On 08/10/2011 04:22 PM, Ceki Gülcü wrote:

On 10/08/2011 4:10 PM, jakartaman wrote:

Hi guys,

I have finagled a little image to explain the SLF4J library in 10 
seconds.


Maybe someone wants to recycle it for the the SLF4J documentation page
(I don't doubt there are other images though).

Have a look:

http://public.m-plify.net/SLF4J_intro.png <-- An 1,500px × 523px PNG
http://public.m-plify.net/SLF4J_intro.vsd <-- The Microsoft Visio file
used to generate the above


Best regards,

-- David


Hi David,

I very much like the idea of a graphic better explaining SLF4J. 
Instead of an abstract logging API such as "X" logging API, I think 
it would be clearer to present concrete cases as log4j, jul or logback.


Would you want to work on this using an open source tool such as Open 
Office Draw? (I don't own a copy of Visio).


--
Ceki
___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-11 Thread Ceki Gülcü


Hi Rusty,

Letting the end user choose the underlying logging framework is the 
reason SLF4J exists in the first place. If you specify the actual 
binding in the pom file of your library, users can no longer choose the 
logging library which negates SLF4J's purpose.


The instructions on dependencies should be part of the SLF4J docs so 
that authors of libraries can reference them. Such instructions are 
currently missing. Perhaps that was the point of your post...


Cheers,

On 12/08/2011 1:14 AM, Rusty Wright wrote:

Suppose I'm developing a library that will be used in another person's
project and my library uses slf4j. And I don't know what logging
framework they use. Should my distribution include slf4j-log412.jar and
slf4j-jdk14.jar (or, better, specify both of them as a dependency in my
maven pom.xml)? Or should I include instructions that they'll need to
download and use either of those jars, depending on which logging
framework they're using?

Here's what's in my pom.xml at the moment (for logging); the test scope
is what keeps the underlying logging framework I'm using (logback) from
being a runtime/compile dependency:



org.slf4j
slf4j-api

${version.slf4j}



commons-logging
commons-logging





1.1.1

provided



commons-logging
commons-logging-api





1.1

provided






org.slf4j
jcl-over-slf4j

${version.slf4j}

test






org.slf4j
log4j-over-slf4j

${version.slf4j}

test






org.slf4j
jul-to-slf4j

${version.slf4j}

test



ch.qos.logback
logback-classic

${version.logback}

test



On 2011-08-11 13:36, Ceki Gülcü wrote:

Hi again,

Here is another more comprehensive attempt. It's hard for me to say
how much of an improvement these are.

Comments welcome.
--
Ceki





--
QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, 
is looking to hire talented software developers. For further details, 
see http://logback.qos.ch/job.html

___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-11 Thread Rusty Wright
Suppose I'm developing a library that will be used in another person's 
project and my library uses slf4j.  And I don't know what logging 
framework they use.  Should my distribution include slf4j-log412.jar and 
slf4j-jdk14.jar (or, better, specify both of them as a dependency in my 
maven pom.xml)?  Or should I include instructions that they'll need to 
download and use either of those jars, depending on which logging 
framework they're using?


Here's what's in my pom.xml at the moment (for logging); the test scope 
is what keeps the underlying logging framework I'm using (logback) from 
being a runtime/compile dependency:




org.slf4j
slf4j-api

${version.slf4j}



commons-logging
commons-logging





1.1.1

provided



commons-logging
commons-logging-api





1.1

provided






org.slf4j
jcl-over-slf4j

${version.slf4j}

test






org.slf4j
log4j-over-slf4j

${version.slf4j}

test






org.slf4j
jul-to-slf4j

${version.slf4j}

test



ch.qos.logback
logback-classic

${version.logback}

test



On 2011-08-11 13:36, Ceki Gülcü wrote:

Hi again,

Here is another more comprehensive attempt. It's hard for me to say 
how much of an improvement these are.


Comments welcome.
--
Ceki


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user
___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user

Re: [slf4j-user] SLF4J library using an image

2011-08-10 Thread jakartaman

Hi Ceki,

Here is the new version:

http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.odg
http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.png
http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.tif

Best regards,

-- David

On 08/10/2011 04:22 PM, Ceki Gülcü wrote:

On 10/08/2011 4:10 PM, jakartaman wrote:

Hi guys,

I have finagled a little image to explain the SLF4J library in 10 
seconds.


Maybe someone wants to recycle it for the the SLF4J documentation page
(I don't doubt there are other images though).

Have a look:

http://public.m-plify.net/SLF4J_intro.png <-- An 1,500px × 523px PNG
http://public.m-plify.net/SLF4J_intro.vsd <-- The Microsoft Visio file
used to generate the above


Best regards,

-- David


Hi David,

I very much like the idea of a graphic better explaining SLF4J. 
Instead of an abstract logging API such as "X" logging API, I think it 
would be clearer to present concrete cases as log4j, jul or logback.


Would you want to work on this using an open source tool such as Open 
Office Draw? (I don't own a copy of Visio).


--
Ceki
___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-10 Thread jakartaman

Yup, no problem, I will give it a try later today.



Hi David,

I very much like the idea of a graphic better explaining SLF4J. 
Instead of an abstract logging API such as "X" logging API, I think it 
would be clearer to present concrete cases as log4j, jul or logback.


Would you want to work on this using an open source tool such as Open 
Office Draw? (I don't own a copy of Visio).


--
Ceki
___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user


Re: [slf4j-user] SLF4J library using an image

2011-08-10 Thread Ceki Gülcü

On 10/08/2011 4:10 PM, jakartaman wrote:

Hi guys,

I have finagled a little image to explain the SLF4J library in 10 seconds.

Maybe someone wants to recycle it for the the SLF4J documentation page
(I don't doubt there are other images though).

Have a look:

http://public.m-plify.net/SLF4J_intro.png <-- An 1,500px × 523px PNG
http://public.m-plify.net/SLF4J_intro.vsd <-- The Microsoft Visio file
used to generate the above


Best regards,

-- David


Hi David,

I very much like the idea of a graphic better explaining SLF4J. Instead 
of an abstract logging API such as "X" logging API, I think it would be 
clearer to present concrete cases as log4j, jul or logback.


Would you want to work on this using an open source tool such as Open 
Office Draw? (I don't own a copy of Visio).


--
Ceki
___
slf4j-user mailing list
slf4j-user@qos.ch
http://qos.ch/mailman/listinfo/slf4j-user